AER-Skills

面向 《美国经济评论》（AER）、AER: Insights 及 AEJ 系列期刊的 agent skill 栈。

简体中文 | English

面向 American Economic Review（AER）、AER: Insights 以及 AEJ 系列期刊的 agent skill 包：覆盖选题、写作、识别策略、表图规范、投稿、审稿回复的全流程。

本仓库是有立场的。它不是通用经济学写作工具箱，而是一套面向 top-5 经济学的 skill 栈：识别优先的实证、AEA 政策合规的复现包、Keith Head 风格的引言、AER 风格的 booktabs 表格、以及对编辑友好的 rebuttal 文体。

为什么需要单独的 AER skill 栈？

Top-5 经济学期刊的硬约束在生命科学类期刊中并不存在：

通用的 "scientific writing" skill（例如 Nature-Paper-Skills、nature-skills）通常覆盖不到这些约束。

快速上手

方式 A — Claude Code 插件（推荐）

# 添加 marketplace（一次性）
/plugin marketplace add https://github.com/brycewang-stanford/AER-Skills

# 安装插件
/plugin install aer-skills

# 重新加载
/reload-plugins

之后十个 skill 会全部自动可用。

方式 B — 脚本安装

git clone https://github.com/brycewang-stanford/AER-Skills.git
cd AER-Skills

# Claude Code（用户级）
python3 scripts/install_skills.py claude

# 或 Codex
python3 scripts/install_skills.py codex

安装脚本会复制完整 skill 目录。更新已有安装时加 --replace，正式复制前可用
--dry-run 预览计划中的复制操作。如果想用 skill 引用到的 templates/ 和
examples/ 资源，请保留这个 cloned repository。

第一个提示词

重启 agent 后：

用 aer-workflow 告诉我这篇稿子下一步该用哪个 skill。

更完整的安装说明见 docs/installation-claude.md
和 docs/installation-codex.md。

默认工作流

aer-topic-selection
    -> aer-identification
        -> aer-robustness
            -> aer-introduction
                -> aer-tables-figures
                    -> aer-replication
                        -> aer-submission
                            -> aer-rebuttal

核心默认假设：

• 识别先于写作 — 设计有问题，写得再漂亮也救不回来
• AER vs AER:Insights vs AEJ 是个选刊路由问题，要在写摘要之前先决定
• 复现包质量是论文的一部分，不是事后补的工作
• 审稿回复信永远针对修改后的稿件，绝不对着旧稿写

完整路线图见 docs/workflow-map.md。

全部 Skill

核心 — 全生命周期

可选 — 实现引擎

在下方手写模板之外，再多给你一个跑实证的选择。

代码模板

为三套常见的实证经济学技术栈提供即插即用、版本意识清晰的脚本。每套模板都包含一个
master 脚本、一个 Callaway-Sant'Anna DiD 示例、一张 AER 风格的 booktabs 回归表，
以及一个 README。

每套模板都强制：固定随机种子（20260101）、相对路径、包版本记录（或在技术栈支持时
精确 pin）、AER booktabs 表格风格、矢量格式图件。

无需手工复制文件即可生成新项目：

python3 scripts/scaffold_project.py stata /path/to/new-project
python3 scripts/scaffold_project.py r /path/to/new-project
python3 scripts/scaffold_project.py python /path/to/new-project
python3 scripts/scaffold_project.py skeleton /path/to/new-replication-package

# 或使用 Make
make scaffold-stata DEST=/path/to/new-project

可用 --dry-run 预览计划中的复制操作。脚手架会拒绝仓库内部路径、模板源目录等受保护
目标；请在本仓库之外创建论文项目。

校验

在把 skill 复制进 agent 配置或提交 PR 之前，先运行仓库检查：

make preflight
# 等价命令：python3 scripts/validate_repo.py

make preflight 还会对 staged 和 unstaged 的 git diff --check 做检查，
排查空白和补丁卫生问题。
校验器会检查 skill frontmatter、skill 目录结构、agent metadata、plugin manifest、
本地 Markdown 链接、模板布局、Python 依赖的精确 pin 与 import 覆盖、安装与脚手架脚本
行为、生成/缓存文件的排除，以及 Python/R/Stata 模板语法。当 Rscript 不可用时，R 语法
检查会带告警跳过。CI 会安装 R，先运行 make preflight，再运行 make validate-strict —
后者在缺少可选工具时直接失败，而不是静默跳过。

