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