stata-planlisted

# /stata-plan > 把 wiki 中的变量、数据和模型信息转成 Stata 层面的执行顺序。默认生成计划；只有用户传 `--write-do` 时才创建 `.do` 骨架。 ## Workflow ### Step 1: Read Design and Data Context 读取： - 指定的 `wiki/outputs/empirical-design-*.md`，或按 topic 匹配最近设计文档 - `wiki/variables/*.md` - `wiki/datasets/*.md` - `wiki/models/*.md` - `wiki/robustness/*.md` - `wiki/heterogeneity/*.md` - `wiki/identification/*.md`（设计涉及 DID / PSM / IV / RDD / TWFE 时优先读对应预置策略卡） - `tools/stata-templates/*.do`（预置模板：twfe / did_staggered / psm / iv_2sls / rdd；`--write-do` 时以匹配的模板为骨架起点，按设计文档改写变量与参数） - 项目中的 `.do`、`.dta`、`.xlsx`、变量字典和 README ### Step 2: Produce Stata Execution Plan 输出结构： ```markdown # Stata 执行计划 ## 1. 输入数据 ## 2. 主键与合并顺序 ## 3. 样本筛选 ## 4. 变量构造 ## 5. 缩尾与缺失值处理 ## 6. 描述性统计 ## 7. 相关性分析 ## 8. 基准回归 ## 9. 机制检验 ## 10. 异质性检验 ## 11. 稳健性检验 ## 12. 表格导出 ## 13. 复核清单 ``` 每一步尽量写成 Stata 伪代码或代码块，但不要假造不存在的变量名。变量名不确定时用占位符并标记“需确认”。 ### Step 3: Optional Do File 只有用户传 `--write-do` 时，创建： ```text wiki/outputs/stata-plan-{slug}-{YYYY-MM-DD}.do ``` 默认只写： ```text wiki/outputs/stata-plan-{slug}-{YYYY-MM-DD}.md ``` ### Step 4: Log ```bash python3 tools/research_wiki.py log wiki "stata-plan | <topic> | output: outputs/<file>" ``` ## Constraints - 不覆盖用户已有 `.do` 文件。 - 不假设 Stata 包已经安装；需要 `reghdfe`、`esttab` 等时在计划里列出安装命令。 - 代码骨架必须保留复核点，如样本量检查、merge 结果检查、变量分布检查。 - 对中文路径和空格路径使用引号。