问题
坦白说:我们已经不想再读代码了。不想核查智能体做的每一件事,也不想把项目的每个技术细节都记在脑子里。
但如果没有人控制智能体,它们迟早会把任何项目变成无法维护的混乱——人和智能体都无法理清。这只是时间问题。
理念
HUMAN-INTENT.md 是仓库根目录下的一个文件。它承载着你的意图:项目架构、开发规则和产品决策。
它不是代码的文档,而是代码必须遵守的法律。
规则
-
由你编写——且只由你编写
智能体永远不能编辑这个文件。文件里的每一行都是人类做出的决定。
-
它的指令对智能体而言是法律
HUMAN-INTENT.md 中写的内容高于一切。如果代码与文件冲突,错的是代码。
-
它定义架构、规则和产品
写意图,而不是配方。智能体早已掌握所有模式;你的职责是确定什么必须成立——以及为什么。
为什么有效
没人盯得住智能体:代码的增长早已超过任何人愿意阅读的程度。控制每一行代码没有希望,控制意图却是可行的。
HUMAN-INTENT.md 把控制提升了一个层级:你只需盯住一个记录自己决定的文件,而不是几千行代码。只要这个文件是法律,项目就按你的意图发展——即使没有人读代码。
如何开始
- 在仓库根目录创建 HUMAN-INTENT.md。
- 写下你已经做出的决定:架构、开发规则、产品。
- 告诉智能体阅读这个文件并将其视为法律——在 AGENTS.md 或 CLAUDE.md 中引用它。
- 每做出一个新决定,就把它加入文件。绝不允许智能体写入这个文件。
- 审阅这个文件,而不是代码。