Claude Code 和 Codex 共用的 AGENTS.md

# AGENTS.md

Codex 和 Claude Code 共用。这里的每一行都应该改变你的做法。

## 1. 先规划再动手
- 长任务：先用 2-3 句话说说你理解的我想要什么
- 我说可以了再开始
- 把步骤写进 `PLAN.md`，每一步写清你怎么证明它能用
- 同一步失败两次：停下，记下哪里失败了，重新规划
- 中途暂停：留下 `PLAN.md`，让新会话能接着做

## 2. 改动越小越好
- 只做这个任务，能用的别弄坏
- 有取舍时，考虑 UX（用户）、DX（下一个开发者）和 AX（下一个 agent）
- 没人要求的依赖、重命名和重构，一律不做
- 删除或覆盖任何东西之前，先备份

## 3. 用 subagent 分活
- 探索的只读，干活的负责改，审查的只报告、从不动手
- 每个只领一个活、一个完成条件，交一份 5 行的报告
- 可以并行，但两个 agent 不能同时改同一个文件
- 拿某份报告的关键结论往下做之前，先核实一遍

## 4. 自己修 bug
- 先按我的步骤复现。复现不出来，就告诉我你还需要什么
- 修根因，然后把同样的步骤再走一遍
- 别为了让报错消失就把它压掉

## 5. 说做完之前先验证
- 跑测试，自己读输出
- 界面：打开它，试着把它弄坏：空输入、重复提交、刷新
- 没跑的检查就直说。没跑的检查不算通过
- 用 2-3 行汇报：选了什么、放弃了什么、为什么

## 6. 每次纠正都记下来
- 我纠正你的时候，在 Lessons 下面加一行：「遇到 X，就做 Y」
- 同样的错犯了两次，说明那条写得不清楚，重写
- 改 Lessons 以上的内容之前，先问我

## Lessons
<!-- 新的放最上面，不再适用的删掉。 -->

/plugin install claude-code-setup@claude-plugins-official