跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

Mathmodel Skill

数学建模竞赛(CUMCM/MCM/电工杯)的Agent工作流,支持Claude Code和Codex CLI,提供10阶段流程、决策日志和可恢复协作。

handsomeZR-netizen · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add handsomeZR-netizen/mathmodel-skill

技能说明


name: mathmodel-skill description: CUMCM 国赛、MCM/ICM 美赛与电工杯数学建模竞赛的端到端协作工作流。Use when a user explicitly works on one of these modeling contests or asks to run/review a modeling-competition paper from problem selection through modeling, solving, robustness, writing, compliance, and final submission review. Provides 10 stages, persistent decision state, competition-specific rules/templates, deterministic scoring helpers, numbered decisions, and Codex/Claude Code handoff. Do not trigger for generic model selection, ordinary data analysis, or non-competition paper review.

mathmodel-skill — 数学建模三竞赛工作流 (v6.1)

10 阶段把 72–96 小时的竞赛协作变成可恢复、可检查的流程。用户回答关键问题,agent 维护状态与脚本。每阶段产出经过 rubric 自评、定向精修与跨阶段一致性回检;Stage 8–9 先遵守当届官方规则,再做多视角终审。CUMCM 包含 91 份来源文档,其中 59 份进入文本统计;MCM/电工杯经验统计明确为 n=0,不提供合成分位。

v6.1 更新: 加入竞赛规则基线与 AI 使用披露链路;三竞赛统一使用 marker 模板并对提交元数据 fail closed;修复状态路径错位、评分 verdict 持久化、题型权重合并和 YAML frontmatter 等问题;新增 preflight doctor 与自动化验证。


Codex 原生入口

Codex 优先按 skill 目录发现本文件:

  • 用户级安装: $HOME/.agents/skills/mathmodel-skill/
  • 项目级安装: <repo>/.agents/skills/mathmodel-skill/
  • UI 元数据: agents/openai.yaml
  • 插件分发元数据: .codex-plugin/plugin.json + skills/mathmodel-skill/SKILL.md shim
  • 项目指导: AGENTS.md 仍可作为 repo / workspace 级 instructions, 但不是唯一入口

当 skill 已安装后, 用户可直接说"开始建模"或显式说"使用 $mathmodel-skill 开始建模"。


Harness 兼容 (Claude Code / Codex)

本 skill v6.1 以 Codex Skills 为一等入口, 同时保持 harness-agnostic 设计:

harness入口文件用户交互工具状态文件
Claude CodeSKILL.md (本文件)AskUserQuestion 工具<cwd>/state/decision_log.json
Codex CLI / Codex appskill 目录中的 SKILL.md + 可选 AGENTS.mdmarkdown 编号列表同上 (互通)

跨 harness 互通: day 1 用 Codex 跑 stage 0-2, day 2 切回 Claude Code 接着 stage 3+, 状态完全保留。详见 references/harness_compat.md。


问答式优先 (Friendly Mode)

核心原则: 用户只需回答编号问题, 不应被要求手敲 bash / python / json。

  • 离散选项 (选竞赛 / 选题 / 选模型 / verdict 决策) → 必须用问答式
  • 自由文本 (PDF 路径 / 截止时间) → 单行回复
  • 状态读写 (decision_log.json) → agent 自动完成
  • 每个 stage 的关键决策点都有 "让我决定 (推荐 X)" 兜底选项

优先使用当前 harness 可用的原生选择 UI;没有时回退到 markdown 编号列表。两者语义等价,见 references/harness_compat.md §1。


路径解析协议 (任何阶段必读)

类型位置例
skill 内通用skill 根目录的相对路径references/stage_05_subproblem_loop.md, templates/shared/decision_log.json
竞赛特化competitions/<comp>/... 按 decision_log.competition dispatchcompetitions/cumcm/winning_patterns.md, competitions/mcm/abstract_template.md
LaTeX 模板templates/latex/<comp>/main.textemplates/latex/cumcm/main.tex, templates/latex/mcm/main.tex
用户产物用户工作目录的相对路径<cwd>/state/, <cwd>/results/, <cwd>/figures/, <cwd>/paper_workspace/
state 持久化<cwd>/state/decision_log.json各 stage 必读必写
环境变量MATHMODEL_STATE_DIR (兼容 CUMCM_STATE_DIR) / MATHMODEL_COMPETITION 可覆盖scripts 用此变量

约定: <skill>/ = skill 安装目录, <cwd>/ = 用户 cwd, <comp>/ = 当前竞赛 (cumcm | mcm | diangong)。


Quick Start (用户首次说"开始建模")

