cumcm-paper-hand-skill

Скилл для оформления статьи по математическому моделированию: LaTeX-шаблон, правила письма и пять разобранных работ-победителей

  • 214 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Агент создает и перезаписывает файлы в папке участника и запускает компиляцию LaTeX, поэтому исходные материалы стоит держать под версиями или в копии
Все причины и проверки

mr-potato-123/cumcm-paper-hand-skill

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/cumcm-paper-hand-skill

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Агент создает и перезаписывает файлы в папке участника и запускает компиляцию LaTeX, поэтому исходные материалы стоит держать под версиями или в копии

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл ведет агента по папке участника китайского конкурса математического моделирования CUMCM или американского MCM/ICM и пишет по готовым материалам итоговую статью. Работа идет в три шага: осмотр папки, проверка материалов по каждой задаче и написание текста. Готовое решение агент берет как есть и модель заново не строит. Если у задачи нет заметок или результатов, он сначала спрашивает участника. Статья собирается из `references/论文写作规范.md` и шаблона `templates/论文模板.tex`. Структура: аннотация, постановка, анализ задачи, допущения, обозначения, построение и решение модели, оценка и обобщение, литература, приложения. Каждую часть задачи замыкает цикл из анализа, модели, решения, разбора результата и вывода. Готовый файл компилируется XeLaTeX до нуля ошибок, на выходе `论文.tex` и `论文.pdf`. В каталоге `ref/` лежат пять работ-победителей конкурса в PDF и в распознанном виде. Они покрывают три типа задач: оптимизацию, физику и данные. Для типов B и C даны пары разных подходов к одной задаче. Все числа в статье должны сводиться к файлам в `结果/` или `代码/`, литературу агент проверяет поиском.

Для кого. Студентам, которые готовят работу для CUMCM или MCM/ICM: модель и расчеты у них уже есть, а оформление статьи нужно довести до правил конкурса.

Подходит, если

  • Решения по задачам лежат в папках, и из них надо собрать статью с аннотацией и приложениями
  • Нужен LaTeX-шаблон для конкурсной статьи, который компилируется XeLaTeX без ошибок
  • Хочется посмотреть, как строят аннотацию и главы в работах-победителях разных типов задач
  • Перед сдачей требуется пройти статью по чек-листу: ссылки на данные, литература, приложения
  • После китайской версии нужно сделать черновик на английском для MCM/ICM

Не подходит, если

  • Модели и расчетов еще нет: скилл пишет статью по готовым материалам, а полный цикл моделирования запускается только по прямой просьбе
  • Нужно объяснение алгоритма или общих математических понятий: скилл для такого вопроса отключает себя
  • Требуется другой скилл для моделирования, который вы уже выбрали
  • Для сдачи нужен документ в Word: итоговый формат здесь только LaTeX и PDF

Пример запроса к агенту

Помоги написать статью по моим решениям в этой папке: проверь материалы по задачам A и B и собери LaTeX-файл с PDF

Ограничения

  • Скилл, README и правила написаны по-китайски, статья по умолчанию тоже китайская. Для MCM/ICM китайский черновик сначала доводят до конца, затем переводят.
  • Для PDF нужен установленный TeX с XeLaTeX. Без него агент выдаст `论文.tex` без проверки компиляции.
  • Распознанный текст работ-победителей создан автоматически, в формулах и индексах бывают ошибки. За образец берите исходные PDF.
  • Честность содержания лежит на участнике: скилл дает правила письма, а не гарантирует корректность модели.

Как отключить. Удалите каталог `cumcm-paper-hand-skill` из `~/.claude/skills/` или из `.claude/skills/` проекта и начните новую сессию. В папке участника останутся только созданные файлы статьи в каталоге `论文/`.

Частые вопросы

Как установить cumcm-paper-hand-skill в Claude Code?

Склонируйте репозиторий и скопируйте вложенную папку: `cp -r cumcm-paper-hand-skill/skills/cumcm-paper-hand-skill ~/.claude/skills/`. Для одного проекта копируйте в `.claude/skills/`. Затем проверьте командой `/skills`, что скилл виден.

Как должна выглядеть папка участника?

Нужны каталоги `题目/` с условиями, `问题A/`, `问题B/` и так далее с `建模笔记.md`, `代码/` и `结果/`, а также `论文/` для результата. Образец дан в шаблоне `目录结构模板.md`.

Строит ли скилл модель вместо меня?

Нет, если материалы уже есть: он берет готовое решение. Если нужно заново построить модель, это придется сказать явно. Тогда агент пройдет полный цикл из `建模流程.md`.

Подойдет ли скилл для конкурса MCM/ICM?

