C
ChaoBro

Agent Rules Books 兴起:把《架构整洁之道》和 DDIA 变成 AI Agent 行为准则

Agent Rules Books 兴起:把《架构整洁之道》和 DDIA 变成 AI Agent 行为准则

发生了什么

2026 年 5 月初,GitHub 上出现了一个名为 Agent Rules Books 的开源项目(作者 @ciembor),短时间内获得 931 stars

这个项目做的事情很简单但很有意义:

把软件工程经典著作的核心原则,提炼成 AI 编码 Agent(Codex、Cursor、Claude Code)可以直接读取和执行的规则文件(Rules Files)。

包含的经典包括:

  • 《架构整洁之道》(Clean Architecture)—— Robert C. Martin
  • 《重构》(Refactoring)—— Martin Fowler
  • 《遗留代码模式》(Working Effectively with Legacy Code)—— Michael Feathers
  • 《数据密集型应用设计》(DDIA)—— Martin Kleppmann

每种规则文件提供 mini、nano、full 三种尺寸,适配不同上下文窗口。

为什么这件事重要

1. 从”人能读懂的书”到”Agent 能执行的规则”

软件工程经典著作的核心问题:它们是写给人类看的,不是写给 Agent 看的。

一个 AI 编码 Agent 无法直接”阅读”一本 400 页的书,然后自觉应用其中的原则。但如果把书中的核心规则提取出来,变成结构化的规则文件,Agent 就可以在每次编码时自动应用这些原则:

# Clean Architecture Rules (mini version)
- 依赖方向:内层不依赖外层
- 接口隔离:高层策略不依赖底层细节
- 单一职责:每个模块只有一个变化原因
- 显式边界:用接口定义架构边界

2. 三种尺寸的工程意义

尺寸上下文占用适用场景规则粒度
nano~500 tokens每次请求都附带的轻量规则最核心的 5-10 条原则
mini~2000 tokens项目级 .clinerules / .cursorrules关键原则 + 示例
full~8000 tokens深度代码审查/架构评审完整规则 + 详细说明

这反映了 2026 年 AI 编码工具的一个核心工程挑战:如何在有限的上下文窗口内,最大化注入工程知识。

3. 从”提示词工程”到”规则工程”

过去一年,AI 编码的最佳实践是”写好 prompt”。但 prompt 是临时的、手动的、容易遗忘的。

Agent Rules Books 代表了一种范式转变:

2025 年:每次手动写 prompt → 效果不稳定
2026 年:预置规则文件 → Agent 每次自动应用

规则文件(如 .cursorrulesAGENTS.md.clinerules)成为代码仓库的标准配置,就像 .gitignoreREADME.md 一样。

覆盖的经典与对应规则

经典著作核心规则提取Agent 行为影响
《架构整洁之道》依赖倒置、边界定义、分层架构生成的代码自动遵循分层原则
《重构》提取方法、消除重复、改善命名自动识别可重构的代码段
《遗留代码模式》保护性封装、特征 envy 识别安全地修改遗留代码
《DDIA》数据模型选择、一致性权衡数据库设计建议更合理

格局判断

为什么这个项目现在出现

  1. AI 编码工具的成熟:Codex、Cursor、Claude Code 等工具已经能理解并执行复杂规则
  2. 规则文件标准化的时机:各平台开始支持项目级规则文件(.cursorrules 等)
  3. 工程知识注入的瓶颈:单纯靠 prompt 无法传递足够的工程知识
  4. 开源社区的协作传统:把工程知识结构化、共享化是开源社区的强项

趋势预测

时间预测
2026 Q2更多经典被规则化:设计模式、SOLID、TDD 等
2026 Q3AI 编码工具内置规则市场,一键安装行业最佳实践
2026 Q4企业开始定制自己的 Agent Rules,形成内部编码标准
2027Agent Rules 成为代码仓库的标配,招聘要求中包含”能编写 Agent Rules”

与 AI Agent Harness 趋势的关联

这个趋势与 LangChain 最近的发现(同一模型仅更换 Harness 即可提升 13.7 分)高度一致:

  • Harness 工程 优化的是 Agent 的”执行框架”
  • Rules 工程 优化的是 Agent 的”行为准则”

两者结合,才是 2026 年 AI 编码能力跃升的真正原因。

行动建议

对于开发者

  • 在你的项目中添加 .cursorrulesAGENTS.md,注入你认可的工程原则
  • 从 Agent Rules Books 的 nano 版本开始,逐步根据团队需求扩展

对于团队 Leader

  • 考虑将团队的编码规范转化为 Agent Rules 文件
  • 这比编写冗长的开发文档更有效——因为 Agent 会真的执行这些规则

对于技术写作者

  • 如果你读过任何软件工程经典,考虑把它提炼为 Agent Rules
  • 这是一个全新的知识传播方式:不是写书,而是写规则

对于工具开发者

  • 考虑支持 Agent Rules 的标准格式
  • 提供规则文件的可视化管理和版本对比功能