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) внутри папки вашего состязания, чтобы помочь оформить работу CUMCM (Китайского студенческого конкурса по математическому моделированию) в LaTeX, выдавая скомпилированные 论文.tex плюс PDF.
Это инструмент моделирования или просто помощник по написанию?Он явно позиционируется только как «писатель работы»: он составляет работу из заметок по моделированию, кода и результатов, которые у вас уже есть, и не будет заново делать моделирование или решение, если вы прямо его об этом не попросите.
Что нужно, кроме самого навыка?Нужен AI-агент с поддержкой Skills (например, Claude Code) плюс работающая цепочка XeLaTeX, поскольку работа должна компилироваться в PDF без единой ошибки.
Заполнит ли он пробелы, если мои заметки по моделированию неполны?Если материала не хватает, агент сначала спрашивает вас; только с вашего согласия он выполнит дополнительное решение (отметив 'newly added solving: ...' в итоговой сводке), а полный проход перемоделирования запускает лишь по явной вашей просьбе.
Какие референсные работы он включает?Он включает OCR-читаемые версии отмеченных наградами работ CUMCM в ref/, сознательно покрывая три основных типа задач (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