用经典编程规则喂饱你的 AI 编码 Agent

AI Coding Agent 写代码的速度远超人类，但它们不天然知道什么代码算是好代码。没有明确约束，Agent 产出的代码在 demo 里看起来功能完整，三个月后在维护追索里看起来一团乱——函数过长、命名猜谜、层层依赖交织无处下刀。agent-rules-books 把 14 本经典软件工程书籍的核心决策逻辑，蒸馏成 Agent 可以直接读的规则集，每本书给三个粒度：full（参考）、mini（推荐日常）、nano（紧急空间）。

该用哪本书

每本书对应一类场景。Clean Code 管日常可读性和命名，Clean Architecture 管依赖方向和边界隔离，DDD 管领域模型和限界上下文，DDIA 管数据一致性和事件流，Release It! 管生产韧性。日常编码选 Clean Code 或 Code Complete，架构选 Clean Architecture 搭 DDD，重构用 Refactoring 搭 A Philosophy of Software Design，遗留代码接力给 Working Effectively with Legacy Code。规则集之间有兼容矩阵标注了互补、重叠和冲突——DDD 和 Patterns of EAA 冲突，不应同时作为主规则加载。

怎么喂给 Agent

每家的姿势不同。Claude Code 最简单：把选中的 mini 版当作 AGENTS.md，在 CLAUDE.md 中写一行 @AGENTS.md 引入。Codex 放根目录 AGENTS.md，子树用 AGENTS.override.md 做局部覆盖，重复性流程做成 .agents/skills/。Cursor 建议走 .cursor/rules/ 的 path scoped 模式：base.mdc 做 Always 短规则、payments.mdc 自动附在对应路径、refactor.mdc 手动触发。核心原则是一个项目只塞一个 mini 版作为 always-on 基础，更强的按需用 skill 或临时会话加载，避免把多个 full 版拍进根文件——那样 Agent 读完规则已经没有空间给你的代码了。

这些规则不是书籍替代品，而是轻量级工作协议。它们帮你记住决策点，而你读过的每一本原著才给了你判断力。