HUMAN-INTENT.md

一个帮助人类掌控 AI 开发的文件。

问题

坦白说:我们已经不想再读代码了。不想核查智能体做的每一件事,也不想把项目的每个技术细节都记在脑子里。

但如果没有人控制智能体,它们迟早会把任何项目变成无法维护的混乱——人和智能体都无法理清。这只是时间问题。

理念

HUMAN-INTENT.md 是仓库根目录下的一个文件。它承载着你的意图:项目架构、开发规则和产品决策。

它不是代码的文档,而是代码必须遵守的法律。

规则

为什么有效

没人盯得住智能体:代码的增长早已超过任何人愿意阅读的程度。控制每一行代码没有希望,控制意图却是可行的。

HUMAN-INTENT.md 把控制提升了一个层级:你只需盯住一个记录自己决定的文件,而不是几千行代码。只要这个文件是法律,项目就按你的意图发展——即使没有人读代码。

如何开始

  1. 在仓库根目录创建 HUMAN-INTENT.md。
  2. 写下你已经做出的决定:架构、开发规则、产品。
  3. 告诉智能体阅读这个文件并将其视为法律——在 AGENTS.md 或 CLAUDE.md 中引用它。
  4. 每做出一个新决定,就把它加入文件。绝不允许智能体写入这个文件。
  5. 审阅这个文件,而不是代码。