分享｜我做了个轻量的「AI 协作 Playbook」，让写代码不再跑偏（有点像自制 spec-kit）

最近用 Claude/Codex 这类工具写代码，最大的痛点不是“写不出来”，而是经常会跑偏：改着改着顺手动了不相关的文件、找不到正确入口只能猜、对话一长就忘约束，最后返工比自己写还累。

我在自己的 Next.js 项目里整理了一套很轻量、但比较“工程化”的做法，核心思路是：别再卷 prompt ，把约束/入口/流程/验收写进仓库，让 AI 像新同事一样按规矩协作。结构大概是这几块：

• AGENTS.md：项目红线 + 默认规则（例如：单一主题、隐私/架构边界、必须可构建、禁止顺手重构）
• code-map / flows：告诉 AI “去哪改 / 怎么跑”（入口文件、关键时序、不变量、调试要点）
• “计划先行”模板：每次改动先交一个迷你设计文档（目标/范围/方案/风险/验收/回滚/验证），我确认后才动代码

这套东西不是什么银弹，也不是为了替代 code review ，但对我来说最大的收益是：改动更聚焦、回滚成本更低、AI 输出稳定很多，整体节奏更可控。

文章链接我放在评论区（包含可直接复制的最小目录结构和模板）。如果你们团队也有类似实践/踩坑经验，欢迎拍砖或分享更好的做法。