pAI-Econ-claude

git clone https://github.com/maxwell2732/pAI-Econ-claude.git
cd pAI-Econ-claude

/theoretical-economics-claude-skill "你的理论经济学研究想法"

/theoretical-economics-claude-skill "
mode: model_extension

Extend a search model by adding product healthfulness and costly attention to nutrition labels.
Can a front-of-package label increase the probability that consumers choose healthier food?
"

/theoretical-economics-claude-skill "
mode: phenomenon_to_model

I want to incorporate genetic endowment into a health capital framework.
Genetic endowment affects productivity through childhood environment, health investment,
and human capital formation. Which theoretical model is most suitable?
"

/theoretical-economics-claude-skill "
mode: model_critique

Here is my model setup:
[粘贴模型原语、时序、效用函数、均衡定义和命题]

Please audit model coherence, assumptions, non-triviality, proof gaps, and possible counterexamples.
"

/theoretical-economics-claude-skill "
mode: full_pipeline

Investigate whether a principal facing a privately informed agent can achieve first-best efficiency
through a forcing contract when the agent's outside option is type-dependent.
"

/theoretical-economics-claude-skill "
mode: manuscript_skeleton_only

Here are my model, propositions, and proof sketches:
[粘贴已有内容]

Please organize them into a theoretical economics working paper skeleton.
"

Stage 7 — Proof Sketch (+ Gate 4)
  → 询问用户是否进行数值模拟（HiL-N1）
      NO        → 不创建任何数值产物，直接进入 Stage 8
      PLAN ONLY → 只生成 numerical_simulation_plan.md，不执行任何代码，暂停等待
      CUSTOM    → 先收集用户的模拟需求（命题、变量、基准参数、参数范围、
                  坐标轴、模拟类型、图形格式）→ 生成计划
      YES       → 生成计划
  → 用户批准计划（HiL-N2 —— 未选择 APPROVE PLAN 前禁止执行任何代码）
  → 生成代码 → 运行模拟 → 保存机器可读 CSV 结果
  → 生成 PNG 和 PDF 图形
  → Gate 4b — Numerical Integrity Gate（数值完整性门）
  → 人工审阅数值结果（HiL-N3）
  → Stage 8 — Counterexample Finder（带数值交接信息）

flowchart TD
    A["0. Intake<br/>研究想法摄入"] --> B["1. Puzzle Refinement<br/>研究问题精炼"]
    B --> C["2. Literature Positioning<br/>文献定位与检索计划"]
    C --> C2["2a. Empirical Reality Check<br/>现实背景校验（Gate 1b）"]
    C2 --> D["3. Persona Council<br/>理论评审委员会"]
    D --> E["3b. Canonical Model Matching<br/>典范模型匹配"]
    E --> F["4. Model Primitives<br/>模型原语"]
    F --> G["5. Assumption Audit<br/>假设审计"]
    G --> H["6. Proposition Generator<br/>候选命题"]
    H --> I["7. Proof Sketch<br/>证明草图"]
    I --> N1{"HiL-N1<br/>是否数值模拟？"}
    N1 -- "NO（默认路径）" --> J["8. Counterexample Finder<br/>反例与边界检查"]
    N1 -- "YES / CUSTOM" --> N2["7b. Numerical Simulation<br/>计划 → 用户批准 → 代码<br/>CSV + PNG/PDF 图形<br/>（Gate 4b）"]
    N1 -- "PLAN ONLY" --> NP["仅生成计划并暂停<br/>（不执行代码）"]
    N2 --> J
    J --> K["9. Economic Interpretation<br/>经济学解释"]
    K --> L["10. Manuscript Skeleton<br/>论文框架 + PDF"]

Exploration/
└── Project_NNN_<ModelAbbrev>/        ← 例：Project_001_HumanCapitalAutomation
    ├── state.json
    ├── initial_context/
    │   └── hypothesis.md
    ├── outputs/
    │   ├── research_intake.md
    │   ├── research_puzzle.md
    │   ├── literature_positioning.md
    │   ├── persona_council.md
    │   ├── canonical_model_match.md
    │   ├── model_primitives.md
    │   ├── assumption_audit.md
    │   ├── candidate_propositions.md
    │   ├── proof_sketches.md
    │   ├── numerical_simulation_decision.md   ← Stage 7b（可选）：HiL-N1 决策记录
    │   ├── numerical_simulation_plan.md       ← Stage 7b（可选）：PLAN ONLY / CUSTOM / YES
    │   ├── parameter_definitions.md           ← Stage 7b（可选）：参数分类表
    │   ├── numerical_simulation_report.md     ← Stage 7b（可选）：批准执行后生成
    │   ├── numerical_code/                    ← Stage 7b（可选）：可复现 Python 脚本
    │   ├── numerical_results/                 ← Stage 7b（可选）：机器可读 CSV 结果
    │   ├── numerical_figures/                 ← Stage 7b（可选）：图形，PNG + PDF 双格式
    │   ├── counterexamples_and_edge_cases.md
    │   ├── economic_interpretation.md
    │   ├── manuscript_skeleton.md
    │   ├── manuscript_skeleton.tex   ← LaTeX 源文件（pdflatex + Computer Modern）
    │   └── manuscript_skeleton.pdf   ← 学术排版 PDF（pdflatex + Computer Modern）
    ├── gates/
    │   ├── gate-01-novelty-risk.md
    │   ├── gate-02b-canonical-fit.md
    │   ├── gate-02c-theory-lineage.md
    │   ├── gate-02-model-coherence.md
    │   ├── gate-03-non-triviality.md
    │   ├── gate-04-proof-integrity.md
    │   ├── gate-04b-numerical-integrity.md    ← Stage 7b（可选）：仅当模拟运行后
    │   └── gate-05-economic-meaning.md
    └── logs/
        └── stage-log.md

