Skip to content

XiaoMaColtAI/math-modeling-skill

math-modeling

Verified

当用户要求数学建模、建模竞赛、建模分析、代码求解、结果可视化或生成数学建模论文时使用。支持完整三阶段流程、单独执行任一角色,以及在关键节点使用独立 Subagent 进行阶段内质检;默认只启用质检 Subagent,用户可明确选择额外协作。

references/Subagent调度.md

View on GitHub
# Subagent 调度与阶段门禁

Subagent 是阶段内临时协作者,不是第四个固定角色。主 Agent 负责统筹、写入权威产物和处理返工;质检 Subagent 必须未参与被审产物的编写,并默认只读。

## 默认策略

1. 默认仅派发下表中的固定质检 Subagent;调研、原型和并行实验等可选协作默认关闭。
2. 只有用户明确启用具体任务或类别时才派发可选 Subagent。用户未选择时不要反复询问,也不要暂停主流程等待授权。
3. 用户可随时增加、缩小或关闭可选协作范围;未明确启用的类别始终保持关闭。
4. 可选 Subagent 只返回范围、输入、证据或实验产物、结论、未知项和建议,不直接修改权威交付物;主 Agent 负责取舍和整合。

示例:`额外启用官方规则、附件盘点和文献调研 Subagent`、`只启用算法原型 Subagent`、`除固定质检外不使用其他 Subagent`。

## 强制原则

1. 禁止等全流程结束后才首次派发质检 Subagent;在下表规定的节点立即验收,未通过不得进入后续高成本工作。
2. 作者自检、脚本校验和独立验收三者不能互相替代。已有脚本负责机械检查,Subagent 负责独立复现、语义和证据审查。
3. 质检 Subagent 不直接修改固定交付物,只返回带证据的问题;原阶段执行者修正后,由未参与修正的质检 Subagent 复验。
4. 被验收的输入、模型、代码、结果或论文发生实质变化时,相关 `PASS` 立即失效。
5. 单阶段任务只运行该阶段的门禁,不强制拉起完整三阶段。
6. 运行环境没有 Subagent 能力时,继续运行确定性脚本并明确报告“独立验收未完成”,最终状态只能是 `BLOCKED` 或受限交付;不得声称全部门禁通过或完整完成。

## 固定门禁

| 门禁 | 派发时机 | 质检重点 | 通过后才能 |
|---|---|---|---|
| `M1` 建模终检 | 两个建模产物完成作者自检后 | 子问题覆盖、假设依据、公式与符号、符号数学排版、单位与约束、模型数量、可实现性、验证方案、文献可追溯性 | 进入编程或交付建模产物 |
| `P1` 最小可运行结果 | 数据读取、预处理和核心求解链首次跑通后 | 从 `PROJECT_ROOT` 执行最小命令;核对真实输入或等价小实例、退出码、关键结果、单位、范围、约束和模型合同 | 开始全量计算、正式出图和参数扫描 |
| `P2` 编程终检 | 代码、结果表、三类每类至少 3 张且覆盖全部子问题的候选图和复现清单冻结后 | 独立复现、输入哈希、随机种子、关键数值、边界与量纲、各子问题图表数量与语义、建模流程图真实性与覆盖、复现清单和文件完整性 | 进入论文阶段或交付编程产物 |
| `W1` 证据大纲 | 主张—证据映射和论文大纲完成后 | 每个子问题的结论都有公式、结果表位置、图文件、代码输出或已核验文献;符号说明表、附录计划、完整代码要求和总体建模流程图完整;用户显式要求 LaTeX 时两种格式共用同一证据源 | 开始长篇正文和排版 |
| `W2` 论文终检 | 用户要求的全部论文格式内容冻结且各自确定性门禁完成后 | 当届规则、主张—证据、数值与单位、符号数学排版、附录边界与引用、要求附完整代码时的源码完整性和可运行性、总体建模流程图真实性与入文、其他图表引用、文献、Markdown 格式残留、支撑材料完整性和实际渲染;同时生成两种格式时再检查 Word/LaTeX 一致性 | 按用户要求交付 Word(`完整论文.docx`)或 LaTeX/PDF(`完整论文-LaTeX/` 与 `完整论文.pdf`);真实竞赛仍须提醒用户上传并确认成功 |