示例

以经典 AER 及相邻 top-5 论文为依托的实操示例。
完整索引见 examples/README.md。

设计哲学

• 识别驱动，不是叙事驱动。 写文章之前先把研究设计决定下来并压力测试通过。
• 一篇论文只讲一个贡献。 AER 编辑会枪毙"合格但常规的扩展"；围绕一个最锋利的主张重写。
• 跨领域可读性是硬筛选。 一篇 labor 文章必须能让 public、macro、IO 经济学家也读懂，否则 desk-reject。
• 用现代计量，不要用 1990 年代的默认值。 TWFE → Callaway-Sant'Anna；first-stage F → Anderson-Rubin；朴素 RDD → 协变量调整的 local linear。
• 复现包是论文的一部分。 README 跑不通就是 AEA Data Editor 卡你的理由。
• 编辑的时间是最稀缺资源。 Cover letter ≤ 200 词。回复信先引用 comment、再说 action、再标出修改后的位置。

完整论述见 docs/design-principles.md。

关键参考文档：

• Desk-rejection audit — 从编辑/审稿人视角做的
  投稿前 no-go 检查
• Methods reference — 估计量默认值、诊断、包调用，
  以及 BibTeX key
• PNAS Nexus publication plan —
  审稿人式审计与一周合规改进计划
• PNAS Nexus submission checklist —
  稿件、数据、代码和图件的证据驱动终审清单
• Source register — AEA 官方政策来源，以及 repo 中依赖
  这些政策的表面
• Glossary — 期刊、识别、复现、回复信术语的共享词表

仓库结构

AER-Skills/
├── README.md               (中文，主入口)
├── README.en.md            (英文，完整版)
├── LICENSE                 (MIT)
├── Makefile                (校验与安装快捷命令)
├── CONTRIBUTING.md         (并发 agent 工作流)
├── .github/
│   └── workflows/ci.yml    (仓库校验)
├── .claude-plugin/
│   ├── plugin.json         (插件清单)
│   └── marketplace.json    (Claude Code marketplace 条目)
├── docs/
│   ├── desk-rejection-audit.md
│   ├── design-principles.md
│   ├── glossary.md
│   ├── installation-claude.md
│   ├── installation-codex.md
│   ├── methods-reference.md
│   ├── pnas-nexus-publication-plan.md
│   ├── pnas-nexus-submission-checklist.md
│   ├── source-register.md
│   └── workflow-map.md
├── skills/                 (10 个 skill 目录 — SKILL.md + agents/openai.yaml)
│   ├── aer-workflow/
│   ├── aer-topic-selection/
│   ├── aer-introduction/
│   ├── aer-identification/
│   ├── aer-robustness/
│   ├── aer-tables-figures/
│   ├── aer-replication/
│   ├── aer-submission/
│   ├── aer-rebuttal/
│   └── aer-statspai/       (可选实现引擎)
├── templates/              (即插即用流水线，三种语言都有)
│   ├── stata/
│   ├── r/
│   └── python/
├── scripts/
│   ├── install_skills.py
│   ├── scaffold_project.py
│   └── validate_repo.py
└── examples/
    ├── aer-exemplars.md
    ├── intro-example.md
    ├── rebuttal-example.md
    └── replication-package-skeleton/
        ├── data/codebook/source-register.md
        └── docs/exhibit-register.md

适用 / 不适用

适用：

• American Economic Review（长文，≤ 40 页）
• American Economic Review: Insights（短文，≤ 7,000 词减每个 exhibit 200 词；5 个 exhibits 时 ≤ 6,000 词）
• American Economic Journal 系列（Applied / Policy / Macro / Micro）
• 实证或理论经济学稿件
• 田野实验（含 AEA RCT Registry 流程）

不适用：

• 金融三大刊工具箱（JF / JFE / RFS 有自己的规范）
• 纯理论栈（没有证明撰写助手）
• 通用 "academic writing" 库

致谢

Skill 架构参考自 Boom5426/Nature-Paper-Skills 与 Yuan1z0825/nature-skills。方法论提炼自 Keith Head、Marc F. Bellemare、Susan Athey、Berk-Harvey-Hirshleifer、AEA Data Editor's Office 以及 Annual Review of Economics 的公开资料。

协议

MIT。