[{"data":1,"prerenderedAt":132},["ShallowReactive",2],{"page-/post/ai/skill/spec-driven-development-wrong":3,"surrounding-page":123},{"id":4,"title":5,"author":6,"body":7,"date":108,"description":109,"extension":110,"group":111,"lastmod":108,"meta":112,"navigation":113,"path":114,"rawbody":115,"seo":116,"showTitle":111,"stem":117,"tags":118,"versions":111,"__hash__":122},"content/post/ai/skill/spec-driven-development-wrong.md","规范驱动开发错在哪了","Jinx",{"type":8,"value":9,"toc":104},"minimark",[10,14,32,35,38,41,44,47,50,53,56,59,62,65,68,71,74,77,80,83,86,89,92,95,98,101],[11,12,13],"p",{},"原文链接：",[15,16,17,26],"ul",{},[18,19,20],"li",{},[21,22,23],"a",{"href":23,"rel":24},"https://x.com/augmentcode/status/2025993446633492725",[25],"nofollow",[18,27,28],{},[21,29,30],{"href":30,"rel":31},"https://x.com/dotey/status/2026146560862474482",[25],[11,33,34],{},"侵删。",[11,36,37],{},"你唯一能百分百信任的文档，就是代码本身。",[11,39,40],{},"设计文档、更新日志、README、架构图、入职指南。这些东西写完几乎立刻就过时了。",[11,42,43],{},"让文档和不断变化的系统保持同步，需要持续投入成本。工程师天生习惯爆发式输出：写文档，发功能，然后做下一个。后续更新属于隐形工作，每天都要和其他任务争夺时间，而且几乎每次都会败下阵来。我们试过流程，试过工具，甚至试图把它塑造成团队价值观。都没用。因为我们总是在强求人类去做他们骨子里就不愿做的事。",[11,45,46],{},"这正是规范驱动开发经常翻车的地方。理念本身没毛病：与编写代码的 Agent 合作时，先写清楚需求再让它们放手干。这显然比在聊天窗口里随便贴几句提示词然后祈祷奇迹发生要靠谱得多。",[11,48,49],{},"但规范也是文档。文档的下场，我们刚才已经见识过了。",[11,51,52],{},"区别在于代价不同。过时的设计文档只会误导碰巧读到它的下一位工程师。而过时的规范会误导不知变通的 Agent。它们会自信满满地执行一个早已脱离实际的计划，根本不会发现哪里不对。",[11,54,55],{},"因此，在开发 Intent 的过程中，我们反复思考一个问题：如果规范不需要你来维护呢？如果它能自我更新呢？",[11,57,58],{},"这是我们最终的方案。",[11,60,61],{},"规范不再是人类或 Agent 的专属产物。双方都要去读写它。",[11,63,64],{},"你描述想做什么。协调 Agent 草拟规范，拆解任务。你审阅、修改，批准后才开始执行。一旦 Agent 开始干活，它们会将进展同步回规范中：发现了什么、改变了什么、遇到了哪些计划外的限制。你可以随时暂停，重写部分规范，Agent 就会接着新状态继续干。",[11,66,67],{},"回想一下，把任务交给优秀的初级工程师会怎样。你把工单给他们，他们去干活；发现 API 不支持工单里预设的分页方式时，他们会自己更新工单。他们不会等你发现问题，更不会将错就错。他们会跑来告诉你：“之前的假设不对，我改用这种方法了，原因是这样。”你审查他们的更新，批准或驳回。",[11,69,70],{},"这正是我们希望开发者和规范之间建立的关系。因为双方都在维护，工单才不至于“说谎”。",[11,72,73],{},"初级工程师这个比喻比你想的还要贴切。优秀的初级工程师不会把每行代码怎么写都向你汇报。他们只会反馈那些改变了方向的决策：“我发现了一个现成的 auth context，所以直接接入了，没去建新的。”这就是信号。这也正是你期望 Agent 做到的事。把握好这种颗粒度，成了系统设计中真正有趣的难题。细节太多，规范就会变成噪音，让你产生习惯性无视；细节太少，你又要重新去猜到底发生了什么。",[11,75,76],{},"实际任务是这样的。你写道：“在设置页面加个能跟随系统偏好的深色模式开关。”协调 Agent 读取代码库，草拟一份包含三个子任务的规范：添加开关组件、接入 preference store、更新 CSS 变量。",[11,78,79],{},"你扫了一眼，发现漏掉了跨会话保存选择这个细节，于是补上一句。",[11,81,82],{},"你点击批准。",[11,84,85],{},"Agent 开始干活。",[11,87,88],{},"15 分钟后，其中一个 Agent 更新了规范：“在代码库里找到了现成的 Theme Provider。已直接接入，未创建新 store。”",[11,90,91],{},"你审查代码变更（已按 Agent 和任务清晰分组）。",[11,93,94],{},"现在，这份规范反映了实际做出来的东西，而不是最初计划的东西。最重要的是，没人需要专门记着去更新它。",[11,96,97],{},"软件工程中所有“文档优先”的倡议之所以失败，原因如出一辙：它们都要求开发者去做那种没人看见、没人奖励的持续维护工作。",[11,99,100],{},"除非 Agent 也承担起自己那份维护工作，否则规范驱动开发也将重蹈覆辙。",[11,102,103],{},"既然 Agent 会写代码，它们也能更新计划。放手让它们干吧。",{"title":105,"searchDepth":106,"depth":106,"links":107},"",2,[],"2026-02-25T00:00:00.000Z","规范驱动开发的坑不在理念，而在规范作为文档会过时；如果规范能被人和 Agent 共同维护，它才不会说谎。","md",null,{},true,"/post/ai/skill/spec-driven-development-wrong","---\ntitle: \"规范驱动开发错在哪了\"\nauthor: \"Jinx\"\ndate: 2026-02-25\nlastmod: 2026-02-25\ntags:\n  - Agent\n  - 工程\n  - 文档\ndescription: \"规范驱动开发的坑不在理念，而在规范作为文档会过时；如果规范能被人和 Agent 共同维护，它才不会说谎。\"\n---\n\n原文链接：\n- https://x.com/augmentcode/status/2025993446633492725\n- https://x.com/dotey/status/2026146560862474482\n\n侵删。\n\n你唯一能百分百信任的文档，就是代码本身。\n\n设计文档、更新日志、README、架构图、入职指南。这些东西写完几乎立刻就过时了。\n\n让文档和不断变化的系统保持同步，需要持续投入成本。工程师天生习惯爆发式输出：写文档，发功能，然后做下一个。后续更新属于隐形工作，每天都要和其他任务争夺时间，而且几乎每次都会败下阵来。我们试过流程，试过工具，甚至试图把它塑造成团队价值观。都没用。因为我们总是在强求人类去做他们骨子里就不愿做的事。\n\n这正是规范驱动开发经常翻车的地方。理念本身没毛病：与编写代码的 Agent 合作时，先写清楚需求再让它们放手干。这显然比在聊天窗口里随便贴几句提示词然后祈祷奇迹发生要靠谱得多。\n\n但规范也是文档。文档的下场，我们刚才已经见识过了。\n\n区别在于代价不同。过时的设计文档只会误导碰巧读到它的下一位工程师。而过时的规范会误导不知变通的 Agent。它们会自信满满地执行一个早已脱离实际的计划，根本不会发现哪里不对。\n\n因此，在开发 Intent 的过程中，我们反复思考一个问题：如果规范不需要你来维护呢？如果它能自我更新呢？\n\n这是我们最终的方案。\n\n规范不再是人类或 Agent 的专属产物。双方都要去读写它。\n\n你描述想做什么。协调 Agent 草拟规范，拆解任务。你审阅、修改，批准后才开始执行。一旦 Agent 开始干活，它们会将进展同步回规范中：发现了什么、改变了什么、遇到了哪些计划外的限制。你可以随时暂停，重写部分规范，Agent 就会接着新状态继续干。\n\n回想一下，把任务交给优秀的初级工程师会怎样。你把工单给他们，他们去干活；发现 API 不支持工单里预设的分页方式时，他们会自己更新工单。他们不会等你发现问题，更不会将错就错。他们会跑来告诉你：“之前的假设不对，我改用这种方法了，原因是这样。”你审查他们的更新，批准或驳回。\n\n这正是我们希望开发者和规范之间建立的关系。因为双方都在维护，工单才不至于“说谎”。\n\n初级工程师这个比喻比你想的还要贴切。优秀的初级工程师不会把每行代码怎么写都向你汇报。他们只会反馈那些改变了方向的决策：“我发现了一个现成的 auth context，所以直接接入了，没去建新的。”这就是信号。这也正是你期望 Agent 做到的事。把握好这种颗粒度，成了系统设计中真正有趣的难题。细节太多，规范就会变成噪音，让你产生习惯性无视；细节太少，你又要重新去猜到底发生了什么。\n\n实际任务是这样的。你写道：“在设置页面加个能跟随系统偏好的深色模式开关。”协调 Agent 读取代码库，草拟一份包含三个子任务的规范：添加开关组件、接入 preference store、更新 CSS 变量。\n\n你扫了一眼，发现漏掉了跨会话保存选择这个细节，于是补上一句。\n\n你点击批准。\n\nAgent 开始干活。\n\n15 分钟后，其中一个 Agent 更新了规范：“在代码库里找到了现成的 Theme Provider。已直接接入，未创建新 store。”\n\n你审查代码变更（已按 Agent 和任务清晰分组）。\n\n现在，这份规范反映了实际做出来的东西，而不是最初计划的东西。最重要的是，没人需要专门记着去更新它。\n\n软件工程中所有“文档优先”的倡议之所以失败，原因如出一辙：它们都要求开发者去做那种没人看见、没人奖励的持续维护工作。\n\n除非 Agent 也承担起自己那份维护工作，否则规范驱动开发也将重蹈覆辙。\n\n既然 Agent 会写代码，它们也能更新计划。放手让它们干吧。\n",{"title":5,"description":109},"post/ai/skill/spec-driven-development-wrong",[119,120,121],"Agent","工程","文档","BW0gYYo3jwB0bjBfihlrC_bbUzZoWeKd6i9YAZ-fYfM",[124,128],{"title":125,"path":126,"stem":127,"children":-1},"OpenClaw 安装入门（Windows）","/post/zzao/openclaw/openclaw-install-windows","post/zzao/openclaw/openclaw-install-windows",{"title":129,"path":130,"stem":131,"children":-1},"假设你是AI，你的Skill应该是什么样的","/post/zzao/ai-skill-structure","post/zzao/ai-skill-structure",1779005084793]