`P1` 是纵向切片,不要求三类图、完整敏感性分析或最终性能。`W1` 是内部检查,不新增固定交付物。每个阶段可由同一名始终未参与编写和修正的质检 Subagent 连续执行中途门禁与终检;不要为每个函数、每张图或每个段落重复派发。

## 派发输入

只提供完成当前验收所需的原始证据:

- 用户要求、题目和只读附件路径。
- 当前门禁的验收条款和权威产物路径。
- 输入文件版本或 SHA-256、官方规则来源、关键命令与日志。
- 上一门禁回执;复验时再提供原问题及修正证据。

不要先告诉质检 Subagent“主 Agent 认为已经正确”,也不要给出期望的通过结论。质检范围外的历史对话不传入,避免结论污染。

## 固定回执

质检 Subagent 只返回:

1. `范围`:本次检查的门禁和未覆盖内容。
2. `输入快照`:路径、版本或 SHA-256。
3. `状态`:`PASS`、`FAIL` 或 `BLOCKED`。
4. `证据`:来源 URL、命令、退出码、文件位置、页码或关键数值。
5. `发现`:按 `P0`(正确性/官方硬约束)、`P1`(复现/一致性/关键质量)、`P2`(非阻塞改进)列出。
6. `返工`:应回到的角色、必须修正项和复验入口。

存在未解决的 `P0` 或 `P1` 时只能返回 `FAIL`;缺少依赖、权限、输入或可验证证据时返回 `BLOCKED`。主 Agent 不得把 `FAIL` 改写成通过。

## 用户可选协作(默认关闭)

| 任务 | 触发条件 | Subagent 输出 | 并行与边界 |
|---|---|---|---|
| 当届官方规则核验 | 竞赛、届次或模板尚未核验 | 官方 URL、适用届次、硬约束、模板路径与哈希、冲突和未知项 | 可与附件盘点并行;论文构建必须等待 |
| 数据附件盘点 | 多附件、复杂 PDF/Excel 或字段较多 | 文件哈希、工作表、行列、首末行、字段、单位、缺失和异常 | 只读;模型选择须等待关键数据事实 |
| 文献与模型族调研 | 主张、关键词或候选模型族已经明确 | 题名、作者、年份、DOI/出版页、理论公式、适用条件、所需数据和失败风险 | 按主张簇或模型族拆分;不要按搜索引擎拆分,最终模型取舍仍由主 Agent 完成 |
| 隔离算法原型 | 某个候选算法的可实现性、接口或复杂度需要验证 | 独立目录中的最小代码、运行命令、真实输出、限制和未解决问题 | 不修改权威代码;原型通过后由主 Agent 决定是否整合 |
| 独立实验批次 | 模型、指标和参数范围已经冻结,实验之间互不依赖 | 参数、种子、命令、结果文件、耗时和失败记录 | 可并行敏感性、消融或边界实验;不得边改模型边跑实验 |
| Python/MATLAB 对照实现 | 用户明确要求双语言或需要验证跨语言一致性 | 各自隔离的实现、命令、环境、关键数值和差异 | 使用同一模型合同和输入输出;主 Agent 统一权威结果 |
| 术语与英文表达核验 | 专业领域术语较多或生成 MCM/ICM 英文论文 | 术语对照、符号与单位冲突、建议修改位置和来源 | 只提供建议,不分章节并写论文 |

## 不委派或不并行

- 不让多个 Agent 同时修改 `题目分析报告.md`、`术语表格.md`、权威代码、结果或论文正文。
- 不按章节多人并写论文,不分别生成互不共享正文的 Word 与 LaTeX。
- 不把模型取舍、假设与阈值裁决、跨题耦合、用户授权和最终交付范围交给任何 Subagent。
- 依赖检查、哈希、编译、DPI、SVG 文本和文档结构等已有脚本覆盖的机械任务直接运行脚本,不再增加 Subagent。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall