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

用经典编程规则喂饱你的 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 读完规则已经没有空间给你的代码了。

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

相关文章

Claude Code 2.1.136:当 AI Agent 的安全阈门从‘相信’变成‘验证’

Claude Code 2.1.136:当 AI Agent 的安全阈门从‘相信’变成‘验证’

你让 Claude Code 在 auto mode 下跑一个长任务,回来发现它把你的 AWS credentials 写进了日志文件。或者更糟:它在你没看到的一个弹窗里点了 "允许",然后把一个安全 ...

Vibe-Trading:把交易想法变成可回测研究的个人金融 Agent

Vibe-Trading:把交易想法变成可回测研究的个人金融 Agent

你问一个交易问题,LLM 可以给你一段漂亮解释。问题是:它没有数据、没有回测、没有报告、没有复现实验路径。你得到的是观点,不是研究。 金融 Agent 最危险的地方,不是它不会说话,而是它太会说话。 ...

Agent Harness:为什么你的模型不是问题所在

LangChain 在 TerminalBench 2.0 上从 30 名开外飙到了第 5 名。他们没有换模型。同一个 LLM。同样的参数。唯一改变的是包裹在模型外面的那层软件——Harness。 ...

Agent 不是眼瞎,是你没给装眼睛:3 分钟用 XCrawl 打通数据层

Agent 能背出 42 万字的投资框架,能识别 Rug 项目,能写策略代码。 但 markets 在每秒变化,它的知识停留在昨天。 这不是 Agent 不够聪明。是你喂数据的方式还停留在石器时代 ...

Postiz Agent CLI:把 28 个社交平台的发布权交给你的 AI

你写了一个能读 RSS、能总结论文、能生成配图的 AI Agent,结果发现最后一英里卡住了:它没法把内容发出去。 不是技术问题,是生态断层。大多数社交媒体平台只给人类设计 UI,API 文档散落在 ...

Claude Code 102 教给学术研究者的五件事

Claude Code 102 教给学术研究者的五件事

2026 年 5 月 11 日,Mushtaq Bilal, PhD 发布了《Claude Code 102 for Academic Researchers》,这是他教程系列的第二篇。第一篇 Cla ...