Да, он заявлен для американского конкурса. Порядок такой: сначала китайская версия статьи, затем перевод на английский. Английского шаблона в проекте нет, его добавляют в правила или в `论文模板.tex`.

Можно ли добавить свои работы-победители?

Да. Положите PDF в `ref/`, для сканов без текстового слоя запустите `scripts/ocr_pdfs.py` и обновите `ref/README.md`. Агент начнет использовать их как образцы структуры и оформления.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл разбирает работу для конкурса CUMCM по условию, считает оценки по пяти измерениям и неофициально прогнозирует награду.

СкиллМинимальный доступ104Звезды репозитория

Meta-model-agent проводит задачу по математическому моделированию через семь этапов: данные, модель, расчеты, графики и статья.

СкиллМинимальный доступ112Звезды репозитория

Набор из восьми скиллов для научных статей в LaTeX: от темы до PDF с проверенными ссылками BibTeX и поэтапным контролем

СкиллРасширенный доступ275Звезды репозитория

Скилл Claude Code для научных статей: пять этапов от опроса автора до сжатия, правила разделов и независимая проверка.

СкиллМинимальный доступ249Звезды репозитория

Скилл с 30 шаблонами промптов для научных статей на английском и китайском: от обзора литературы до заявки на грант

СкиллМинимальный доступ553Звезды репозитория

Скилл пишет черновик ML-статьи по образцу лучших работ CVPR, ICCV и NeurIPS и рисует к ней схемы и рисунки.

СкиллМинимальный доступ359Звезды репозитория

Коротко о README

Страница описывает назначение скилла, установку копированием папки и рабочую папку участника. Далее перечислены структура репозитория, правила письма статьи, порядок работы с работами-победителями и таблица мест, где скилл можно менять под себя.

Бейдж для README

Исходный SKILL.md

---
name: cumcm-paper-hand-skill
description: 数学建模竞赛(CUMCM 国赛 / MCM/ICM 美赛)建模分析与论文写作技能。在参赛者整理好的参赛文件夹(题目/、问题X/建模笔记.md、代码/、结果/)中完成建模、求解与论文撰写,最终以 LaTeX 交付(论文.tex + 编译 PDF)。Use when 用户提到"数学建模"、"建模比赛"、"数模论文"、"数学建模竞赛"、"建模分析"、"建模求解"、"写数模论文"、"帮我做这道建模题"、"帮我写论文"、"优秀论文参考"、"论文写作指导"或类似表述。
---

# 数学建模竞赛论文写作技能

在参赛文件夹内三步工作:**摸底 → 核对材料 → 写论文(LaTeX 交付)**。

## When to Use / When NOT to Use

- **Use when**:用户要在参赛文件夹中建模、求解或撰写数模论文,或要求参考获奖论文([ref/](ref/) 内置)学习论文写法。
- **NOT use when**:用户只需要算法概念解释或通用数学知识问答;用户明确指定使用其他建模 skill。

## 输入:参赛文件夹结构

参赛者把**原始题目、每题的建模和解答**分文件夹整理,结构见 [templates/目录结构模板.md](templates/目录结构模板.md);未整理时按该模板补齐或按现有文件归拢。要点:

- `题目/`:原始题目与附件,**只读,不得修改**;
- `问题X/建模笔记.md` + `代码/` + `结果/`:本题建模过程与产物,论文素材来源;
- `论文/`:输出 `论文.tex`、`论文.pdf`、附图。

## 工作流程

### Step 1 摸底

1. 读取 `README.md` 与文件夹结构,列出全部题目、数据、已有笔记。
2. 读取 `题目/` 原始题目,逐问标注:研究对象、已知条件、核心矛盾、每问任务。
3. 检查每题 `建模笔记.md`,缺失的先补齐。
4. 浏览 [ref/README.md](ref/README.md),选定与本题类型相近的 1–2 篇参考论文。

**出口标准**:题目逐问理解完毕,每题有笔记或补齐方案,参考论文已选定。

### Step 2 核对建模与求解材料

**已存在的建模/求解,不得重新建模或重新求解**——直接采用。逐题检查:

1. 有完整 `建模笔记.md` + `结果/` → 直接采用,进 Step 3。
2. 有代码与结果、笔记缺失 → 只补齐笔记(记录已有事实),进 Step 3。
3. 有笔记、无结果 → 向参赛者确认是否补求解;补完在交付说明注明"本次新增求解:…"。
4. 仅当**用户明确要求**重新建模/求解时,执行 [references/建模流程.md](references/建模流程.md) 的完整闭环。

**出口标准**:未做任何未经说明的建模/求解;下一问输入已明确。

### Step 3 撰写论文(LaTeX 交付)

Сообщить о проблеме