AI 时代下需求文档的黄金模式：Spec

臻龙复盘 175 天独立搭建的完整系统，提出需求、设计、任务三份 Spec 文档缺一不可，强制力必须落在机器上。

基本信息

需求可判定性是核心瓶颈：AI 时代需求文档的失败根源不在代码产能，而在于需求的可判定性；缺少可判据的需求文档，AI 无法准确执行。
Spec 三份文档缺一不可：需求文档（回答要什么、怎样算做到）、设计文档（怎么做）、任务文档（做到哪算完）三份缺一即失效，必须用 EARS 句式写需求，用编号+依赖切任务。
强制力必须落在机器上：规则写进 pre-commit 等机器执行系统，而不是靠人自觉；面板勾选状态不可信，提交历史才是真源。
重建的六条原则：分类先于流程、先读后改、验收先于实现、状态只有一个真源、强制力落在机器上、完工冻结与活文档分离。

必填节。素材中的代码块、Prompt 模板、配置参数、分步教程等用户可直接复用的内容，必须原样保留在此节。

EARS 句式模板：

（暂无关联素材）

AI 读代码，读不出人当时的设计意图。代码记录结果，不记录原因。一个 if 为什么在那里，可能是三年前的合规要求；一个字段为什么允许为空，可能是上游某次事故的补丁。这些都进不了函数名。人可以靠记忆和同事补全，记忆会过期，人会走；AI 连记忆都没有，手里只有代码。

强制力必须落在机器上。规则写进文档，靠自觉执行；规则写进 pre-commit，才靠机器执行。而机器也会骗你——所以每装一道护栏，都要先构造一个它应该拦住的输入。

需求、设计、任务三份各回答一个不可替代的问题：要什么、怎么做、做到哪算完。缺一份，AI 就有一半的输入靠猜。