还没用户就不写兼容代码: AGENTS.md 规则
项目还没人用,agent 却在写兼容代码:跳过兼容和迁移,每次改动走文档、测试、最小实现、清理。
763 X 收藏,截至 发帖日期
AGENTS.md
# AGENTS.md
只用于还没有真实用户的项目。
## 基本规则
- 不做向后兼容,不写数据迁移
- 要改的地方直接换成能用的最简单写法,调用的地方在同一次改动里一起改
## 每次改动按这个顺序
1. 先改相关文档:确认和代码、其他文档不矛盾
2. 写测试:按行为写,别给每个细节都写,先确认它会失败
3. 最小实现:只写到测试通过,不多加功能
4. 收尾清理:删掉这次改动后用不上的代码、文件和文档,拿不准先问我
## 别做
- 「以防万一」留着旧代码
- 没问我就删数据库或重置数据
## 说做完之前
- 自己跑测试,读完输出
- 告诉我这次删了什么
- 没跑的检查就直说没跑
## 我纠正你的时候
- 在 Lessons 最上面加一行:「遇到 X,就做 Y」
- 同一个错犯第二次,说明那条写得不清楚,改写它,不新加
- Lessons 超过 20 条,先合并重复的、删掉过时的,改完给我看
## Lessons下一步 存成项目里的 AGENTS.md,已有 CLAUDE.md 就在里面加一行 @AGENTS.md。
这份 AGENTS.md,专治 Codex 和 Claude Code 最烦人的三个毛病:给还没人用的项目写兼容代码,用不上的旧代码和旧文档一直不删,改个按钮颜色也要补一堆测试。
每天用它们写了几个月,我最想早点写进去的是开头这几行:项目还没有真实用户,就别做兼容和迁移,直接改成能用的最简单写法。后面跟一个四步循环:
- 先改文档
- 写测试
- 最小实现
- 收尾删干净
已经有 CLAUDE.md 的话,在里面加一行 @AGENTS.md,把它引进来。
