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
What is this?An Agent Skill that works with an AI agent (such as Claude Code) inside your contest folder to help write up a CUMCM (China Undergraduate Mathematical Contest in Modeling) paper in LaTeX, delivering a compiled 论文.tex plus PDF.
Is this a modeling tool or just a writing helper?It is explicitly positioned as a 'paper writer' only: it drafts the paper from the modeling notes, code and results you already have, and will not redo the modeling or solving unless you explicitly tell it to.
What do I need besides the skill itself?You need an AI agent that supports Skills (such as Claude Code) plus a working XeLaTeX toolchain, since the paper must compile with zero errors into a PDF.
Will it fill in gaps if my modeling notes are incomplete?If material is missing, the agent asks you first; only with your consent will it do extra solving (noting 'newly added solving: ...' in the delivery summary), and it only runs a full re-modeling pass if you explicitly ask for one.
What reference papers does it include?It bundles OCR-readable versions of award-winning CUMCM papers in ref/, deliberately covering the three main problem types (A optimization, B physics, C data) with same-problem/different-method pairs for B and C, so the agent can study structure and phrasing without copying content.
Which contests is this built for?It targets China's CUMCM (National Undergraduate Mathematical Contest in Modeling) and the README also notes applicability to the US MCM/ICM contest.
Can I adapt the templates or writing rules to my own team?Yes — everything is just files: edit references/论文写作规范.md for different writing rules, swap templates/论文模板.tex for another contest's template, or drop your own scripts into scripts/ with a note in 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