发生了什么
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 每次自动应用
规则文件(如 .cursorrules、AGENTS.md、.clinerules)成为代码仓库的标准配置,就像 .gitignore 和 README.md 一样。
覆盖的经典与对应规则
| 经典著作 | 核心规则提取 | Agent 行为影响 |
|---|---|---|
| 《架构整洁之道》 | 依赖倒置、边界定义、分层架构 | 生成的代码自动遵循分层原则 |
| 《重构》 | 提取方法、消除重复、改善命名 | 自动识别可重构的代码段 |
| 《遗留代码模式》 | 保护性封装、特征 envy 识别 | 安全地修改遗留代码 |
| 《DDIA》 | 数据模型选择、一致性权衡 | 数据库设计建议更合理 |
格局判断
为什么这个项目现在出现
- AI 编码工具的成熟:Codex、Cursor、Claude Code 等工具已经能理解并执行复杂规则
- 规则文件标准化的时机:各平台开始支持项目级规则文件(
.cursorrules等) - 工程知识注入的瓶颈:单纯靠 prompt 无法传递足够的工程知识
- 开源社区的协作传统:把工程知识结构化、共享化是开源社区的强项
趋势预测
| 时间 | 预测 |
|---|---|
| 2026 Q2 | 更多经典被规则化:设计模式、SOLID、TDD 等 |
| 2026 Q3 | AI 编码工具内置规则市场,一键安装行业最佳实践 |
| 2026 Q4 | 企业开始定制自己的 Agent Rules,形成内部编码标准 |
| 2027 | Agent Rules 成为代码仓库的标配,招聘要求中包含”能编写 Agent Rules” |
与 AI Agent Harness 趋势的关联
这个趋势与 LangChain 最近的发现(同一模型仅更换 Harness 即可提升 13.7 分)高度一致:
- Harness 工程 优化的是 Agent 的”执行框架”
- Rules 工程 优化的是 Agent 的”行为准则”
两者结合,才是 2026 年 AI 编码能力跃升的真正原因。
行动建议
对于开发者:
- 在你的项目中添加
.cursorrules或AGENTS.md,注入你认可的工程原则 - 从 Agent Rules Books 的 nano 版本开始,逐步根据团队需求扩展
对于团队 Leader:
- 考虑将团队的编码规范转化为 Agent Rules 文件
- 这比编写冗长的开发文档更有效——因为 Agent 会真的执行这些规则
对于技术写作者:
- 如果你读过任何软件工程经典,考虑把它提炼为 Agent Rules
- 这是一个全新的知识传播方式:不是写书,而是写规则
对于工具开发者:
- 考虑支持 Agent Rules 的标准格式
- 提供规则文件的可视化管理和版本对比功能