文档即可执行资产：当 Agent 逐字消费你的

我最近被一个设定逼得没法——文档不是参考资料，是会跑的资产。

下游 Agent 会逐字读 requirement.md、plan.md，照着字面往下干。它还会把知识库里的字原样塞进八段上下文里执行。模型能力再强，系统质量也卡在交接文档的无歧义程度。

结果就是，人类眼里的小毛病，全成了生产环境里的 bug。

一句“加个基础鉴权”，Agent 直接造出个自由发挥的登录宇宙。草稿里留的 TODO，它真会当成需求去实现。同一条规则抄到两份文档里，过阵子各自改了，两个 Agent 就分叉了。角色 ID 拼写不一，任务就静默积压。少了阶段工作流，它就自己发挥，每次都不同。

所以写文档得按编程来：规格先于代码，交付物零占位。原则只在一处定义，术语当公共 API 管。宁可十三份小文档，也别搞大部头。

现在就去搜一遍 TODO、TBD，查查有没有第二份翻译版。你手里那份关键交接文档，敢拿它过一遍吗？