Stata Graphics Skill

stata-graphics-skill

为 AI 编程助手（Claude Code、Codex 等）构建的 Stata graphics 可信参考手册，尤其适合经济学实证研究场景。

A trusted Stata graphics reference manual for AI coding assistants (Claude Code, Codex, etc.), especially for empirical economics research.

---

中文

修改历史

**2026-04-20**：本次更新重点清理公开版说明和模板一致性：

• 统一 SKILL.md 与 graph-templates.md 的 scheme-first 配色原则，默认让 Stata scheme 管理颜色。
• 删除多数模板中的硬编码颜色，只在重叠直方图等确实需要组间区分的场景保留显式透明颜色。
• 修正 event-study coefplot 模板中基准线位置：从 xline(2.5) 改为 xline(4.5)。
• 完善 rcap 提示，强调 rcap 使用两个置信区间端点和一个 x 变量，不应把点估计误放进端点位置。
• 说明 ~/.claude/ 只是 Claude Code 示例路径；其他 AI 助手可用自己的配置目录并保持同样文件结构。
• 将 /learn 表述为模板学习机制的一种实现方式，其他 AI 助手也可按同样流程从真实代码中提炼新模板。

完整记录见 [`CHANGELOG.md`](CHANGELOG.md)。

这是什么？

当你让 AI 编程助手写 Stata 画图代码时，理想状态不是让它凭训练记忆临场拼代码，而是先查阅一组结构化、经过整理的 Stata graphics 参考资料，再根据具体项目调整。

这个项目的重点不是替 AI 兜底，而是给 AI 一个可靠的信息源。它把常用、易混、需要反复查阅的 Stata 图形语法、选项和模板整理成 Markdown 文件，方便 AI 助手在生成代码前读取。

**没有 skill 时：** AI 主要依赖训练记忆和临场推断。

**有 skill 后：** AI 先查阅参考手册，再结合用户数据、模型设定和项目风格写代码。

覆盖范围

**估计结果可视化**（最高优先级，也是最需要结构化参考的场景）：

图类型	技术构成
Event study / 平行趋势检验图	rcap + scatter 叠加，自定义 x 轴标签，参考线
系数图（单模型 / 多模型对比）	coefplot 或手工 rcap + scatter
异质性分析图（多 panel）	横向系数图，分组标签，graph combine 拼合
边际效应图	margins + marginsplot 或手工提取后画图
Permutation / placebo test 图	双 y 轴，kernel density + p-value scatter 叠加
DiD 动态效应图	csdid_plot 或手工 event plot

**描述性与数据可视化**（按需补充）：趋势折线图、分布图、散点图、分组柱状图、箱线图。

三层架构

第一层 — 现有 stata skill（dylantmoore/stata-skill）
  知道怎么跑回归，知道 reghdfe、csdid 等命令的 e() 结构

第二层 — estimation-to-graph.md（桥梁文件）
  知道如何把存储结果转化为可画图的数据格式

第二层b — graph-templates.md（即用代码模板）
  各类图形的完整即用代码模板（event study、coefplot、
  csdid_plot、margins 等）；通过 /learn 从实际论文中持续扩充

第三层 — stata-graphics skill（本项目）
  知道图的样式细节：marker、颜色、坐标轴、scheme、CI 画法、导出

三层缺任何一层都有短板。

前置条件

**1. 安装 [dylantmoore/stata-skill](https://github.com/dylantmoore/stata-skill)**

# 克隆仓库
git clone https://github.com/dylantmoore/stata-skill.