agent-rules-books 14本书完整清单：Clean Architecture、DDIA、Release It!等规则包一句话适用场景速查
【免费下载链接】agent-rules-booksAGENTS.md rules / skills for AI coding agents: Codex, Cursor & Claude Code. Inspired by Clean Code, Refactoring, DDD, Clean Architecture and DDIA programming books.项目地址: https://gitcode.com/gh_mirrors/ag/agent-rules-books
agent-rules-books 是一个面向 Codex、Cursor、Claude Code 等 AI 编程工具的开源规则库，把 14 本经典软件工程书（Clean Architecture、DDIA、Release It! 等）提炼为即插即用的 AGENTS.md 规则包，每本书都提供 full / mini / nano 三种长度，帮你用一句话判断该在什么任务里加载哪条规则。
📚 这个仓库是干什么的
一句话：把"读过的编程书"变成"AI 会执行的规则"。
传统做法是在 AGENTS.md 里写一句OBEY Clean Architecture，但实验表明只提名书的效果远不如列出具体规则（评分 46 分 vs 74 分）。本仓库的每个规则包都包含"决策规则 + 触发规则 + 收尾检查清单"，让 AI 编码智能体真正按书里的原则做判断，而不是停留在口号层面。
- 许可证：MIT，可自由复制到你的项目
- 每个书目录下的三个版本：
full（完整参考）、mini（日常推荐）、nano（极简兜底） - 官方使用说明见 docs/USAGE.md，多书组合建议见 docs/COMPATIBILITY.md
📋 14本书规则包完整清单与一句话适用场景
| # | 规则包 | 来源书籍 | 一句话适用场景 |
|---|---|---|---|
| 1 | a-philosophy-of-software-design | A Philosophy of Software Design（John Ousterhout） | API/模块设计偏浅、复杂度失控时，用"深模块、信息隐藏"重构 |
| 2 | clean-architecture | Clean Architecture（Robert C. Martin） | 防止框架、数据库、UI 污染业务核心，保持依赖向内 |
| 3 | clean-code | Clean Code（Robert C. Martin） | 日常编码与代码评审的默认基线：命名、小函数、简洁 |
| 4 | code-complete | Code Complete（Steve McConnell） | 变量、类、控制流、防御式编程等实现细节的纪律性决策 |
| 5 | designing-data-intensive-applications | DDIA（Martin Kleppmann） | 数据正确性、复制/分片、事务、流与 schema 演进 |
| 6 | domain-driven-design | Domain-Driven Design（Eric Evans） | 让 AI 按业务模型思考，而不是按表结构、Controller 或 DTO 思考 |
| 7 | domain-driven-design-distilled | DDD Distilled（Vaughn Vernon） | 轻量版 DDD：子域、限界上下文，不要过度仪式感 |
| 8 | implementing-domain-driven-design | Implementing DDD（Vaughn Vernon） | 落地 DDD：聚合、领域事件、上下文集成与应用架构 |
| 9 | patterns-of-enterprise-application-architecture | PoEAA（Martin Fowler） | 在 Repository、UnitOfWork、DTO 等模式里选对，避免职责混写 |
| 10 | refactoring | Refactoring（Martin Fowler） | 安全重构：小步前进、先补测试、识别代码坏味道 |
| 11 | refactoring-guru | Refactoring.Guru | 诊断坏味道、选安全重构手法，防止小修变成失控重写 |
| 12 | release-it | Release It!（Michael T. Nygard） | 服务/队列/关键生产路径：超时、重试、熔断、过载与可观测性 |
| 13 | the-pragmatic-programmer | The Pragmatic Programmer（Hunt & Thomas） | 通用工程层：DRY、正交性、自动化、快速反馈 |
| 14 | working-effectively-with-legacy-code | Working Effectively with Legacy Code（Michael Feathers） | 改测试缺失的旧代码：先建立控制点，再谈清理 |
💡 记忆技巧：写新功能看 Clean Code / Code Complete，重构看 Refactoring 系列，架构看 Clean Architecture / APoSD，业务复杂看 DDD 三件套，上线稳定看 Release It!，数据系统看 DDIA，老代码看 Legacy Code。
🎯 如何挑选：先 mini，再按需换长度
规则包分三档，选择原则是"能用最小的、能改变 AI 决策的机制，就用它"（详见 docs/USAGE.md）：
| 版本 | 特点 | 什么时候用 |
|---|---|---|
mini | 规则压力 + 触发条件 + 权衡处理 | 默认选择，适合作为技能（skill）主体 |
nano | 只有核心偏置与少量规则 | 上下文预算极紧、需要常驻多编辑器时 |
full | 完整参考版，可追溯书中结构 | 审计、深度会话、技能的参考文件 |
例如 Clean Architecture 三个版本：clean-architecture.md（515 行 / 289 条）、clean-architecture.mini.md（49 行 / 31 条）、clean-architecture.nano.md（36 行 / 18 条）。
推荐用法：把某本书的 mini 版做成按需加载的"技能"，比如重构任务加载 refactoring.mini.md、遗留代码任务加载 working-effectively-with-legacy-code.mini.md，而不要全局塞入多个 full 文件。
⚠️ 哪些书不能同时加载
仓库内置了 14×14 的兼容性矩阵（完整数据见 docs/COMPATIBILITY.md），核心结论：
- ❌冲突（不要同时激活）：Domain-Driven Design 与 PoEAA、Implementing DDD 与 PoEAA——两者对企业应用的职责划分给出相反建议
- 🔁重叠（二选一）：Clean Code 与 APoSD、Code Complete 与 Pragmatic Programmer、Refactoring 与 Refactoring.Guru 等 11 对，压力方向相近，同用会浪费上下文
- ✅互补（78 对）：如 Clean Architecture + Refactoring、DDIA + Release It!，可组合为平等的活跃规则
🚀 快速上手步骤
- 克隆仓库（可浏览或直接取用规则文件）：
git clone https://gitcode.com/gh_mirrors/ag/agent-rules-books- 按任务挑 1 个主规则包（从上面速查表里找一句话场景匹配）
- 复制
mini文件内容到AGENTS.md/CLAUDE.md，或放入.agents/skills/作为技能 - 多编辑器团队：Codex 直接读
AGENTS.md，Claude Code 从CLAUDE.md导入，Cursor 可转为.cursor/rules（详见 docs/USAGE.md 的"Portable Baseline"一节） - 需要新规则包时，可参考 docs/ADDING_THE_BOOK.md 的提炼工作流
📌 常用文件路径速查
| 文件 | 说明 |
|---|---|
| README.md | 发布矩阵：每本书 full/mini/nano 的行数与规则数 |
| docs/USAGE.md | Codex / Cursor / Claude Code 的分编辑器配置 |
| docs/COMPATIBILITY.md | 书籍两两组合的冲突/重叠/互补判定 |
| docs/CRITICISM.md | 社区（Reddit）批评与回应 |
| CHANGELOG.md | 版本发布历史 |
| LICENSE | MIT 许可证 |
⚠️ 提醒：这些规则是"给 AI 的工具化指令"，不是书籍的官方摘要，更不能替代读书。把它们当作轻量级工作约定来使用即可。
❓ 常见问题
这些规则只支持 Claude Code 吗？不是。规则是纯 Markdown、工具无关的，Codex、Cursor、Claude Code、GitHub Copilot 都能用，适配方式见 docs/USAGE.md。
14 个规则包要全加载吗？不建议。默认只加载 1 个mini作为项目基线，其余按需作为技能调用；nano留给上下文预算极紧的场景。
mini 和 nano 差多少？以 Clean Architecture 为例，mini 有 31 条规则约 5.5 KB，nano 只有 18 条约 2.2 KB；nano 保留"核心偏置"，mini 额外保留触发规则与权衡处理。
把 14 本书装进 AGENTS.md 不必靠记忆力——按上面这张"一句话适用场景"速查表，找到任务类型，选对应书，用 mini 起步，你的 AI 编码智能体就能带着经典工程书的判断力开工了。
【免费下载链接】agent-rules-booksAGENTS.md rules / skills for AI coding agents: Codex, Cursor & Claude Code. Inspired by Clean Code, Refactoring, DDD, Clean Architecture and DDIA programming books.项目地址: https://gitcode.com/gh_mirrors/ag/agent-rules-books
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
