agent-rules-books：把 14 个经典来源蒸馏成编码 agent 的规则集

资深工程师的书架上总躺着几本翻烂了的书；你的编码 agent 带着的只有预训练数据里那点印象。ciembor/agent-rules-books 补的就是这个缺口：从 Clean Code、Refactoring、领域驱动设计、数据密集型应用系统设计、Release It! 等经典软件工程书籍与资源中提炼出 14 套规则，打包成面向 Codex、Cursor 和 Claude Code 的 AGENTS.md 规则与 skill。

为什么这个 Skill 重要

每套规则提供三个工具无关的 Markdown 版本：mini（真实任务的推荐版本）、nano（上下文预算紧张时的紧凑回退）、full（完整参考版）。粒度很重要，因为规则就是 token 开销——Clean Code 的 full 版带 220 条规则，mini 版压缩到 29 条。

仓库对自我定位说得很清楚：这些规则集受书中思想启发，不是官方材料，也刻意不复制书中原文——它们是轻量的工作约定，不是读书笔记。全部 MIT 许可。

安装

没有安装器；你把规则集拷到 agent 读取的位置。仓库的 USAGE.md 覆盖各编辑器的接入方式。Claude Code 的做法是：把某套规则拷进 CLAUDE.md 作为项目记忆，或者把一套聚焦的 mini 规则做成 skill：

git clone https://github.com/ciembor/agent-rules-books.git
cat agent-rules-books/clean-code/clean-code.mini.md >> your-project/CLAUDE.md

实战：带规则的重构

仓库自己的验证实验就是最好的模板。它对同一个故意写乱的帮助台 CLI 做了两次重构——一次由《软件设计哲学》的 mini 规则引导，另一次只给了一句话指令"OBEY A Philosophy of Software Design by John Ousterhout"。两份产出被交给 ChatGPT 评判：mini 规则版约 74 分，只报书名版 46 分。

诚实的脚注也得带上：Reek 静态分析显示通用坏味道数量几乎没有差别（1,083 对 1,077），README 把整个实验定性为"早期的定性信号，不是基准测试"。优势体现在架构判断上——模块深度、职责边界、信息隐藏。

你的工作流：按任务选书（遗留系统救援用 Working Effectively with Legacy Code，生产加固用 Release It!，数据密集系统用 DDIA），把对应的 mini 文件作为项目规则引入，然后跑重构。

技巧

• 每本书都从 mini 开始；上下文吃紧降到 nano，full 只当参考查阅。
• 书目清单一节给每套规则标了适用任务——坏味道诊断用 Refactoring.Guru，边界划分用 Clean Architecture，日常规范实现用 Code Complete。
• 合并多本书看 COMPATIBILITY.md；别一口气叠五套 full 规则，然后纳闷 agent 为什么开始忽略规则。
• Codex 和 Cursor 用户可以把同样的文件适配成项目规则和自定义指令。

何时不用这个 Skill

作者自己说得最直白：这些规则不能替代读书，也不是来自原作者或出版方的官方材料。如果你的团队已经有很强的内部风格指南，再叠一层书中规则只会增加上下文噪音——规则要能改变 agent 的行为才值回 token，而不是重复你评审流程已经在执行的东西。

查看 排行榜 了解更多 skill。