cumcm-paper-hand-skill README

The project's README from github.com/Mr-potato-123/cumcm-paper-hand-skill. As one markdown file: README.md.

cumcm-paper-hand-skill —— 数学建模竞赛论文写作与全流程辅助

与 AI Agent(如 Claude Code 等)配合,在你的参赛文件夹里完成数学建模竞赛的建模、求解与论文写作,最终以 LaTeX 交付论文(论文.tex + 编译 PDF)。内置获奖优秀论文参考库(OCR 可读版)、论文 LaTeX 模板与目录结构模板。

CUMCM MCM/ICM License

📦 这是什么

面向全国大学生数学建模竞赛(CUMCM)、美国大学生数学建模竞赛(MCM/ICM)参赛者的 Agent Skill。核心思路:

  1. 参赛者把"原始题目、每道题的建模和解答"分文件夹整理好,在这个文件夹里打开 AI Agent;
  2. Skill 指导 Agent 按 摸底 → 核对建模求解材料 → 论文撰写 三步工作;
  3. 论文按写作规范主干(论文写作规范.md)撰写,LaTeX 交付(XeLaTeX 编译零错误,产出 PDF);
  4. 写作时参考 ref/ 的获奖优秀论文——特意覆盖国赛三大题型(A 优化 / B 物理 / C 数据),且 B、C 各有一对"同题不同法"对照(详见 选篇说明)。

🖊️ 定位:论文手(Paper Writer)

本技能定位是论文手——职责是基于你已有的建模笔记与求解结果撰写论文,不重复建模:

简单说:建模和编程自己或队友干,论文的活儿交给它。

🚀 安装(以 Claude Code 为例)

git clone https://github.com/Mr-potato-123/cumcm-paper-hand-skill.git

# 方式一: 全局安装(所有项目可用)
cp -r cumcm-paper-hand-skill/skills/cumcm-paper-hand-skill ~/.claude/skills/

# 方式二: 项目级安装(仅当前项目)
cp -r cumcm-paper-hand-skill/skills/cumcm-paper-hand-skill .claude/skills/

安装的是 skills/cumcm-paper-hand-skill/ 这个自包含目录——它只包含 SKILL.md 及其引用的全部文件,不会出现"装了但引用文件缺失"的问题。安装后用 /skills 确认可见。无需安装也行:把 skills/cumcm-paper-hand-skill/ 整个复制进参赛文件夹,Agent 同样会按 SKILL.md 工作。

🎯 使用流程

  1. 按 目录结构模板 建好参赛文件夹:
my-mcm-project/
├── 题目/          # 原始题目与附件(不修改)
├── 问题A/         # 建模笔记.md + 代码/ + 结果/ + 解答.md
├── 问题B/
├── 问题C/
├── 论文/          # 最终论文:论文.tex + 论文.pdf
└── 参考资料/
  1. 在参赛文件夹里打开 AI Agent,说:"帮我做这道数学建模题" / "帮我写数模论文"。
  2. Agent 按 SKILL.md 流程工作:摸底 → 逐题建模求解 → 按写作规范主干写论文 → XeLaTeX 编译 → 交付 PDF。

📁 仓库结构

.
├── README.md                    # 本文件(人向说明)
├── LICENSE
└── skills/                      # 技能本体(自包含,官方 anthropics/skills 同款布局)
    └── cumcm-paper-hand-skill/
        ├── SKILL.md             # 技能入口:触发描述 + 三步工作流路由 + 红线约束
        ├── references/          # 按需加载的详细文档(渐进披露)
        │   ├── 论文写作规范.md  # 写作规范主干(骨架/每问闭环/摘要/文献/附录)
        │   ├── 检查清单.md      # 交付前逐项核对清单
        │   └── 建模流程.md      # 完整建模闭环(仅用户要求重做时加载)
        ├── templates/           # 模板
        │   ├── 论文模板.tex     # 论文唯一模板(XeLaTeX,交付 .tex + PDF)
        │   ├── 论文模板.pdf     # 模板编译预览(无 TeX 也能看效果)
        │   ├── 建模笔记模板.md  # 每题建模笔记模板
        │   ├── 目录结构模板.md  # 参赛文件夹结构模板
        │   └── README.md
        ├── ref/                 # 获奖优秀论文(原 PDF + OCR 可读版,含选篇说明)
        └── scripts/
            └── ocr_pdfs.py      # 图片型 PDF → Markdown 可读版(添加新参考论文用)

