01 / RELEASE
推荐：下载稳定发行包
从 GitHub Release 下载已经验证的完整压缩包，并使用 SHA-256 文件核对完整性。
math-modeling-skill-v1.2.0.zip SHA-256: d54535ca52f0025c295966d70ee06d86be288d34cf161e2ddf92d90cbf9c7c58
02 / GIT
需要跟踪更新时使用 Git
git clone https://github.com/XiaoMaColtAI/math-modeling-skill.git cd math-modeling-skill git checkout v1.2.0
03 / PATHS
Skill 与项目产物分开
| 路径 | 用途 | 权限 |
|---|---|---|
SKILL_ROOT | Skill 规则、工具、算法和模板 | 只读 |
PROJECT_ROOT | 题目、数据、代码、结果与论文 | 任务产物只写这里 |
~/.agents/skills/math-modeling-skill | Codex 等 Agent 的技能目录 | 复制完整发行包 |
~/.claude/skills/math-modeling-skill | Claude Code 的技能目录 | 复制完整发行包 |
将整个目录复制到你的 Agent Skill 搜索路径；不要把比赛项目创建在 Skill 目录内部。
04 / TOOLCHAIN
只安装实际使用的工具链
基础建模
按模型选择 Python 包或 MATLAB 工具箱；Excel、PDF 与绘图能力均由脚本动态检查。
双格式论文
Word 分支需要 Python DOCX 依赖；LaTeX/PDF 分支需要 TeX 发行版。LaTeX 转 DOCX 时再安装 Pandoc。
默认生成
完整论文.docx、完整论文-LaTeX/ 与 完整论文.pdf；缺失工具时必须明确报告，不能静默跳过。05 / VERIFY
按任务动态检查环境
python references/roles/编程手/scripts/check_env.py --features excel visualization python tools/docx/scripts/self_check.py python tools/latex/scripts/latex_paper.py doctor
MATLAB 任务使用角色目录中的 check_matlab_env.m 检查所需工具箱。未选中的能力不会强制检查；正式交付前仍要运行所选分支的完整验证命令。