pAI-Econ-claude/
├── SKILL.md                              # 流水线编排：阶段路由、Gate 逻辑、HiL 协议
├── CLAUDE.md                             # 项目级规则（文献验证要求、PDF 格式标准等）
├── README.md                             # 中文说明（本文件）
├── README_EN.md                          # 英文说明
├── THEORETICAL_ECON_MIGRATION_PLAN.md    # 从 pAI/MSc 迁移的设计记录
├── LICENSE
├── .claude/
│   └── commands/
│       └── theoretical-economics-claude-skill.md  # slash command 入口
├── model_library/                        # 理论经济学典范模型库（仅结构模型）
│   ├── consumer-choice.md
│   ├── indirect-utility-expenditure-minimization.md
│   ├── discrete-choice-random-utility.md
│   ├── search-models.md
│   ├── costly-information-acquisition.md
│   ├── rational-inattention.md
│   ├── signaling.md
│   ├── screening.md
│   ├── moral-hazard.md
│   ├── adverse-selection.md
│   ├── hotelling-product-differentiation.md
│   ├── disclosure-persuasion-information-design.md
│   ├── mechanism-design.md
│   ├── matching-models.md
│   ├── social-learning-information-cascades.md
│   ├── dynamic-optimization-bellman.md
│   ├── overlapping-generations-life-cycle.md
│   ├── principal-agent.md
│   ├── general-equilibrium-basics.md
│   ├── political-economy-collective-choice.md
│   ├── comparative-advantage-ricardian.md
│   ├── heckscher-ohlin.md
│   ├── new-trade-theory-krugman.md
│   ├── melitz-firm-heterogeneity.md
│   ├── dynamic-spatial-general-equilibrium.md    # Kleinman-Liu-Redding (2023)
│   ├── trade-labor-dynamics-china-shock.md       # Caliendo-Dvorkin-Parro (2019)
│   ├── io/
│   │   ├── oligopoly-competition.md
│   │   ├── entry-deterrence.md
│   │   ├── two-sided-markets-platforms.md
│   │   └── price-discrimination.md
│   └── human_capital_and_labor/
│       ├── becker-human-capital.md
│       ├── ben-porath-lifecycle.md
│       ├── roy-model.md
│       ├── cunha-heckman-skill-formation.md
│       ├── technology-of-skill-formation.md
│       ├── self-productivity-dynamic-complementarity.md
│       ├── early-childhood-investment.md
│       ├── intergenerational-transmission.md
│       ├── education-credit-constraints.md
│       ├── occupational-choice-comparative-advantage.md
│       ├── task-based-production-acemoglu-restrepo.md
│       ├── automation-displacement-reinstatement.md
│       ├── human-capital-adaptation-automation-ai.md
│       └── directed-technical-change-sbtc.md
├── prompts/
│   ├── 00-intake.md
│   ├── 01-puzzle-refinement.md
│   ├── 02-literature-positioning.md
│   ├── 02a-empirical-reality-check.md        # Stage 2a + Gate 1b（现实契合度检查）
│   ├── 03-persona-council.md
│   ├── 03b-canonical-model-match.md
│   ├── 04-model-primitives.md
│   ├── 05-assumption-audit.md
│   ├── 06-proposition-generator.md
│   ├── 07-proof-sketch.md
│   ├── 07b-numerical-simulation.md           # 可选 Stage 7b（须用户明确选择）
│   ├── 08-counterexample-finder.md
│   ├── 09-economic-interpretation.md
│   ├── 10-manuscript-skeleton.md
│   ├── gate-01-novelty-risk.md
│   ├── gate-02b-canonical-fit.md
│   ├── gate-02c-theory-lineage.md
│   ├── gate-02-model-coherence.md
│   ├── gate-03-non-triviality.md
│   ├── gate-04-proof-integrity.md
│   ├── gate-04b-numerical-integrity.md       # 可选 Gate 4b（仅当 Stage 7b 运行后）
│   └── gate-05-economic-meaning.md
├── templates/
│   ├── state.json
│   ├── academic-econ.latex               # 旧版 PDF 模板（已弃用，现直接写 .tex）
│   ├── author_style_guide_econ.md
│   └── author_style_guide_default.md
├── legacy/                               # 原 pAI/MSc 流水线遗留文件（仅存档，非活跃流程）
└── Exploration/                          # 所有项目工作区（自动生成，不提交内容）
    └── Project_NNN_<ModelAbbrev>/

1. Fork this repository
2. Edit prompt files, model_library, or SKILL.md routing logic
3. Test on a research hypothesis end-to-end
4. Submit a PR describing what changed and why