尧图网站建设 
如何为MathModelAgent贡献代码从Typst模板到SKILL工作流的完整指南【免费下载链接】MathModelAgent专为数学建模设计的 Agent skills ,自动完成数学建模生成一份完整的可以直接提交的论文。 An Agent Designed for Mathematical Modeling ,Automatically complete mathmodel and generate a complete paper ready for submission.项目地址: https://gitcode.com/GitHub_Trending/ma/MathModelAgentMathModelAgent 是一个专为数学建模设计的开源 Agent 项目能自动完成赛题分析、数学建模、编码求解和论文撰写最终生成一份可直接提交的排版论文。本文是一份面向新手的贡献指南带你从 Typst 论文模板到 SKILL 工作流看懂这个数学建模 Agent 的内部结构并找到最适合你的贡献切入点。一、MathModelAgent 是什么多 Agent 协作的数学建模系统MathModelAgent 的核心思路是多 Agent 分工由 coordinator_agent.py 负责任务分解modeler_agent.py 负责建模coder_agent.py 负责代码生成与执行writer_agent.py 负责论文撰写。整个编排逻辑见 flows.py 与 workflow.py。更值得注意的是项目已经蒸馏为完全由 SKILLS 驱动的形式不再依赖自研 Harness而是把整套建模流程沉淀为一组可复用的 SKILL可以直接在 Claude Code / Codex 等 Harness 中用一条/1start-mathmodel命令跑完全流程。这也意味着——项目未来的迭代重心就在 SKILLS 层而这正是贡献者可以大显身手的地方。二、先看贡献方向项目官方欢迎做什么项目作者明确说明了当前接受贡献的三类方向见 README.md 的 What Can You Contribute? 小节贡献类型难度说明 优化比赛 Typst 模板⭐将开源 LaTeX 竞赛模板转换为 Typst或美化现有模板 优化 SKILL 工作流⭐⭐对 6 个阶段 skill 做黑盒测试、调优改进 prompt 与流程边界 多 Harness / 多 LLM 测试⭐⭐在不同模型上测试把反馈和跑通案例提交到示例仓库对新手来说Typst 模板是最友好的入口不需要理解 Agent 框架只要会排版、会对照 LaTeX 写 Typst 即可。三、快速上手克隆仓库并跑起本地环境克隆项目git clone https://gitcode.com/GitHub_Trending/ma/MathModelAgent推荐部署方式Docker最简单在项目根目录执行docker-compose up随后访问 http://localhost:5173 前端与 http://localhost:8000 后端 API通过侧边栏 → 头像 → API Key 配置模型密钥即可。完整步骤见 docker-compose.yml 与 docs/md/tutorial.md。开发者本地部署后端依赖用uv sync安装Python 3.12前端用pnpm i详见 backend/pyproject.toml 与 frontend/package.json启动命令与目录结构都写在 CLAUDE.md 里照着执行即可。小提示装好 SKILL 后可以先跑/doctor命令做环境体检它会检查typst、xelatex、python3、绘图与 PDF 工具链等依赖并给出安装命令定义在 skills/doctor/SKILL.md。四、SKILL 工作流全景从入口到验收的 6 个阶段整个 SKILL 工作流是一条流水线入口 skill 负责询问用户偏好排版引擎、竞赛类型、语言、子问题数量生成plan.md和todo.md再依次调度下游阶段阶段Skill主要产物1. 工作流入口1start-mathmodelplan.md、todo.md2. 赛题分析与建模2analysis-modelingreports/ANALYSIS_MODELING_REPORT.md3. 编程实现与图表3coding-visualcode/、results/、figures/4. 流程图/架构图4drawiofigures/*.drawio PDF5. 论文撰写5writingpaper/Typst 或 LaTeX6. 验证验收6verityreports/VERIFY_REPORT.md除了 6 个流程 skill还有 3 类支撑组件typst-author内置完整 Typst 语法参考文档skills/typst-author/SKILL.md写作阶段可调用它学习 Typst 写法mathmodel-figure-templates11 套科研图表复刻模板SHAP 蜂群图、泰勒图、云雨图、和弦图等见 skills/mathmodel-figure-templates/SKILL.md_references 知识库math_modeling_norms.md 包含模型选型决策树、题型防错速查、论文写作规范各阶段按需读取用于降低模型幻觉。每个 skill 本质上就是一个目录 一份带 frontmatter 的SKILL.md声明name、description、allowed-tools工作流之间通过阶段边界严格解耦例如3coding-visual只产数据图4drawio只画概念图5writing决定图表放哪个章节且不得编造数值。这套入口 skill 编排 阶段 skill 独立可调用的架构让每个 SKILL.md 都能被单独优化和测试——这正是工作流类贡献者的主战场。五、Typst 模板贡献指南17 套赛事模板长什么样模板全部位于 skills/5writing/templates/ 下采用语言 / 竞赛 / 双引擎的组织方式templates/ ├── zh/ # 14 套中文模板Typst │ ├── cumcm/ # 国赛main.typ sections/*.typ │ ├── cumcm-latex/ # 国赛main.tex sections/*.tex │ ├── huaweibei/ ... │ └── ... └── en/ # 3 套英文模板apmcm / default / mcm以国赛模板为例Typst 版入口 skills/5writing/templates/zh/cumcm/main.typ 通过#include按数字前缀引入各章节文件1_restatement.typ问题重述 →8_sensitivity.typ灵敏度 →9_evaluation.typ评价 →A_code.typ附录LaTeX 版 skills/5writing/templates/zh/cumcm-latex/main.tex 则用\input{}一一对应。贡献一个新竞赛模板的建议步骤找到该竞赛的开源 LaTeX 模板作为参考README 感谢名单里有模板来源在templates/zh/竞赛/下创建main.typsections/章节命名沿用数字前缀约定保证#include顺序正确同步提供竞赛-latex/双引擎版本xelatex 编译需跑两遍解决交叉引用更新 skills/5writing/SKILL.md 中的模板族清单和模板键映射否则 5writing 无法自动匹配用typst compile main.typ本地验证可编译封面、摘要、页眉页脚等比赛要求的格式要完整保留。排版语法拿不准时直接翻阅 skills/typst-author/docs/ 里的教程与参考文档页面设置、表格、样式规则等都有覆盖它就是为 Agent 和人类准备的 Typst 速查手册。六、SKILL 工作流优化黑盒测试是主要方法论作者坦言Harness 上 SKILL 的优化需要大量黑盒测试和调优。具体可以这么做端到端跑真题仓库内置了三套经典赛题2023华数杯C题、2024高教杯C题、2025五一杯C题执行/1start-mathmodel 完成这个数学建模任务观察plan.md、todo.md和paper/的实际产出盯住验收报告6verity/SKILL.md 定义了 9 步验收文本泄漏检测 → 章节结构 → 图表引用 → 数值一致性 → 编译 → PDF 逐页视觉检查 → 验收报告任何FAIL都是工作流的真实 bug 线索修边界而非加功能SKILL.md 中的阶段边界硬错误标准就是流程契约优化时优先修边界模糊导致的重复劳动或产物遗漏而不是随意增加流程步骤。如果你跑出了漂亮的完整案例项目还单独维护了一个示例仓库用于收集优秀结果欢迎提交 PR。七、提交贡献前Git 规范与代码风格贡献代码前请对照 CLAUDE.md 中的约定能显著提高合并效率提交信息格式type: 描述type 取feat/fix/refactor/chore/enhance/docs例如feat: 添加华中杯 Typst 模板后端PythonGoogle 风格 docstring、str | None风格类型注解、全程 async/await提交前跑ruff check与ruff format配置见 backend/pyrightconfig.json前端Vue 3 TypeScriptscript setup langts、tab 缩进、Biome 管理 lint注意 frontend/src/components/ui/ 是 shadcn-vue 生成代码不要修改SKILL 改动保持 frontmatter 字段完整改动工作流时同步更新plan.md约定的阶段表和 skills/skills.sh.json 中的 skill 清单。写在最后MathModelAgent 的未来只有两个字SKILLS。无论你会 Typst 排版、会写 prompt、还是喜欢在不同模型上做黑盒实验这里都有对应的贡献位置。从 CLAUDE.md 开始读起跑一次/doctor环境检查然后挑一个国赛之外的竞赛模板动手吧——你的第一个 PR可能就从一套新的 Typst 论文模板开始。【免费下载链接】MathModelAgent专为数学建模设计的 Agent skills ,自动完成数学建模生成一份完整的可以直接提交的论文。 An Agent Designed for Mathematical Modeling ,Automatically complete mathmodel and generate a complete paper ready for submission.项目地址: https://gitcode.com/GitHub_Trending/ma/MathModelAgent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何为MathModelAgent贡献代码？从Typst模板到SKILL工作流的完整指南
如何为MathModelAgent贡献代码从Typst模板到SKILL工作流的完整指南【免费下载链接】MathModelAgent专为数学建模设计的 Agent skills ,自动完成数学建模生成一份完整的可以直接提交的论文。 An Agent Designed for Mathematical Modeling ,Automatically complete mathmodel and generate a complete paper ready for submission.项目地址: https://gitcode.com/GitHub_Trending/ma/MathModelAgentMathModelAgent 是一个专为数学建模设计的开源 Agent 项目能自动完成赛题分析、数学建模、编码求解和论文撰写最终生成一份可直接提交的排版论文。本文是一份面向新手的贡献指南带你从 Typst 论文模板到 SKILL 工作流看懂这个数学建模 Agent 的内部结构并找到最适合你的贡献切入点。一、MathModelAgent 是什么多 Agent 协作的数学建模系统MathModelAgent 的核心思路是多 Agent 分工由 coordinator_agent.py 负责任务分解modeler_agent.py 负责建模coder_agent.py 负责代码生成与执行writer_agent.py 负责论文撰写。整个编排逻辑见 flows.py 与 workflow.py。更值得注意的是项目已经蒸馏为完全由 SKILLS 驱动的形式不再依赖自研 Harness而是把整套建模流程沉淀为一组可复用的 SKILL可以直接在 Claude Code / Codex 等 Harness 中用一条/1start-mathmodel命令跑完全流程。这也意味着——项目未来的迭代重心就在 SKILLS 层而这正是贡献者可以大显身手的地方。二、先看贡献方向项目官方欢迎做什么项目作者明确说明了当前接受贡献的三类方向见 README.md 的 What Can You Contribute? 小节贡献类型难度说明 优化比赛 Typst 模板⭐将开源 LaTeX 竞赛模板转换为 Typst或美化现有模板 优化 SKILL 工作流⭐⭐对 6 个阶段 skill 做黑盒测试、调优改进 prompt 与流程边界 多 Harness / 多 LLM 测试⭐⭐在不同模型上测试把反馈和跑通案例提交到示例仓库对新手来说Typst 模板是最友好的入口不需要理解 Agent 框架只要会排版、会对照 LaTeX 写 Typst 即可。三、快速上手克隆仓库并跑起本地环境克隆项目git clone https://gitcode.com/GitHub_Trending/ma/MathModelAgent推荐部署方式Docker最简单在项目根目录执行docker-compose up随后访问 http://localhost:5173 前端与 http://localhost:8000 后端 API通过侧边栏 → 头像 → API Key 配置模型密钥即可。完整步骤见 docker-compose.yml 与 docs/md/tutorial.md。开发者本地部署后端依赖用uv sync安装Python 3.12前端用pnpm i详见 backend/pyproject.toml 与 frontend/package.json启动命令与目录结构都写在 CLAUDE.md 里照着执行即可。小提示装好 SKILL 后可以先跑/doctor命令做环境体检它会检查typst、xelatex、python3、绘图与 PDF 工具链等依赖并给出安装命令定义在 skills/doctor/SKILL.md。四、SKILL 工作流全景从入口到验收的 6 个阶段整个 SKILL 工作流是一条流水线入口 skill 负责询问用户偏好排版引擎、竞赛类型、语言、子问题数量生成plan.md和todo.md再依次调度下游阶段阶段Skill主要产物1. 工作流入口1start-mathmodelplan.md、todo.md2. 赛题分析与建模2analysis-modelingreports/ANALYSIS_MODELING_REPORT.md3. 编程实现与图表3coding-visualcode/、results/、figures/4. 流程图/架构图4drawiofigures/*.drawio PDF5. 论文撰写5writingpaper/Typst 或 LaTeX6. 验证验收6verityreports/VERIFY_REPORT.md除了 6 个流程 skill还有 3 类支撑组件typst-author内置完整 Typst 语法参考文档skills/typst-author/SKILL.md写作阶段可调用它学习 Typst 写法mathmodel-figure-templates11 套科研图表复刻模板SHAP 蜂群图、泰勒图、云雨图、和弦图等见 skills/mathmodel-figure-templates/SKILL.md_references 知识库math_modeling_norms.md 包含模型选型决策树、题型防错速查、论文写作规范各阶段按需读取用于降低模型幻觉。每个 skill 本质上就是一个目录 一份带 frontmatter 的SKILL.md声明name、description、allowed-tools工作流之间通过阶段边界严格解耦例如3coding-visual只产数据图4drawio只画概念图5writing决定图表放哪个章节且不得编造数值。这套入口 skill 编排 阶段 skill 独立可调用的架构让每个 SKILL.md 都能被单独优化和测试——这正是工作流类贡献者的主战场。五、Typst 模板贡献指南17 套赛事模板长什么样模板全部位于 skills/5writing/templates/ 下采用语言 / 竞赛 / 双引擎的组织方式templates/ ├── zh/ # 14 套中文模板Typst │ ├── cumcm/ # 国赛main.typ sections/*.typ │ ├── cumcm-latex/ # 国赛main.tex sections/*.tex │ ├── huaweibei/ ... │ └── ... └── en/ # 3 套英文模板apmcm / default / mcm以国赛模板为例Typst 版入口 skills/5writing/templates/zh/cumcm/main.typ 通过#include按数字前缀引入各章节文件1_restatement.typ问题重述 →8_sensitivity.typ灵敏度 →9_evaluation.typ评价 →A_code.typ附录LaTeX 版 skills/5writing/templates/zh/cumcm-latex/main.tex 则用\input{}一一对应。贡献一个新竞赛模板的建议步骤找到该竞赛的开源 LaTeX 模板作为参考README 感谢名单里有模板来源在templates/zh/竞赛/下创建main.typsections/章节命名沿用数字前缀约定保证#include顺序正确同步提供竞赛-latex/双引擎版本xelatex 编译需跑两遍解决交叉引用更新 skills/5writing/SKILL.md 中的模板族清单和模板键映射否则 5writing 无法自动匹配用typst compile main.typ本地验证可编译封面、摘要、页眉页脚等比赛要求的格式要完整保留。排版语法拿不准时直接翻阅 skills/typst-author/docs/ 里的教程与参考文档页面设置、表格、样式规则等都有覆盖它就是为 Agent 和人类准备的 Typst 速查手册。六、SKILL 工作流优化黑盒测试是主要方法论作者坦言Harness 上 SKILL 的优化需要大量黑盒测试和调优。具体可以这么做端到端跑真题仓库内置了三套经典赛题2023华数杯C题、2024高教杯C题、2025五一杯C题执行/1start-mathmodel 完成这个数学建模任务观察plan.md、todo.md和paper/的实际产出盯住验收报告6verity/SKILL.md 定义了 9 步验收文本泄漏检测 → 章节结构 → 图表引用 → 数值一致性 → 编译 → PDF 逐页视觉检查 → 验收报告任何FAIL都是工作流的真实 bug 线索修边界而非加功能SKILL.md 中的阶段边界硬错误标准就是流程契约优化时优先修边界模糊导致的重复劳动或产物遗漏而不是随意增加流程步骤。如果你跑出了漂亮的完整案例项目还单独维护了一个示例仓库用于收集优秀结果欢迎提交 PR。七、提交贡献前Git 规范与代码风格贡献代码前请对照 CLAUDE.md 中的约定能显著提高合并效率提交信息格式type: 描述type 取feat/fix/refactor/chore/enhance/docs例如feat: 添加华中杯 Typst 模板后端PythonGoogle 风格 docstring、str | None风格类型注解、全程 async/await提交前跑ruff check与ruff format配置见 backend/pyrightconfig.json前端Vue 3 TypeScriptscript setup langts、tab 缩进、Biome 管理 lint注意 frontend/src/components/ui/ 是 shadcn-vue 生成代码不要修改SKILL 改动保持 frontmatter 字段完整改动工作流时同步更新plan.md约定的阶段表和 skills/skills.sh.json 中的 skill 清单。写在最后MathModelAgent 的未来只有两个字SKILLS。无论你会 Typst 排版、会写 prompt、还是喜欢在不同模型上做黑盒实验这里都有对应的贡献位置。从 CLAUDE.md 开始读起跑一次/doctor环境检查然后挑一个国赛之外的竞赛模板动手吧——你的第一个 PR可能就从一套新的 Typst 论文模板开始。【免费下载链接】MathModelAgent专为数学建模设计的 Agent skills ,自动完成数学建模生成一份完整的可以直接提交的论文。 An Agent Designed for Mathematical Modeling ,Automatically complete mathmodel and generate a complete paper ready for submission.项目地址: https://gitcode.com/GitHub_Trending/ma/MathModelAgent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考