规格驱动开发为何失败？双重事实源如同戴两只手表

规格驱动开发为什么会失败？

规格驱动开发失败的主要原因是规格文档与代码不同步，导致产生两个事实源。代码是最终运行的真相，而规格文档往往滞后，最终沦为摆设。维护文档的成本高，且AI无法捕捉文档中关键的“为什么”部分，导致文档失去价值。

规格文档和代码哪个才是真正的真相？

代码才是真正的真相。因为代码是最终运行、测试和上线的基础，规格文档写得再好，如果代码跑不通就没有意义。当两者冲突时，通常以代码为准，规格文档会失去意义。

规格文档在软件开发中应该扮演什么角色？

规格文档应该作为一次性的沟通工具，用于在开发前对齐意图和方向，而不是作为长期维护的详细设计文档。它适合定方向，不适合定细节，细节应在代码中体现。开发完成后，规格文档即可归档或丢弃。

RPI模式是什么？它如何解决规格文档维护问题？

RPI模式指调研（Research）、规划（Plan）、实现（Implement）三个阶段。在每个开发周期中，先进行调研并写调研笔记，然后制定执行方案，最后按方案实现。实现完成后，所有文档归档封存，下次开发时重新调研。这样避免了长期维护过时文档的问题，每次开发都重新对齐。

为什么AI无法自动同步规格文档？

AI可以读取代码改动，但无法理解开发者脑中的“为什么”，即设计决策的因果链。规格文档的价值在于记录“为什么这么做”，而AI只能生成流水账式的更新日志，无法捕捉真正的意图，因此自动同步无法解决文档失真的问题。

管理AI写代码和管人有什么相似之处？

管理AI写代码类似于工程经理管理程序员：都需要通过需求文档或规格来传达意图，但实现过程中必然会有偏差。聪明的经理管理结果而非过程，只要功能、性能达标，细节可以妥协。同样，指挥AI时不应过度控制细节，否则会适得其反。

规格文档的保质期是多久？为什么？

规格文档的保质期只有一次提交。在提交之前，它是活地图，指导开发；提交之后，它就成为历史档案，不再更新。因为环境、依赖和需求都会变化，旧规格的价值几乎为零，维护它只会浪费时间和误导新人。

为什么说代码自己说话比维护规格文档更可靠？

代码中的变量名、函数、注释和测试用例始终与代码同步更新，不会出现文档与代码脱节的问题。而规格文档需要额外维护，容易过时。代码能说明“是什么”，而“为什么”可以通过提交记录中的设计决策来补充，这比独立的规格文档更可靠。