math-modeling-skill
# 🎯 Math Modeling Skill <div align="center"> **为数学建模竞赛和项目提供的结构化三阶段工作流程** [](https://claude.com/claude-code) [](LICENSE) <br/> **关注我** <a href="https://blog.csdn.net/SJbeITenginner?spm=1010.2135.3001.5343" target="_blank"> <img src="https://img.shields.io/badge/CSDN-ffffff?style=flat-square&labelColor=ffffff&color=333333&logo=data:image/svg+xml;base64,PHN2ZyB0PSIxNzcyNjE5MTMzMDQ0IiBjbGFzcz0iaWNvbiIgdmlld0JveD0iMCAwIDEwMjQgMTAyNCIgdmVyc2lvbj0iMS4xIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHAtaWQ9IjQ3MjQiIHdpZHRoPSIyMDAiIGhlaWdodD0iMjAwIj48cGF0aCBkPSJNNTMzLjk0MSA0MTkuMjY0YzE0LjcxLTEuNjIxIDM3LjI5MS0zLjI2NCA2OC4zNTItMy4yNjQgNTEuODcyIDAgOTMuODAzIDkuMTUyIDExOS43NzYgMjguNDE2IDIzLjMzOSAxNy45NTIgMzguODU5IDQ3LjAwOCAzNC41NiA4OS4xMy0zLjk3OCAzOS4xOS0yNC4wNDIgNjYuNjM1LTUzLjMxMiA4My41OTVDNjc2LjU0NCA2MzMuMTUyIDY0Mi44MzcgNjQwIDU5Mi4xMDcgNjQwYy0yOS44ODggMC01OC40MjItMS42NDMtODAuMTA3LTQuODk2bDIxLjk0MS0yMTUuODR6IG00Mi44NyAxNzIuOTM5YzQuOTgxIDAuOTkyIDExLjU2MiAxLjk3MyAyNC41MzMgMS45NzMgNTEuODgzIDAgODguNDctMjUuODc3IDkyLjE2LTYyLjI0IDUuMzMzLTUyLjU1NS0yNy4xMjUtNzAuOTQ0LTgxLjgwMy03MC42MjQtNy4wNzIgMC0xNi45MTcgMC0yMi4xMzMgMC45N0w1NzYuOCA1OTIuMjE0aDAuMDF6bTIyMy40OTgtMTY0LjcwNGMyMTAuOTU1LTM5Ljg3MiAyMjkuMTYzIDMxLjc3NiAyMjIuNjQ2IDk1LjE4OUwxMDEwLjY1NiA2NDBoLTY2Ljk0NGwxMS4yMS0xMDYuOTg3YzIuNDIyLTIzLjU2MiAxNy41MDUtNjkuNjUzLTU1LjMzOC02Ny45MTQtMjUuMTg0IDAuNjA4LTM3LjcwNyA0LjA2NC0zNy43MDcgNC4wNjRzLTIuMTg2IDI4LjQ2OS00LjgzMiA0OS41MTRMODQ0LjMyIDY0MGgtNjUuNjUzbDEzLjAyNC0xMTkuNTczIiBmaWxsPSIjMjMxOTE2IiBwLWlkPSI0NzI1Ij48L3BhdGg+PHBhdGggZD0iTTIyNi42MzUgNjMyLjY4M2MtMTIuMzc0IDQuMzQxLTM4LjAzOCA3LjMxNy03My45MSA3LjMxN0M0OS42IDY0MC02LjA0OCA1OTAuOTMzIDAuNTIzIDUyNi4wOWM3Ljg5My03Ny4yOCA5MC4zMzYtMTIwLjc1NyAxODAuNjE4LTEyMC43NTcgMzQuOTc2IDAgNTUuNTUyIDIuODU5IDc0Ljg1OSA3LjYzOGwtNi4yMDggNTIuMDY0Yy0xMi44MjEtNC4zODQtNDIuODktOC40MDYtNjcuMjMyLTguNDA2LTUzLjE0MSAwLTk4LjI1IDE2LjA0My0xMDMuNDI0IDY2Ljc2My00LjYwOCA0NS4zNTUgMjcuMDYxIDY3LjA0IDg2LjgxNiA2Ny4wNCAyMC44IDAgNTEuNDc3LTMuMDE5IDY1LjY1My03LjM3bC00Ljk5MiA0OS42IDAuMDIyIDAuMDJ6IiBmaWxsPSIjQzkyMDI3IiBwLWlkPSI0NzI2Ij48L3BhdGg+PHBhdGggZD0iTTI3Mi43MTUgNTgwLjAyMWMxOS4yODUgNi43NjMgNTkuNDg4IDEzLjUwNCA5MiAxMy41MDQgMzUuMDI5IDAgNTQuNTI4LTkuMzMzIDU2LjA5Ni0yMy43OTcgMS40MTgtMTMuMjA1LTEyLjkyOC0xNC45ODctNTIuNDkxLTI0LjAxLTU0LjY2Ny0xMi44OTctODkuNTQ3LTMyLjg0My04Ni4xMzMtNjQuNzA1QzI4Ni4xNzYgNDQzLjk5IDMzNy42ODUgNDE2IDQxNi43MjUgNDE2YzM4LjU2IDAgNzUuOTE1IDIuNjEzIDk1LjI3NSA4LjcxNWwtNi42NTYgNDYuNjY2Yy0xMi41NjUtNC4yMDItNjAuNjcyLTEwLjAzNy05My4yMDUtMTAuMDM3LTMyLjk5MiAwLTUwLjA3IDkuOTczLTUxLjI1NCAyMC45MTctMS40OTMgMTMuODQ2IDE1LjY1OSAxNC40ODYgNTguNTI4IDI1LjQ1MSA1OC4wMjcgMTQuMTU1IDgzLjQwMyAzNC4wOSA4MC4wODYgNjQuOTkyQzQ5NS42MDUgNjA5LjEwOSA0NDkuMjU5IDY0MCAzNTYuNzE1IDY0MGMtMzguNTI4IDAtNzEuNzQ0LTYuNzYzLTkwLjA0OC0xMy41MjVsNi4wNDgtNDYuNDU0eiIgZmlsbD0iIzIzMTkxNiIgcC1pZD0iNDcyNyI+PC9wYXRoPjwvc3ZnPg==" alt="CSDN"> </a> <a href="https://www.zhihu.com/people/27-85-7-72-95/posts" target="_blank"> <img src="https://img.shields.io/badge/知乎-ffffff?style=flat-square&labelColor=ffffff&color=333333&logo=data:image/svg+xml;base64,PHN2ZyB0PSIxNzcyNjE5NDM1MTA1IiBjbGFzcz0iaWNvbiIgdmlld0JveD0iMCAwIDEwMjQgMTAyNCIgdmVyc2lvbj0iMS4xIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHAtaWQ9IjU3MTIiIHdpZHRoPSIyMDAiIGhlaWdodD0iMjAwIj48cGF0aCBkPSJNNjU2LjkwNjI0IDcyNC4yOTA1Nmw0Ny40MjE0NC0zMy43MjU0NGg1Mi42ODk5MlYzNDQuODk4NTZoLTE0My4zMTkwNHYzNDYuNzI2NGgzNS44Mjk3NnoiIGZpbGw9IiMwMDY2RkYiIHAtaWQ9IjU3MTMiPjwvcGF0aD48cGF0aCBkPSJNODQ5LjkyIDUxLjJIMTc0LjA4Yy02Ny44NjU2IDAtMTIyLjg4IDU1LjAxNDQtMTIyLjg4IDEyMi44OHY2NzUuODRjMCA2Ny44NjU2IDU1LjAxNDQgMTIyLjg4IDEyMi44OCAxMjIuODhoNjc1Ljg0YzY3Ljg2NTYgMCAxMjIuODgtNTUuMDE0NCAxMjIuODgtMTIyLjg4VjE3NC4wOGMwLTY3Ljg2NTYtNTUuMDE0NC0xMjIuODgtMTIyLjg4LTEyMi44OHpNNDk1LjY2MjA4IDgwMy4zNDg0OGwtMTAxLjE3MTItMTU3LjA1MDg4IDQ0LjI2NzUyLTMxLjYxNiA2Ny40NTA4OCA5OC4wMDcwNGMtMC4wMDUxMiAwIDIzLjE3ODI0IDM3Ljk5NTUyLTEwLjU0NzIgOTAuNjU5ODR6bTM4Ljk5MzkyLTI3Ni4xMDExMnYyNS4yOTI4SDQwOC4xOTcxMkMzNTcuNjExNTIgODc2LjA2Nzg0IDIwNC44IDgwNy4wNDUxMiAyMDQuOCA4MDcuMDQ1MTJjMTQwLjE2NTEyLTEwOS44NjQ5NiAxNDIuNzk2OC0yNTQuNTA0OTYgMTQyLjc5NjgtMjU0LjUwNDk2SDIwOC40OTE1MmMwLTU3Ljk1ODQgNTIuMTYyNTYtNTYuOTEzOTIgNTIuMTYyNTYtNTYuOTEzOTJoOTMuNzkzMjh2LTE1MS43NTY4aC01MC41ODU2QzI4NC44OTcyOCA0MjkuMjM1MiAyMDQuOCA0MjUuMDIxNDQgMjA0LjggNDI1LjAyMTQ0czMyLjY3MDcyLTUwLjU4NTYgNTQuNzk5MzYtMTM3LjAwMDk2YzIyLjEyODY0LTg2LjQyMDQ4IDg5LjU3NDQtNzYuOTI4IDg5LjU3NDQtNzYuOTI4LTIwLjAxOTIgMzUuODI5NzYtMjkuNTA2NTYgNzYuOTI4LTI5LjUwNjU2IDc2LjkyOEg0ODUuMTJjNDAuMDQ4NjQgMCAzNy45MzkyIDI1LjI5MjggMzcuOTM5MiAyNS4yOTI4djI5LjUxMTY4SDQxMS4zNTYxNnYxNTIuODA2NEg1MDMuMDRjMzMuNzI1NDQgMCAzMS42MTYgMzEuNjE2IDMxLjYxNiAzMS42MTZ6TTgxOS4yIDc0Ny40OTk1MmgtMTAyLjIyNTkybC04OC41MTk2OCA1NS44NDg5Ni04LjQyNzUyLTU1Ljg0ODk2aC02NC4yOTE4NFYyODguMDE1MzZIODE5LjJ2NDU5LjQ4NDE2eiIgZmlsbD0iIzAwNjZGRiIgcC1pZD0iNTcxNCI+PC9wYXRoPjwvc3ZnPg==" alt="知乎"> </a> <a href="https://www.xiaohongshu.com/user/profile/6497dd69000000001c02ab98" target="_blank"> <img src="https://img.shields.io/badge/小红书-ffffff?style=flat-square&labelColor=ffffff&color=333333&logo=data:image/svg+xml;base64,PHN2ZyB0PSIxNzcyNjIzODMyNjU4IiBjbGFzcz0iaWNvbiIgdmlld0JveD0iMCAwIDIxMjEgMTAyNCIgdmVyc2lvbj0iMS4xIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHAtaWQ9IjQ3MDgiIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB3aWR0aD0iNDE0LjI1NzgxMjUiIGhlaWdodD0iMjAwIj48cGF0aCBkPSJNNDg2LjUyMjU1IDM5Mi4wMzAyMzRIMzkwLjE1OTczOGM4LjM4NDk4NCAxMjUuNzEwMjU0LTIyLjM4MTQ1NiAyMjEuMDQxMDY4LTIyLjM4MTQ1NiAyMjEuMDQxMDY5bDUxLjY2NDM5OSA5NC42ODU4MTVjNjguNDk4ODY2LTI5LjM0NzQ0MyA2Ny4wNzk4NjktMzE1LjcyNjg4MyA2Ny4wNzk4NjktMzE1LjcyNjg4NE03OTkuNDc1OTM5IDM5Mi4wMzAyMzRINzAzLjA0ODYyN3MtMS40MTg5OTcgMjg2LjM3OTQ0MSA2Ny4wNzk4NjkgMzE1LjcyNjg4NGw1MS42NjQzOTktOTQuNjg1ODE1cy0zMC43MDE5NC05NS4zMzA4MTQtMjIuMzE2OTU2LTIyMS4wNDEwNjlNNTQ3LjM0NTkzMSA2ODAuMDIyMTcyaC02MC43NTg4ODFjMCA3MS4wMTQzNjEgNjAuMDQ5MzgzIDc3LjI3MDg0OSA2MC4wNDkzODIgNzcuMjcwODQ5aDMwLjcwMTk0YzYxLjcyNjM3OSAwIDY0LjI0MTg3NS03MC41NjI4NjIgNjQuMjQxODc1LTcwLjU2Mjg2MlYyNjYuMzE5OThINTQ3LjM0NTkzMXY0MTMuNzAyMTkyek04NzEuNjUxMjk4IDQ3OC42NTM1NjVoNjIuODIyODc3bC00Ny45MjM0MDcgOTcuNzgxODA5cy0yNy45Mjg0NDUgNTQuOTUzODkzIDE2Ljc2OTk2OCA1Ni44MjQzODloMTA0LjI5NjI5Nmw0MS42NjY5MTktNzUuNjU4MzUyaC01Mi4xMTU4OTlhOC45MDA5ODMgOC45MDA5ODMgMCAwIDEtNy45MzM0ODQtMTIuODk5OTc1bDc3LjkxNTg0OC0xNTIuNjA2NzAyaC05MC4zNjQzMjRsLTUuMzUzNDg5IDEwLjk2NDk3OWgtNS45OTg0ODlhOC45MDA5ODMgOC45MDA5ODMgMCAwIDEtNy45MzM0ODQtMTIuODk5OTc1bDY0Ljg4Njg3My0xMjMuNzc1MjU4SDkzMi4wMjMxOGwtNzcuMTQxODUgMTU1LjQ0NDY5NnMtMjcuOTI4NDQ1IDU0Ljk1Mzg5MyAxNi43Njk5NjggNTYuODI0Mzg5TTg4NS4zODk3NzEgNjYzLjcwMzcwNHMtMTEuNTQ1NDc3IDEuMDMxOTk4LTE5LjIyMDk2My02LjY0MzQ4N2wtNDYuNzYyNDA4IDkwLjEwNjMyNHM3LjY3NTQ4NSAxMC40NDg5OCAyMy40MTM0NTQgMTAuNDQ4OTc5aDExNS45NzA3NzNsNDkuNjAwNDAzLTkzLjkxMTgxNmgtMTIzLjAwMTI1OXoiIGZpbGw9IiNGRjAwMDAiIHAtaWQ9IjQ3MDkiPjwvcGF0aD48cGF0aCBkPSJNMTIzNS43NTMwODYgMzkyLjAzMDIzNGg1OS41OTc4ODRWMjk2LjExODkyMmgtMjEzLjIzNjU4NHY5NS45MTEzMTJoNjAuNTAwODgydjI3NC43MDQ5NjRoLTg5LjM5NjgyNWwtNDQuODkxOTEyIDkwLjU1NzgyM2gzMTcuNzkwODc5di05MC41NTc4MjNoLTkwLjM2NDMyNHpNMTY2My4wMDAyNTIgNDYyLjc4NjU5NmgtMTAuOTY0OTc5di02Mi4wNDg4NzljMC01OC4xMTQzODYtNDcuMDg0OTA4LTEwNS4xOTkyOTUtMTA1LjE5OTI5NC0xMDUuMTk5Mjk0aC0zNi4zMTM0Mjl2LTI5LjI4Mjk0M0gxNDE4LjM1MjIzdjI5LjI4Mjk0M2gtNTcuODU2Mzg3VjM4OS41NzkyMzloNTcuODU2Mzg3djczLjIwNzM1N2gtOTIuMjM0ODJ2OTQuMDQwODE2aDkyLjE3MDMydjIwMC40NjU2MDloOTIuMTcwMzJWNTU2Ljg5MTkxMmgxMjYuODcxMjUyYzEyLjQ0ODQ3NiAwIDIyLjU3NDk1NiAxMC4xMjY0OCAyMi41NzQ5NTYgMjIuNTc0OTU2djk4Ljc0OTMwN2gtODcuOTc3ODI4YzAgNDMuNjY2NDE1IDM1LjQxMDQzMSA3OS4wNzY4NDYgNzkuMDc2ODQ1IDc5LjA3Njg0NmgyMy44MDA0NTRjNDMuNjY2NDE1IDAgNzkuMDc2ODQ2LTM1LjQxMDQzMSA3OS4wNzY4NDUtNzkuMDc2ODQ2VjU1My44NjA0MThjMC4xMjktNTAuMzA5OTAyLTQwLjYzNDkyMS05MS4wNzM4MjItOTAuODgwMzIyLTkxLjA3MzgyMm0tMTUyLjQ3NzcwMi03My4xNDI4NTdoMzMuMTUyOTM1YzcuOTMzNDg1IDAgMTQuMzE4OTcyIDYuMzg1NDg4IDE0LjMxODk3MiAxNC4zMTg5NzJ2NTguODIzODg1aC00Ny40NzE5MDdWMzg5LjY0MzczOXoiIGZpbGw9IiNGRjAwMDAiIHAtaWQ9IjQ3MTAiPjwvcGF0aD48cGF0aCBkPSJNMTc1Mi42NTUwNzcgMzQxLjcyMDMzM2MwLTI1LjIxOTQ1MS0yMC40NDY0Ni00NS42NjU5MTEtNDUuNjAxNDExLTQ1LjY2NTkxMWE0NS42NjU5MTEgNDUuNjU5MTEgMCAwIDAtNDUuNjY1OTExIDQ1LjY2NTkxMXY0NS42NjU5MWg0NS42NjU5MTFjMjUuMTU0OTUxIDAgNDUuNjAxNDExLTIwLjQ0NjQ2IDQ1LjYwMTQxMS00NS42NjU5MSIgZmlsbD0iI0ZGRjAwMDAiIHAtaWQ9IjQ3MTEiPjwvcGF0aD48L3N2Zz4=" alt="小红书"> </a> </div> --- ## 📖 简介 本技能为数学建模竞赛（CUMCM、MCM/ICM等）提供**建模分析 → 代码实现 → 论文撰写**三阶段协作工作流程，确保建模、编程、论文撰写三个环节紧密衔接，产出高质量的数学建模成果。 ## 💡 创新指南 本技能鼓励创新和灵活性： ### 🔗 算法组合 - 可组合多个算法：如"灰色预测+神经网络" - 参考不同类别的算法：如图论算法用于优化 ### 🔍 题目特殊分析 - 当常规方法不适用时，灵活调整 - 分析题目独特性，选择或设计专门方法 ### 📝 创新记录 - 在分析文档中说明选择理由 - 在论文中突出创新点 ## ✨ 特性 - 🔄 **三阶段协作**：建模分析、代码实现、论文撰写，各司其职 - 🧩 **渐进式角色Skill**：每个角色独立为子Skill，按阶段加载，降低单次上下文负担 - 📚 **算法资源库**：涵盖优化、预测、评价、图论、统计、综合、机器学习7大类60+算法 - 🎨 **SCI/Nature 级可视化**：Figure Contract 前置规划 + 语义调色板 + SVG/PNG双格式 + HTML导航面板 - 📝 **论证驱动写作**：Claim-Evidence 映射 + 章节架构模式 + 自审框架，美赛支持英文化工作流 - 📄 **论文规范**：默认模板 + 自定义模板支持，符合竞赛格式要求 - 🛠️ **文档处理集成**：集成 docx、pdf、xlsx、paper_search 四个专业子skill，支持： - 📘 **docx skill**：创建、读取、编辑Word文档，生成标准格式论文 - 📑 **pdf skill**：读取PDF题目、提取文本和表格数据 - 📊 **xlsx skill**：处理Excel表格数据、结果输出，使用公式而非硬编码 - 🔎 **paper_search skill**：通过 OpenAlex + AnySearch 双引擎并行搜索学术论文，支持交叉验证，提供更可靠的参考文献支持 ## 🔄 工作流程 <div align="center"> <img src="imgs/三角色流程图.png" alt="三角色协作流程图" width="85%"> </div> ### 各阶段详细任务 | 阶段 | 任务 | 产出 | 子Skill入口 | |:----:|------|------|-----------| | **建模分析** | 前置合同、题目分析、模型选择、算法设计、术语规范 | 分析报告 + 术语表 + 前置合同 | `references/roles/建模手/` | | **代码实现** | 环境检查、代码编写、结果求解、Figure Contract可视化 | 代码 + SVG/PNG图表 + HTML面板 | `references/roles/编程手/` | | **论文撰写** | 论证构建、Claim-Evidence映射、章节模板写作、自审 | 完整论文（≥15000字，.docx） | `references/roles/论文手/` | ### 三角色介绍 本技能采用**三角色协作模式**，每个角色对应一个工作阶段： | 角色 | 对应阶段 | 定位 | 核心能力 | | :--------------: | :------: | ---- | -------------------- | | **建模手** | 建模分析 | 大脑 | 数学建模、算法设计 | | **编程手** | 代码实现 | 双手 | 代码实现、数据可视化 | | **论文手** | 论文撰写 | 喉舌 | 学术写作、成果整理 | **📘 建模手** - 团队的大脑 建模手负责将实际问题转化为数学模型，是整个建模过程的起点。主要工作包括：建立前置合同（Model Contract）、深入理解题目背景、选择合适的数学模型和算法、设计求解思路、建立术语规范。详细文档见 `references/roles/建模手/SKILL.md`（渐进式加载）。 **💻 编程手** - 团队的双手 编程手负责将建模手的理论设计转化为可运行的代码。主要工作包括：检查编程环境、严格按照建模分析思路编写代码、生成符合 SCI/Nature 标准的可视化图表（Figure Contract + 语义调色板 + SVG/PNG双格式）、创建 HTML 导航面板。详细文档见 `references/roles/编程手/SKILL.md`（渐进式加载）。 **📝 论文手** - 团队的发言人 论文手负责将前两个阶段的工作成果整理成规范的学术论文。主要工作包括：构建论证框架（Argument Building）和 Claim-Evidence 映射、按章节架构模式撰写论文、通过四轮自审框架检查质量。支持国赛（中文）和美赛（英文，含英文化工作流）。详细文档见 `references/roles/论文手/SKILL.md`（渐进式加载）。 ## 🚀 快速开始 ### 🤖 推荐 Agent 本技能在以下 AI Agent 中测试并推荐使用： | 推荐 | Agent | 说明 | |:----:|-------|------| | ⭐ **首推** | **[Claude Code](https://claude.com/claude-code)** | 完整支持渐进式 Skill 加载、子 Skill 调用和工具链集成 | | ✅ **兼容** | **[Codex](https://github.com/openai/codex)** | OpenAI 开源命令行编码 Agent，支持 MCP 协议与 Skill 加载 | | ✅ **兼容** | **[Cursor](https://www.cursor.com)** | AI-native IDE，支持 Agent 模式和第三方 Skill 集成 | | ✅ **兼容** | **[Trae](https://www.trae.com)** | 字节跳动出品 AI-native IDE，支持 Skill 插件系统与 MCP 协议 | | ✅ **兼容** | **[Qoder](https://qoder.com)** | 阿里云出品 AI 编程 Agent 平台，支持自主开发工作台 | | ✅ **兼容** | **[Hermes Agent](https://github.com/NousResearch/hermes-agent)** | 开源自进化 Agent 框架，支持 12+ 竞品配置一键迁移 | | ✅ **兼容** | **[OpenClaw](https://github.com/steipete/OpenClaw)** | 开源 Agent 网关，支持 3000+ Skill 和 23+ 消息平台接入 | ### 📦 安装 选择以下任一种方式安装： #### 方式一：Git 克隆（通用） ```bash git clone https://github.com/XiaoMaColtAI/math-modeling-skill.git ``` 克隆完成后，将文件夹复制到对应 Agent 的 skills 目录： | Agent | 安装路径 | |-------|---------| | **Claude Code** | `~/.claude/skills/math-modeling-skill` (macOS/Linux) | | | `%USERPROFILE%\.claude\skills\math-modeling-skill` (Windows) | | **Codex** | 通过 `--skill-dir` 参数指定路径 | | **Cursor** | 项目根目录创建 `.cursor/skills/` 放入 | | **Trae** | 通过内置插件市场安装或配置 Skills 目录 | | **Qoder** | 通过知识库或工作台配置导入 | | **Hermes Agent** | 执行 `skills import` 命令导入 | | **OpenClaw** | `~/.openclaw/skills/math-modeling-skill` | #### 方式二：npx 快速安装（兼容 Agent） ```bash npx skills add https://github.com/xiaomacoltai/math-modeling-skill --skill math-modeling ``` #### 方式三：下载 ZIP 下载 [最新版 ZIP](https://github.com/XiaoMaColtAI/math-modeling-skill/archive/refs/heads/main.zip)，解压后放入对应技能的目录即可。 #### ✅ 验证安装 在 Agent 对话中输入以下指令，确认技能已激活： ``` /math-modeling ``` 如果安装成功，你将看到技能介绍和可用的三阶段工作流说明。 --- ### ▶️ 使用 #### 基础用法 本技能围绕数学建模竞赛的三阶段流程组织，每个阶段由独立子 Skill 驱动： **一句话启动（推荐）** ``` /math-modeling 帮我做这道数学建模题 ``` Agent 会自动执行完整的三角色协作流程。 **分阶段推进（精细控制）** ``` /math-modeling 进行建模分析 # 阶段一：题目分析、模型选择、算法设计 /math-modeling 进行代码实现 # 阶段二：编写求解代码、结果可视化 /math-modeling 进行论文撰写 # 阶段三：构建论证、撰写完整论文 ``` **三个角色，一次完整竞赛流程** | 阶段 | 角色 | 做什么 | 产出 | |:----:|:----:|--------|------| | ① | **建模手** | 分析题目、选择模型、设计算法、建立术语规范 | 分析报告 + 术语表 | | ② | **编程手** | 编写代码、求解结果、Figure Contract 可视化 | 代码 + SVG/PNG图表 + HTML面板 | | ③ | **论文手** | 构建论证、Claim-Evidence 映射、章节模板写作、自审 | 完整论文（.docx） | > **⚠️ 重要提示** > > AI 生成的论文具有明显的"AI 味道"，容易被检测工具识别。**请勿直接使用 AI 生成的全文**，建议： > > - 将 AI 生成的内容作为参考和框架，结合自己的理解进行修改 > - 添加个人见解和创新点，调整表述风格 > - 使用论文手中内置的"去AI味检查"逐项校准 --- ## ⚙️ 配置说明 ### 🔎 Paper Search 邮箱与API配置 `paper_search` skill 采用 **OpenAlex + AnySearch 双引擎并行搜索**，支持交叉验证。 #### OpenAlex 邮箱配置 OpenAlex API 需要提供邮箱地址以使用礼貌池（Polite Pool）提高API访问限制。 | 项目 | 说明 | | ------------------ | -------------------------- | | **API 地址** | https://api.openalex.org | | **文档** | https://docs.openalex.org/ | | **认证方式** | 无需API Key，仅需提供邮箱 | | **费用** | 完全免费 | ```bash # 命令行运行脚本时传入 python tools/paper_search/scripts/hybrid_scholar.py \ --query "grey prediction model" \ --email "[email protected]" ``` ```python # 代码中调用时传入 from hybrid_scholar import HybridScholar scholar = HybridScholar(email="[email protected]") result = scholar.search_papers("linear programming optimization") ``` #### AnySearch API Key（可选） AnySearch 支持匿名访问（速率较低），建议配置 API Key 以获得更高限额： ```bash # 方式一：环境变量（推荐） export ANYSEARCH_API_KEY="your_key_here" # 方式二：CLI 参数 python hybrid_scholar.py --query "..." --anysearch-api-key "your_key_here" ``` 获取 API Key：https://anysearch.com/console/api-keys #### 注意事项 - 📧 OpenAlex 邮箱必须是有效的邮箱地址格式，用于礼貌池提高速率限制 - 🔑 AnySearch API Key 为可选项，匿名也可使用（速率较低） - 🚀 双引擎模式下，两个源的结果会自动去重并标记交叉验证 --- ## 📂 目录结构 ``` math-modeling-skill/ ├── SKILL.md # 技能主文档 ├── README.md # 本文件 ├── assets/ # 算法资源库（7类60+算法） ├── references/ │ ├── roles/ # 三角色子Skill（渐进式加载） │ │ ├── 建模手/ # 建模分析阶段 │ │ │ ├── SKILL.md │ │ │ └── references/ │ │ │ ├── 前置合同.md │ │ │ ├── 工作流程.md │ │ │ ├── 常见模式.md │ │ │ ├── 建模设计理论.md │ │ │ └── 质检清单.md │ │ ├── 编程手/ # 代码实现阶段 │ │ │ ├── SKILL.md │ │ │ └── references/ │ │ │ ├── 工作流程.md │ │ │ ├── 可视化规范.md │ │ │ ├── 常见模式.md │ │ │ ├── 可视化面板模板.html │ │ │ └── 质检清单.md │ │ └── 论文手/ # 论文撰写阶段 │ │ ├── SKILL.md │ │ └── references/ │ │ ├── 工作流程.md │ │ ├── 章节模板.md │ │ ├── 写作规范.md │ │ ├── 进阶技巧.md │ │ ├── 自审框架.md │ │ ├── 英文化工作流.md │ │ ├── 论文模板.docx │ │ └── 默认论文模板.md │ ├── Outstanding Thesis/ # 优秀论文资源库 │ │ ├── CUMCM/ # 国赛优秀论文 │ │ └── 2017MCM ICM/ # 美赛O奖论文（A-F题） │ └── README.md # 三角色工作指南 └── tools/ # 集成的子Skill ├── docx/ # Word文档处理Skill ├── pdf/ # PDF文档处理Skill ├── xlsx/ # Excel表格处理Skill └── paper_search/ # 论文搜索Skill ``` ## 🧮 算法覆盖 | 类别 | 算法数量 | 代表算法 | | ------------- | -------- | -------------------------------------------------------------------- | | ⚙️ 优化算法 | 15 | 线性规划、遗传算法、PSO、模拟退火、鲸鱼优化、麻雀搜索、多目标优化 | | 📈 预测算法 | 11 | 灰色预测、ARIMA、神经网络、Prophet、LSTM、XGBoost/LightGBM、时空预测 | | ⭐ 评价算法 | 11 | AHP、TOPSIS、熵权法、灰色关联、DEA、区间数评价、改进TOPSIS | | 🕸️ 图论网络 | 6 | 最短路径、最大流、MST、匹配问题 | | 📊 统计分析 | 9 | K-Means、层次聚类、DBSCAN、SOM、GMM、PCA、因子分析、CCA、NMF | | 🎲 综合算法 | 6 | 蒙特卡洛、排队论、博弈论、马尔科夫链、微分方程 | | 🤖 机器学习 | 3 | 随机森林、AdaBoost、孤立森林 | --- ## 📸 示例展示 以下图表为采用本技能可视化规范生成的 **2025 年国赛（CUMCM）** 实际参赛作品示例，展示了 Figure Contract 规划下的 SCI/Nature 级图表输出效果。 ### 2025 年国赛 A 题 — 烟幕干扰弹的投放策略 <div align="center"> <img src="imgs/2025-国赛-A题示例1.svg" alt="国赛A题示例1" width="90%"> <br> <em>烟幕干扰弹投放方案对比 + 关键参数敏感性分析（双子图布局）</em> <br><br> <img src="imgs/2025-国赛-A题示例2.svg" alt="国赛A题示例2" width="90%"> <br> <em>多目标优化 Pareto 前沿 + 不同策略效果对比（GridSpec 不对称布局）</em> </div> ### 2025 年国赛 B 题 — 碳化硅外延层厚度的确定 <div align="center"> <img src="imgs/2025-国赛-B题示例1.svg" alt="国赛B题示例1" width="90%"> <br> <em>外延层厚度拟合结果 + 不同方法预测精度对比（双子图 a, b 面板标签）</em> <br><br> <img src="imgs/2025-国赛-B题示例2.svg" alt="国赛B题示例2" width="90%"> <br> <em>模型预测误差分布 + 实测值与预测值一致性分析</em> </div> ## 🏆 适配竞赛 本技能完整适配以下数学建模竞赛： | 竞赛 | 英文/简称 | 说明 | |------|-----------|------| | 🌍 **美国大学生数学建模竞赛** | MCM / ICM | 美赛，国际影响力最大的数学建模竞赛，含 MCM（数学建模）和 ICM（跨学科建模）两类 | | 🌏 **亚太地区大学生数学建模竞赛** | APMCM | 亚太赛，面向亚太地区高校的数学建模竞赛 | | 🇨🇳 **全国大学生数学建模竞赛** | CUMCM | 高教社杯·国赛，中国规模最大的数学建模竞赛 | | ⚡ **MathorCup 高校数学建模挑战赛** | MathorCup | 原"电工杯"，由中国优选法统筹法与经济数学研究会主办 | | 🔷 **认证杯·数学中国数学建模网络挑战赛** | 认证杯 | 数学中国主办的阶段性网络挑战赛 | | 🔢 **数维杯大学生数学建模竞赛** | 数维杯 | 内蒙古自治区数学学会主办的大学生数学建模竞赛 | 以上竞赛在论文格式、评分标准、写作规范上有所不同，但本技能的三角色协作工作流和算法资源库均适用。根据具体竞赛要求调整输出格式即可。 --- ## 📋 更新日志 ### v2.4 (2026-05) #### 🏗️ 重大架构更新：角色子Skill + 渐进式加载 原三个单文件角色文档重构为独立子Skill体系，每个角色自包含入口 SKILL.md + 细分引用文件，按阶段渐进加载，大幅降低单次对话上下文负担。 **角色文件迁移**： ``` 旧（单文件） 新（子Skill + 渐进式加载） references/roles/ ├── 建模手说明.md → references/roles/建模手/{SKILL.md + 4个引用} ├── 编程手说明.md → references/roles/编程手/{SKILL.md + 4个引用} └── 论文手说明.md → references/roles/论文手/{SKILL.md + 7个引用} ``` #### 🎯 建模手：新增 Model Contract + 常见模式 + 缺失输入处理 - **Model Contract（前置合同）**：在分析前建立核心结论→证据链→方案评审→交付规格的完整规划框架 - **11种建模常见模式**：按优化/预测/评价/综合分类，含模型组合决策树 - **缺失输入处理规则**：数据不足、模型不适用、问题类型不明确时的标准化处理流程 - **防冗余原则**：每个模型承载独特分析维度，避免重复建模 #### 🎨 编程手：SCI/Nature 级可视化规范 + 环境检查 + 图表常见模式 - **Figure Contract**：绘图前先定核心结论→证据链→面板映射→评审风险检查 - **完整颜色体系**：语义调色板 PALETTE + 低饱和度 PALETTE_NMI_PASTEL，跨面板统一色系 - **SVG + PNG 双格式输出**：强制 `svg.fonttype='none'` 保持文本可编辑，dpi=300 - **HTML 可视化导航面板**：左侧导航栏 + SVG 渲染 + 导出 + 缩放控制 - **环境检查步骤**：在编码前检查运行时和依赖包，不因环境问题切换语言 - **11种图表常见模式**：分组柱状图、趋势+CI、热力图、气泡图、箱线图等，含代码模板 - **无网格线 / 仅左+下spines / 面板标签规范 / 统计标注规则** #### 📝 论文手：论证驱动写作 + 章节架构模式 + 自审框架 + 英文化工作流 - **Argument-first 写作法**：一句话论证模板 + 核心论证要素 + Claim-Evidence 显式映射 - **摘要六要素架构**：context→gap→approach→result→implication→boundary - **引言五要素架构**：field scale→bottleneck→prior attempts→gap→present study - **结果证据阶梯**：system→validation→main result→comparison→analysis→application - **Discussion 架构**：advance→evidence→relation→constraints→future - **Related Work 主题综合法**（美赛专用）：按技术主题组织，非逐篇罗列 - **四轮自审框架**：论证逻辑→章节结构→表述质量→格式规范，含反方测试 - **英文化工作流**：三阶段转换（理解→写作→校准）+ 动词强度谱系 + 句式转换表 - **段落流检查**：一段一消息三步检查法 - **正式输出格式**：草稿 + 大纲 + 假设 + Claim-Evidence 映射 + 结构说明 #### 📦 其他 - 所有角色文档路径从 `roles/` 迁移至 `references/roles/` - 新增 `roles/建模手/references/建模设计理论.md` - 新增 `roles/编程手/references/可视化面板模板.html` - 新增 `roles/论文手/references/论文模板.docx` + `默认论文模板.md` - 整体 README 和 CLAUDE.md 同步更新 #### 🔬 可视化面板科研化重设计 - **配色升级**：采用项目可视化规范 PALETTE 色系（学术蓝 `#0F4D92` + 金色 `#FFD700` 激活态） - **新增导出 PNG**：SVG 渲染为高分辨率 PNG（2x DPR）下载 - **图表元信息栏**：Figure 编号 + 描述，模拟论文图表标题格式 - **键盘快捷键**：`Ctrl+=`/`-` 缩放、`Ctrl+E` 导出、`↑↓` 切换、`F11` 全屏 - **Ctrl+滚轮缩放 + 缩放百分比指示器** #### 🔎 Paper Search 双引擎并行搜索 - **AnySearch Academic 集成**：直接通过 JSON-RPC 2.0 调用 AnySearch API，无需外部依赖 - **混合搜索引擎 `hybrid_scholar.py`**：ThreadPoolExecutor 并行调用 OpenAlex + AnySearch - **交叉验证机制**：DOI 精确去重 + 标题模糊去重，结果分三区展示（交叉验证 / OpenAlex 独有 / AnySearch 独有） - **兼容原参数**：支持 `--openalex-only`、`--anysearch-only` 单源模式，JSON 输出 - 新增 `anysearch_academic.py`、`hybrid_scholar.py`，更新 `SKILL.md` 和 README 配置说明 #### 🏆 适配竞赛列表 - 完整列出 6 大适配竞赛（美赛 MCM/ICM、亚太赛 APMCM、国赛 CUMCM、MathorCup、认证杯、数维杯） ### v2.0 (2025-02) #### ✨ 重大更新：论文AI味去除系统 针对AI生成论文容易被检测工具识别的问题，本次更新在 `references/roles/论文手说明.md` 中加入了完整的**去AI味写作指南**，基于Wikipedia的"Signs of AI writing"研究整理： **七大类AI痕迹识别与去除：** 1. **内容模式去AI化** - 消除"标志着/重要的是/关键作用"等过度强调词汇 - 去除"独立报道/专家认为"等模糊归因 - 避免"不仅...而且..."等公式化平行结构 - 删除"突破性的/令人惊叹的"等广告式宣传语 2. **语言语法规范化** - 控制"此外/关键的/深入探讨"等AI高频词汇使用 - 避免"拥有/具有"等复杂结构替代简单系动词 - 破除强行分组的"三法则"套路 - 消除同义词过度替换（"模型/算法/方法/方案"循环） 3. **写作风格真实化** - 减少破折号和粗体的过度使用 - 避免内联标题垂直列表（**准确性：** 95%） - 删除表情符号和装饰性元素 - 用具体数据替代模糊积极结论 4. **数学建模论文专用规范** - 禁用"深入探讨/充分展示/具有重要意义"等空泛表达 - 用"准确率达到95.6%，比基准方法高8.2%"替代"结果令人振奋" - 要求每句话都有具体数据或信息支撑 - 承认复杂性和局限性，注入真实分析思考 **完整自查清单**（论文手必须遵守）： - [ ] 是否使用了AI高频词汇？ - [ ] 是否过度使用破折号、粗体？ - [ ] 是否有"不仅...而且..."结构？ - [ ] 是否强行将内容分成三组？ - [ ] 是否有模糊的"专家认为"？ - [ ] 是否有公式化的"挑战与展望"？ - [ ] 每句话是否都有具体数据支撑？ --- #### 🛠️ 新增四个专业子Skill 原 `scripts/` 目录已移除，功能由以下专业子Skill替代： | 子Skill | 功能 | 使用场景 | | ------------------------ | ------------------------- | ------------------------------ | | 📑`tools/pdf` | PDF文档读取、文本表格提取 | 读取比赛题目、学习优秀论文 | | 📊`tools/xlsx` | Excel表格处理、公式计算 | 处理题目数据、输出结果表格 | | 📘`tools/docx` | Word文档生成、模板编辑 | 生成标准格式论文 | | 🔎`tools/paper_search` | OpenAlex+AnySearch双引擎学术搜索 | 交叉验证式参考文献搜索（需配置邮箱，AnySearch API Key可选） | **⚠️ Paper Search 配置提醒**：使用 `paper_search skill` 前需配置 OpenAlex 邮箱（必填），AnySearch API Key 可选但建议配置，详见上方【⚙️ 配置说明】部分。 **三角色必须正确使用对应skill：** - 🧠 **建模手**：使用 `pdf skill` 读题目、`xlsx skill` 分析数据、`paper_search skill` 搜索文献 - 💻 **编程手**：使用 `xlsx skill` 处理Excel数据、使用公式而非硬编码 - ✍️ **论文手**：使用 `docx skill` 生成.docx格式论文、使用 `paper_search skill` 交叉验证文献 --- #### 🏆 优秀论文资源库扩充 新增 `references/Outstanding Thesis/` 目录： **🇨🇳 国赛优秀论文 (CUMCM)** - 9篇 - 🚛 RGV动态调度优化系列（3篇） - 👥 百货商场会员画像描绘系列（2篇） - 🚗 汽车总装线配置系列（3篇） - 🌡️ 高温作业专用服装设计（1篇） **🌍 美赛O奖论文 (2017MCM ICM)** - 27篇 - 📈 A题连续型（4篇） - 📊 B题离散型（5篇） - 💡 C题数据洞察（4篇） - 🕸️ D题运筹网络（5篇） - 🌱 E题环境科学（5篇） - 📋 F题政策分析（4篇） --- #### 📚 三角色说明文档全面增强 | 角色文档 | 新增内容 | | --------------------------- | --------------------------------------------------------------------------------------------------------------- | | 🧠**建模手说明.md** | 增加pdf/xlsx/paper_search skill详细使用方法、文献记录要求、算法资源库索引 | | 💻**编程手说明.md** | 增加xlsx skill公式处理、Python/MATLAB库速查表、SCI/Nature可视化标准 | | ✍️**论文手说明.md** | **重点增加去AI味写作指南**、docx skill使用教程、图文并茂规范（每张图≥100字分析）、人称约束、叙述方式规范 | --- #### 🔧 算法文档改进 - ✅ 修正了所有算法文档中的文献引用格式 - 🔎 新增 `paper_search skill` 支持通过OpenAlex API自动搜索学术论文 - 📖 优化了 `assets/README.md` 算法快速索引 --- ### 🎉 v1.0 (2025-01) - 🎊 初始版本发布 - 🔄 基础三阶段工作流程：建模分析 → 代码实现 → 论文撰写 - 📚 7大类60+算法资源库 - 👥 基础角色分工文档 --- ## ⭐ GitHub Star 历史 <div align="center"> [](https://star-history.com/#XiaoMaColtAI/math-modeling-skill&Date) </div> --- ## 🙏 致谢 本项目的开发受益于以下开源项目和技能： - **[AnySearch Skill](https://github.com/anysearch-ai/anysearch-skill)** — 统一实时搜索引擎，为本项目提供通用搜索与学术垂直域搜索能力，支撑 `paper_search` 工具的双引擎并行搜索与交叉验证 - **[Nature Skills](https://github.com/Yuan1z0825/nature-skills)** — SCI/Nature 级科学可视化规范与写作方法论，为本项目的编程手可视化规范和论文手写作架构提供重要参考 --- ## 📄 许可证 MIT License --- <div align="center"> **[算法资源库](assets/README.md)** · **[使用文档](SKILL.md)** · **[角色说明](references/roles/)** </div>