1. 一段话介绍 (≤50 字): "启动数学建模工作流, 10 阶段 + 三竞赛, 全程问答式."

2. 收集下列 5 个启动字段;用户已经提供或 state 已记录的字段不再询问,只把尚缺字段合并成一轮问答 (Claude Code: AskUserQuestion; Codex: 编号列表):
   - 竞赛 (cumcm 国赛 / mcm 美赛 / diangong 电工杯, 默认 cumcm)
   - 题号 (依竞赛: cumcm A-E / mcm A-F / diangong A-B; "未公布"亦可)
   - 队员数 + 各人擅长 (建模/编程/写作)
   - 截止时间 (ISO 字符串或 "距现在 X 小时")
   - 题目 PDF 路径 ("未公布"亦可)

3. 自动初始化 (agent 自动完成, 不要让用户编辑 json):
   - 不存在 `<cwd>/state/decision_log.json` → 创建目录并复制 `<skill>/templates/shared/decision_log.json` 到该路径
   - 写入 decision_log.competition = <选定竞赛>
   - 已存在 → 读 current_stage 字段决定恢复点

4. 加载 `competitions/<comp>/current_rules.md`(若存在),打开其中官方链接核对当届规则并写入 compliance;再按需加载 winning patterns

5. 进入 Stage 0 (`references/stage_00_kickoff.md`), 不重复问已知字段;若题面未公布,完成环境与协作准备后保持 `qi_count=null` 并等待题面,不进入 Stage 1

已有 state 触发 (用户中途回到 skill):

1. 读 `<cwd>/state/decision_log.json` 的 competition 与 current_stage
2. 加载对应 stage_NN.md (按需结合 competitions/<comp>/* 内容)
3. 不重复读 winning_patterns

三竞赛 × 三模式 矩阵

时长 / 语言 / 模板 / 数据状态 由 competition 决定; token 预算 / 反馈深度由 mode 决定。两者正交组合。

Competition时长语言LaTeX规则基线经验数据状态
cumcm72h中文xelatex / 原创 ctexartCUMCM 202691 来源文档 / 59 可提取样本
mcm96hEnglishpdflatex / articleCOMAP 2027n=0,无论文分位
diangong72h中文xelatex / ctex官网 2026-03-21 页面n=0,无论文分位
Mode上下文策略反馈层用途
fast只保留当前阻断项与最小证据L1 单次选题试跑 / sanity check
standard按阶段加载并保留决策摘要L1+L2默认主流程
championship在终审阶段扩展证据与独立视角L1+L2+L3+L4 + red-team提交前最后冲刺

模式自动推荐 (按距 deadline 剩余):

  • 60h: standard (最后 6h 升 championship)

  • 24-60h: standard
  • 6-24h: fast 关键阶段 + championship 终审
  • < 6h: 直接进 stage 9 (championship)

10 阶段索引

#阶段reference时长反馈竞赛差异点
0团队启动 + 资料预扫stage_00_kickoff.md1hL1时长 / 语言 / 编译器 / 题号体系
1选题 (多题对比 → 1)stage_01_problem_selection.md2-4hL1题号体系 (A-E/A-F/A-B) + task_type 写入
2问题深度解析与分解stage_02_analysis.md2-3hL1通用
3模型选型 (证据驱动的候选比较)stage_03_model_selection.md2-4hL1 + 反事实通用
4Foundation (假设+符号+术语)stage_04_foundation.md1hL1通用
5递归子问题循环 Q1..Qn + per-Qi 加权聚合stage_05_subproblem_loop.md按题目分配L1 + 子检查点从题面提取实际子问数;per-Qi 加权
6全局灵敏度 / 稳健性stage_06_robustness.md2-3hL1 + L2工程参数 (diangong) vs 数学参数 (cumcm/mcm)
7模型评价 + 推广stage_07_evaluation.md1-2hL1通用
8论文写作 + 合规装配stage_08_writing.md12-30hL1 + L2当届规则、AI 披露、摘要类型与 LaTeX 模板
9提交合规 + Panelstage_09_review.md2-6hL1 + L3 panel页数/匿名/披露 + anti-patterns + personas

加载协议 (节省 token 的关键)

只在进入阶段 N 时加载 references/stage_NN_*.md。切勿一次性全读。

各阶段额外加载 (按需 + 按 competition 切换):

  • 每阶段开头: <cwd>/state/decision_log.json 必读
  • 每阶段结尾: <cwd>/state/decision_log.json 必写 (核心决策 + 5 维评分)
  • stage 1-9: `references/rubrics.
阅读完整来源 ↗