Review Model

review-model — 综合模型评议

触发场景

• "看看这个模型对不对"、"做一轮评议"、"reviewer 走一遍"
• 完成 spec.md 后正式进入校准 / 求解前
• 投稿前的最后审查
• 中期 / 结项把项目"打包前"

输入契约

步骤清单

Step 1. 自检清单（轻量）

读 spec.md、equations.tex、calibration.csv，对下列问题给"是 / 否 / 不确定"：

• 研究问题用一句话能否清晰说明？
• 内生变量数 = 方程数？
• 每个参数都有 source 字段非空？
• 每个外生冲击都进入至少一条方程？
• spec.md §9.3 IRF 形状先验是否填实？
• 是否有解析稳态或数值稳态求解策略？
• 求解方法（摄动 / VFI / SSJ / GAMS）与模型类匹配？
• 时点约定（k_t 期初 / 期末）一致？

任一"否"或"不确定" → 进入 Step 2 详细评议。

Step 2. 分派子 agent（thorough 模式）

按职责分派：

每个子 agent 独立写报告到 quality_reports/<model>_<reviewer>_<timestamp>.md。

Step 3. 汇总

把所有子 agent 报告的"综合"行汇总到 quality_reports/<model>_review_summary_<timestamp>.md：

# 综合评议汇总 · <model> · <timestamp>

| 维度 | 子 agent 判断 | 报告 |
|---|---|---|
| 经济机制 | 通过 | quality_reports/<model>_model_review_<ts>.md |
| 数学 | 修改后通过 | quality_reports/<model>_math_review_<ts>.md |
| 数值方法 | 通过 | quality_reports/<model>_numerics_review_<ts>.md |
| 代码 | 通过 | quality_reports/<model>_code_review_<ts>.md |
| 教学 | 修改后通过 | quality_reports/<model>_pedagogy_review_<ts>.md |

## 必改清单（合并去重）
- [ ] ...
- [ ] ...

## 建议进度门
- 进入校准 / 求解：✅ / ❌（修改后）
- 进入对外报告：⏸️（依赖 verifier）

Step 4. 决策门

• 全部"通过"或"修改后通过且必改项已 tick" → 允许进入下一阶段（校准 → 求解 → 仿真）
• 任一"不通过" → 阻断流水线，必须先修

输出契约

quick 模式可只产汇总，不调子 agent。

不允许的操作

• 在 thorough 模式下跳过任一子 agent
• 在某子 agent 给出"不通过"的状态下放行进入求解
• 把 review-model 当成 model-reviewer 的同义词（前者是分派器，后者是经济逻辑专家）
• 在没有 spec.md 的情况下声称"评议通过"

失败回退