✍️ 论文写作规范(主干)

📖 参考论文怎么用

ref/ 的获奖论文是图片型 PDF(无文字层),每篇都附带 OCR 生成的 *.md 可读版。Agent 写作时:学习其摘要写法、章节结构、图表设计,只学不抄。选篇逻辑(三种题型覆盖 + 同题双篇对照)与逐篇学习点见 ref/README.md。添加自己的论文:运行 ocr_pdfs.py。

🛠️ 自定义与扩展(这个 skill 是你的,随便改)

整个 skill 就是一组文件,改文件即改行为,无需改任何逻辑,改完立即生效:

想改什么 改哪里 说明
参考论文 ref/ 把自己的获奖论文放进去——图片型 PDF(无文字层)先跑 scripts/ocr_pdfs.py 生成可读版,并同步更新 ref/README.md 的选篇说明,Agent 就会参考它们
写作规范 references/论文写作规范.md 主干文档,增删任何写作要求(骨架、摘要句式、文献规则…),全 skill 生效
论文模板 templates/论文模板.tex 页面设置、章节结构、封面、样式,Agent 会按你的模板写作
目录结构 templates/目录结构模板.md 参赛文件夹的推荐结构,Agent 按它组织工作
建模笔记模板 templates/建模笔记模板.md 每道题笔记的格式
交付检查清单 references/检查清单.md 写完后核对哪些项,随你增删
工具脚本 scripts/ 可添加自己的脚本(如数据预处理、图表生成),并在 SKILL.md 里说明何时调用

三个例子:

⚠️ 说明

📄 License

MIT

cumcm-paper-hand-skill (Mr-potato-123/cumcm-paper-hand-skill)

Searching Database…

212 ·GitHub
Cumcm-paper-hand-skill
这是什么？一个 Agent Skill，在你的竞赛文件夹里与 AI 代理（如 Claude Code）协作，帮助用 LaTeX 撰写全国大学生数学建模竞赛（CUMCM）论文，交付编译好的 论文.tex 和 PDF。
它是建模工具，还是只是写作助手？它被明确定位为仅仅是“论文写手”：它根据你已有的建模笔记、代码和结果起草论文，除非你明确要求，否则不会重新建模或求解。
除了技能本身，我还需要什么？你需要一个支持 Skills 的 AI 代理（如 Claude Code），以及一套可用的 XeLaTeX 工具链，因为论文必须零错误地编译成 PDF。
如果我的建模笔记不完整，它会替我补上缺口吗？如果素材缺失，代理会先问你；只有经你同意，它才会做额外的求解（并在交付摘要中注明“新增求解：……”），而且只有你明确要求时，它才会执行完整的重新建模流程。
它收录了哪些参考论文？它在 ref/ 里打包了 OCR 可读的 CUMCM 获奖论文，有意覆盖三大题型（A 优化、B 物理、C 数据），并为 B 和 C 配备同题不同解法的成对样例，让代理能学习结构和措辞而不抄袭内容。
它是为哪些竞赛打造的？它面向中国的 CUMCM（全国大学生数学建模竞赛），README 也注明适用于美国的 MCM/ICM 竞赛。
我能为自己的团队调整模板或写作规则吗？可以——一切皆文件：编辑 references/论文写作规范.md 来修改写作规则，把 templates/论文模板.tex 换成其他竞赛的模板，或把你自己的脚本放进 scripts/ 并在 SKILL.md 里加注说明。
What are similar projects?PaperSpine, codex-claude-academic-skills, Evidence-Bound-Press-Conference-Revision-Skill, cumcm-step-review, lieflat-gongwen, nature-skills, Humanizer-zh, sun-style-writing
Which topics is it in?academic-writing, tex, templates, writing, ocr, agent-skill, document-processing, claude-skills, workflow, academic-research, skill, china
Creator
Mr-potato-123
Size
17.4 MB
Stars
212
Updated
CommitAug 18
Age
2mo
Commits · 90 Days