Strucmod

strucmod — 结构建模与动态模拟工作流父技能

本技能是 structural-modeling-for-economists 工作流的总入口。任何涉及结构经济模型构建、求解、仿真、反事实、表达的任务，agent 都应先读本文件，依据任务关键字与产物形态，分派到下方原子技能。

触发关键字

中文：DSGE、动态随机一般均衡、CGE、可计算一般均衡、GTAP、异质主体、Aiyagari、Bewley、Krusell-Smith、动态规划、值函数迭代、政策函数、稳态、脉冲响应、反事实、过渡路径、校准、矩匹配、福利分析、摄动、投影、sequence-space。

English: DSGE, CGE, GTAP, heterogeneous-agent, Aiyagari, Bewley, dynamic programming, value function iteration, policy function, steady state, IRF, impulse response, counterfactual, transition path, calibration, moment matching, welfare, perturbation, projection, sequence-space.

任务分类与分派

原子技能清单

A. 设定（Setup）

• setup-dsge — DSGE 设定与 Dynare/Julia 脚手架
• setup-cge-gtap — CGE / GTAP 设定与 GAMS 脚手架
• setup-ha-bewley — 异质主体（Aiyagari/Bewley/Krusell-Smith）

B. 校准（Calibrate）

• calibrate-from-moments — 从数据 / 文献 / 矩条件组装校准

C. 求解（Solve）

• solve-perturbation — 一/二/三阶摄动
• solve-vfi — 值函数迭代 / 策略迭代 / 投影

D. 仿真与反事实（Simulate）

• simulate-irf — 脉冲响应函数
• counterfactual-run — 反事实 / 过渡路径 / 政策实验

E. 验证（Validate）

• validate-steady-state — 数值化稳态校验（必经环节）

F. 执行（Run）

• run-dynare
• run-julia
• run-matlab
• run-pipeline — 端到端

G. 表达（Express）

• build-tables — 校准表 / 矩比对表 / IRF 表
• render-report — Quarto / LaTeX 报告

H. 复现（Reproduce）

• replicate — 用保存的种子与设定重跑

I. 评议（Review）

• review-model — 经济逻辑与机制评议
• devils-advocate — 反方拷问

J. 学术辅助（Academic）

• lit-review
• proofread
• interview-me — 让 agent 反向访谈研究生以厘清机制

K. 工程（Engineering）

• commit

入口决策树

用户请求
  │
  ├─ 提到具体模型类（DSGE/CGE/HA/DP）但未写 spec.md？
  │     → setup-<class>
  │
  ├─ spec.md 已存在但未通过 model-reviewer？
  │     → 调用 model-reviewer 子 agent
  │
  ├─ 已通过 review，要校准参数？
  │     → calibrate-from-moments
  │
  ├─ 校准完毕，要求解？
  │     → solve-<method>（先 validate-steady-state）
  │
  ├─ 求解完毕，要看冲击 / 反事实？
  │     → simulate-irf 或 counterfactual-run
  │
  ├─ 要写论文 / 报告？
  │     → build-tables + render-report
  │
  └─ 想复现历史？
        → replicate

必经检查点（Mandatory Checkpoints）

无论从哪个 skill 入手，下列 checkpoint 不可绕过：

1. 设定评审：任何模型代码动手前，model-reviewer 必须批准 spec.md。
2. 维度检查：方程系统首次落入代码前，math-reviewer 必须确认方程数 = 未知数、变量分类无矛盾、单位一致。
3. 稳态校验：validate-steady-state 残差必须低于 tol = 1e-8（默认）方可进入仿真。
4. 复现核对：任何对外报告的数字，必须由 verifier 重跑一次并核对。

输入 / 输出契约

每个原子技能都遵循统一契约：

输入：

• model_name：字符串，对应 model/01_setup/<model_name>/
• language：dynare / julia / matlab / gams / python
• task_payload：依技能而定（见各技能 SKILL.md）
• seed：整数（默认从 model/_utils/seed.txt 读取）

输出：

• 产物文件落入 output/<subdir>/
• 日志写入 logs/<model>_<step>_<timestamp>.log
• 检查点写入 output/checkpoints/<model>_<artifact>.json
• 在 templates/session-log.md 副本中追加一行运行记录

常见失败与回退

详见 AGENTS.md 中的"失败回退"表。