目录一、一句话需求的真实成本模糊为什么在生成时代更贵了一一句「加个优惠券功能」里藏着多少个决定二口头澄清不留痕提示词编程的三个结构性缺陷三成本重心的迁移从「写出来」到「说清楚」二、规格驱动开发的骨架一条从意图到代码的工件链一核心主张规格是源头代码是投影二四段工件链与五道质量闸门三它不是瀑布的还魂三点本质区别四工具生态一览三、第一次拆解把一句话需求变成用户故事一用户故事的三段式与 INVEST 判据二优先级就是交付顺序每个故事是一个可独立验收的切片三贯穿示例限时优惠券的故事集四、第二次拆解边界条件把「没想到」变成「写下来」一边界条件的五个来源二EARS 句式让需求可判定三边界条件归属故事而不是堆在附录五、第三次拆解验收标准与 Given-When-Then一合格验收标准的三个性质二Given-When-Then 的解剖与坏味道三从验收标准到可执行测试六、从规格到任务AI 可执行的颗粒度一先 plan 后 tasks技术上下文进场的时刻二tasks.md 的阶段结构与依赖排序三一个合格任务的六个要素七、质量闸门在生成之前拦住歧义一clarify有限次提问与答案回写二checklist 与 analyze跨工件一致性三converge让代码与规格重新对齐八、Java 团队的一次完整走查一从一句话到规格片段1、规格文件的四个区1.1 故事与场景区1.2 需求区1.3 成功判据区1.4 假设与排除区2、这份骨架的信息密度从哪来二从规格到任务清单三执行与阶段验证九、边界与反模式规格驱动不是万灵药一三类不值得走全流程的工作二四个高频反模式的识别指纹与对症治法规格剧场、过度澄清、规格写成设计文档与一次性大爆炸三一条可信的度量基线十、结语把「说清楚」变成工程资产参考资料干货分享感谢您的阅读编码智能体已经可以在几分钟内改完十几个文件、跑通测试、给出一个能运行的实现——但如果其做出来的东西是不是你要的东西大概率取决于你在开工之前把「要什么」说清楚到什么程度。生成的成本塌陷之后交付链上最贵的一环悄悄换了位置不再是写代码而是把一句模糊的业务愿望翻译成机器可以逐条核对的规格。这次我们把这次翻译拆成一条完整的流水线需求先拆成带优先级的用户故事故事之下钉住边界条件每个场景配上可判定的验收标准再把验收标准编译成测试资产最后按依赖排序生成 AI 可以逐个领走的任务。这条流水线在业界已经有了名字和成熟的工具形态——规格驱动开发Spec-Driven Development。这次以一个 Java 团队的真实颗粒度走完从「加个优惠券功能」到「任务清单可以委派」的全过程并在结尾给出这套方法不适用的场景与四个最常见的反模式。一、一句话需求的真实成本模糊为什么在生成时代更贵了一一句「加个优惠券功能」里藏着多少个决定产品经理在群里发了一句话「下个迭代加个限时优惠券用户领了以后下单能抵扣。」这句话在人类团队里可以工作因为接下这句话的工程师会在接下来的两周里用几十次口头确认把它补全。但如果把这句话原样丢给一个编码智能体它会在几分钟内替你做完所有你没做的决定。粗略数一下这句话至少悬空着这些问题优惠券限量吗超发了算谁的一个用户能领几张按什么维度去重「限时」限的是领取时间还是使用时间过期的券要不要清理抵扣能不能叠加有没有最低消费门槛订单取消或退款之后券是退回还是作废并发抢券的时候库存扣减在哪一层保证不超发领取接口被脚本刷了怎么办。每一个问题都对应一段必须存在的代码而每一个问题的答案模型都只能靠「行业里通常怎么做」来猜。猜测的结果不是不能用而是看起来能用。演示路径上一切正常边界路径上全是暗礁退款不回券、跨天场景用错时区、库存在缓存层和数据库层各扣了一次。这些缺陷不会在生成后的十分钟内暴露它们会在两周后的联调、一个月后的大促里逐个引爆而那时候修复它们的人需要先花几个小时搞清楚模型当初是怎么猜的。二口头澄清不留痕提示词编程的三个结构性缺陷有经验的工程师会说那我多写点提示词把这些都讲清楚不就行了。这个直觉方向是对的但「把要求写进聊天框」这个形态本身有三个修不好的结构性缺陷。第一个缺陷是上下文会蒸发。聊天里的第十七轮补充说明——「对了退款要把券退回去但只退未过期的」——在下一次会话开始时就不存在了。换一个模型、换一个同事、甚至只是第二天重开一个窗口这条约束都要重新说一遍而人不可能每次都记得说全。约束的存活周期等于会话的存活周期这是聊天框这个载体决定的与模型能力无关。第二个缺陷是没有可核对的验收面。提示词描述的是期望代码呈现的是结果两者之间没有一层可以逐条打勾的中间物。评审的人只能读代码倒推意图而读代码倒推意图恰恰是最贵的验证方式。当一次变更改了十几个文件时评审者实际上是在没有需求文档的情况下做验收。第三个缺陷是返工没有锚点。发现方向错了你能做的只有把聊天记录往上翻找到那个走岔的地方然后重新描述一遍。没有一个稳定的、版本化的「要什么」的定义每次纠偏都是从头再来。这就是很多团队体感的「AI 写得快但我们改得更久」的来源生成省下的时间被没有锚点的返工吃掉了。三成本重心的迁移从「写出来」到「说清楚」这三个缺陷在人类结对编程里同样存在只是从前被另一个成本掩盖了写代码本身太慢慢到口头澄清的损耗显得微不足道。当实现一个功能从三天变成三十分钟需求侧的模糊就从「可以容忍的背景噪音」变成了「交付链上最大的那笔开销」。METR 在 2025 年发布过一个被广泛引用的对照实验让熟悉自己代码库的资深开源开发者使用 AI 工具完成真实任务实测完成时间平均变长了 19%而参与者主观上认为自己快了 20%。主观加速与客观减速的差额大部分落在「说清楚要什么」和「确认做得对不对」这两头——工具压缩的只是中间那段打字时间。这组数字与其说是在否定工具不如说是在提示如果不改造需求进入和结果验收的方式光把生成变快总账未必是正的。所以问题的正确形态不是「怎么写更好的提示词」而是用什么载体承接需求才能让约束不蒸发、验收有依据、返工有锚点。这个载体需要是文件而不是聊天记录需要有结构而不是散文需要能被人评审也能被机器逐条核对。这就是规格驱动开发给出的答案。二、规格驱动开发的骨架一条从意图到代码的工件链一核心主张规格是源头代码是投影规格驱动开发Spec-Driven Development下文简称 SDD的核心主张只有一句话让「要什么」的定义成为版本库里的一等公民代码是它的投影而不是反过来。传统流程里需求文档写完就开始腐烂真正的「事实」逐渐迁移到代码里最后所有人都说「以代码为准」。SDD 把这个方向倒了过来规格文件spec与代码同库存放、同受版本管理、同走评审流程实现由规格生成验收对着规格核对需求变了先改规格再由规格驱动代码变更。OpenAI 的工程师 Sean Grove 在 2025 年一次广为流传的演讲里把这件事推到了极致——「未来最有价值的程序员是会写规格的人」因为当生成可以被无限复制时唯一稀缺的是对意图的精确表达。对 Java 工程师来说这个主张并不陌生它是几个熟悉事物的合流接口先行的契约式设计OpenAPI 写在实现之前、行为驱动开发的可执行规格Gherkin 场景直接跑成测试、以及领域驱动设计里「让语言精确」的执念。SDD 的新意不在思想而在闭环过去这些实践各管一段现在有了一个能读懂全部工件、并据此干活的执行者规格第一次可以从头到尾驱动交付。二四段工件链与五道质量闸门SDD 的主流形态——以 GitHub 开源的 Spec Kit 和 AWS 的 Kiro 为代表——把从意图到代码的路径固化成一条工件链每一段产出一份 Markdown 文件前一份是后一份的输入。主干四段依次是specify把自然语言需求固化成规格文件内容是带优先级的用户故事、每个故事的验收场景与边界条件、功能性需求清单、关键实体、假设与明确排除的范围——只写「做什么、为什么」不写「怎么做」plan技术上下文在这一步才进场把技术栈、架构约束、数据模型、接口契约写成实现计划tasks把计划切成依赖有序、颗粒度可验收的任务清单按阶段分组能并行的标记出来implement执行者按任务清单逐个领任务、写代码、跑验证、勾掉复选框。主干之外还有五道可选的质量闸门constitution在一切开始之前固化项目级的不可妥协原则比如「所有金额用 BigDecimal」「所有写接口必须幂等」clarify在规格成形后用有限次数的提问消解关键歧义checklist用清单核对规格质量analyze在任务生成后做跨工件的一致性检查converge在实现之后把代码与规格对照把发现的缺口写回任务清单。轻量的改动可以只走主干四段歧义重、风险高的功能才把闸门全部打开。三它不是瀑布的还魂三点本质区别「先写文档再写代码」很容易让人联想到瀑布模型以及那套被敏捷运动埋葬的重文档流程。SDD 与瀑布有三点本质区别值得逐一说清。第一工件是活的。瀑布的需求文档在签字后冻结与实现的偏差只会越来越大SDD 的规格与代码同库同版本converge 环节专门负责把两者的偏差找出来并消除——规格不是开工前的仪式而是全程在线的对账基准。第二周期是小时级的。瀑布的一轮是几个月SDD 的一轮是一个功能从 specify 到 implement小功能一天之内走完。它继承的其实是敏捷的小步快跑只是把每一步里「口头对齐」的部分换成了「写下来对齐」。第三文档是给机器读的。瀑布文档的读者是人写得再厚也只能靠自觉遵守SDD 的规格是执行者的直接输入写进去的边界条件会变成测试任务写进去的验收标准会变成核对清单。文档第一次有了「不写就真的不会发生」的执行力这反过来约束了写的人不能写空话因为空话会被忠实地执行成空实现。四工具生态一览把这套流程落到工具上2026 年的选择已经相当丰富。GitHub 的 Spec Kit 是目前最完整的开源实现提供specify命令行工具和一组/speckit.*斜杠命令宣称对接任意编码智能体AWS 的 Kiro 把同样的理念做成了 IDE 原生体验其规格默认采用「需求—设计—任务」三件套需求部分直接使用 EARS 句式后文详述Cursor、Claude Code 等工具则通过规则文件与技能机制支持团队自建 SDD 工作流把 specify、clarify、plan、tasks、implement、analyze 做成可复用的技能包。Thoughtworks 的技术雷达在 2025 年底将「规格驱动开发」列入评估象限同时提醒行业警惕「规格剧场」——这个反模式我们留到第九章。工具差异不影响本文的主线无论用哪一家你都要回答同样的四个问题——故事怎么拆、边界怎么钉、验收怎么判、任务怎么切。接下来四章依次展开。三、第一次拆解把一句话需求变成用户故事一用户故事的三段式与 INVEST 判据拆解的第一刀是把一句话愿望切成若干个用户故事作为某类用户我要做某件事以便获得某个价值。这个三段式看起来朴素但每一段都在逼问一个容易被跳过的问题——「作为谁」逼问受益方领券的是买家配置券的是运营对账的是财务三种人是三组故事「要做什么」逼问动作的完整闭环领取、使用、退回缺一个闭环就断「以便什么」逼问价值假设如果说不出「以便」这个功能大概率不该做。判断一个故事拆得好不好业界沿用 Bill Wake 提出的 INVEST 六判据独立Independent不依赖其他故事也能交付和验收、可协商Negotiable故事是对话的起点而非合同条款、有价值Valuable对某类用户有可感知的收益、可估算Estimable团队能大致估出工作量、足够小Small一个迭代内能完成、可测试Testable存在客观的完成判据。在 AI 执行的语境下六条判据里有两条的权重显著上升。一是独立编码智能体按故事领任务故事之间的隐式依赖会让它在缺少上下文的情况下修改公共代码独立性差的故事集是并行执行时互相踩踏的直接原因。二是可测试故事的完成判据会被编译成验收测试一个写不出判据的故事在 SDD 流水线上根本走不到 tasks 那一步——这是好事它把「不可验收」这个问题从交付后提前到了开工前。二优先级就是交付顺序每个故事是一个可独立验收的切片拆出故事之后的第二个动作是排优先级而 SDD 里的优先级不是「重要程度的表态」是字面意义上的交付顺序P1 故事构成最小可用切片做完就可以独立演示和验收P2 在 P1 之上叠加以此类推。任务清单会按这个顺序组织成阶段执行者做完一个阶段停下来过闸门再进入下一个。这个安排的价值在于止损点密集。如果第一个故事的实现就偏离了意图你在它验收时就会发现损失半天而不分故事、一次性生成整个功能的做法发现偏差时损失的是全部。把功能切成可独立验收的故事本质上是给生成过程装上了多个检查点——这与灰度发布控制爆炸半径是同一个思想在开发阶段的应用。排序时有一个常见错误值得点名把技术依赖当成优先级。「先做数据库表、再做服务层、最后做接口」是实现的分层不是价值的排序按这个顺序切出来的「故事」没有一个能独立验收。正确的做法是每个故事纵向切穿全部分层——P1「领取一张券」就包含它自己需要的表结构、服务逻辑和接口做完即可端到端验证。基础设施类的公共工作放进任务清单的 Foundational 阶段不冒充故事。三贯穿示例限时优惠券的故事集把「加个限时优惠券」按上述方法拆开会得到大致这样一组故事。P1 有两个「作为买家我可以领取一张限量的限时优惠券以便下单时抵扣」以及「作为买家我可以在下单时使用一张有效的优惠券以便少付钱」。这两个故事构成最小闭环——能领、能用缺一个都无法演示价值。P2 有两个「作为买家订单取消或退款后我的优惠券可以按规则退回以便不因订单失败而受损」「作为运营我可以创建和下架优惠券活动并设置库存、有效期与使用门槛以便控制营销成本」。注意退券故事在 P2 而不是 P1——不是因为它不重要而是因为它可以在领取与使用闭环验收之后独立叠加而且它的规则退回还是作废、过期券怎么办大概率需要一轮澄清。P3 是防护与对账「作为平台领取接口在异常流量下要限流与去重以便活动不被脚本刷爆」「作为财务我可以按活动导出核销明细以便结算与审计」。这组故事各自独立可验收、纵向切穿分层、判据可写。更重要的是拆的过程本身就是一次需求勘探原始那句话里根本没提退款、没提运营端、没提对账——它们是被「作为谁」这一问逼出来的。拆故事的产出不只是故事还有那些没拆之前根本不知道自己不知道的事。四、第二次拆解边界条件把「没想到」变成「写下来」一边界条件的五个来源故事描述的是阳光路径而生产事故几乎全部发生在阳光照不到的地方。边界条件的枚举不能靠灵感得靠清单。按照缺陷在企业系统里的实际分布边界条件有五个稳定的来源逐一过一遍就能覆盖绝大多数「没想到」。输入域的边界数字的零、负数、上限字符串的空、超长、特殊字符集合的空集与重复元素。优惠券场景里的对应物是抵扣金额恰好等于订单金额时实付是零还是报错、券面额大于订单金额时差额是否找零、一次请求携带多张券怎么处理。状态机的边界每个实体的状态迁移图里那些「不该发生但会到来」的迁移。未领取的券被使用、已使用的券被再次使用、已过期的券被退回、活动已下架但用户页面还缓存着领取按钮。状态机画出来之后每一条不存在的边都是一条必须写下来的拒绝规则。时间的边界过期判定用创建时间还是服务器当前时间、时区口径是哪个、活动开始那一秒的请求算不算、券在下单时有效但支付回调到达时已过期算不算有效。时间边界的特点是测试环境几乎复现不了不写进规格就等于不存在。并发的边界同一用户双击两次领取、两个请求同时核销同一张券、库存只剩一张时一千个请求同时到达。并发边界决定了实现层的锁与幂等设计它们不写在规格里执行者就会默认单线程世界。外部依赖的边界支付回调迟到、重复、乱序下游发券服务超时后到底发没发出去缓存与数据库不一致的窗口期。这一类边界的答案往往不是「怎么防」而是「怎么对账」同样必须显式写下。二EARS 句式让需求可判定枚举出边界之后怎么写也有讲究。自然语言的需求描述有两个顽疾一是含混「系统应该合理处理超发」——什么叫合理二是无触发「系统要保证库存准确」——在什么时机检查什么。罗尔斯·罗伊斯的需求工程师 Alistair Mavin 提出的EARS 句式Easy Approach to Requirements Syntax用五个模板治这两个病如今被 AWS Kiro 采纳为规格的默认需求语法。五个模板按触发方式分类普遍式——「系统应当〔始终成立的性质〕」用于无条件约束如「优惠券核销必须幂等」事件驱动式——「当〔触发事件〕时系统应当〔响应〕」如「当用户提交领取请求且库存大于零时系统应当原子地扣减库存并发放一张券」状态驱动式——「在〔状态〕期间系统应当〔行为〕」如「在活动暂停期间系统应当拒绝新的领取请求并返回明确的活动状态」可选特性式——「若配置了〔特性〕系统应当〔行为〕」如「若活动配置了单人限领数系统应当按用户维度累计领取次数并在超限时拒绝」非期望行为式——「如果〔异常条件〕系统应当〔兜底行为〕」如「如果支付回调到达时优惠券已过期系统应当按下单时刻的有效性判定并记录审计事件」。EARS 的价值不在句式本身而在它强迫每条需求都带上触发条件与可观察的响应——这正是「可判定」的最小构成。一条写成 EARS 的需求天然就是一个测试用例的骨架触发条件是测试的准备与动作应当的响应是断言。写不成 EARS 的需求多半是因为你还没想清楚它在什么时候、以什么方式被检验这个暴露本身就是收益。三边界条件归属故事而不是堆在附录最后一个容易做错的细节边界条件写在哪。常见的做法是在文档末尾开一章「异常处理」把所有边界堆进去——这个结构在 SDD 里是反模式因为任务清单按故事组织附录里的边界条件不属于任何故事也就不会被编译进任何故事的测试任务最终静静地烂在文档末尾。正确的归属是每条边界条件挂在它所考验的那个故事之下双击重复领取挂在领取故事下回调迟到挂在退券故事下脚本刷接口挂在防护故事下。这样切任务时每个故事的阶段自动携带自己的边界测试任务反过来一条挂不到任何故事下的边界条件说明故事集有漏洞——它在替你检查故事拆解的完整性。五、第三次拆解验收标准与 Given-When-Then一合格验收标准的三个性质用户故事回答「做什么」边界条件回答「哪里会坏」验收标准回答的是最终极的问题怎么算做完了。在人类交付里这个问题可以靠验收会议上的现场协商兜底在 AI 执行里没有协商环节验收标准的质量直接决定了「完成」这个词有没有含义。一条合格的验收标准要同时满足三个性质。可判定任何两个人或一人一机按同一条标准核对同一个结果结论必然一致——「响应要快」不可判定「查询接口在正常负载下 95 分位延迟低于 200 毫秒」可判定。独立于实现标准描述外部可观察的行为不描述内部结构——「用 Redis 的 DECR 扣库存」不是验收标准是实现方案「一千个并发领取请求下发放数量恰好等于库存数」才是前者会把实现锁死后者给优化留下空间。可自动化标准能被翻译成一段可重复执行的检查——不是所有标准都值得自动化但不可自动化的标准要显式标注为人工核对项并说明核对方法否则它会在流水线上被默默跳过。二Given-When-Then 的解剖与坏味道写验收标准的主流句式是 BDD 社区沉淀下来的Given-When-ThenGiven 铺设前置状态When 施加唯一的动作Then 断言可观察的结果。以优惠券的核销为例——Given 用户持有一张面额 20 元、未过期的券且订单金额 100 元满足使用门槛When 用户使用该券提交订单Then 订单实付 80 元券状态变为已使用且同一张券再次提交被拒绝。这个句式的力量在于三段的职责隔离Given 里只许有状态、不许有动作When 里只许有一个动作Then 里只许有断言、不许有新的操作。三条纪律各自防一种腐化——Given 里藏动作场景就变成了流程脚本When 里塞多个动作失败时无法定位哪一步坏了Then 里做操作断言和准备就搅在一起没法复用。实践里有四种高频坏味道值得贴在墙上。万能场景一个场景从注册写到退款横跨五个故事——拆。隐式断言「Then 一切正常」——「正常」必须展开成具体的可观察结果。实现渗漏「Then 数据库 coupon 表的 status 字段等于 2」——断言应该落在接口响应、领域事件这些外部可见面上表结构是实现细节。数据魔法Given 里出现「用户 42」「券 1001」这类只有写的人知道含义的魔法值——测试数据要么自解释「一张已过期的券」要么集中定义。三从验收标准到可执行测试验收标准写到可判定把它变成测试就只剩翻译工作——而翻译恰恰是编码智能体最擅长的事。这里的分工必须说清楚人负责判据机器负责翻译。让模型看着实现代码「补测试」它会把实现的现状包括缺陷忠实地断言下来测试全绿但毫无效力让模型看着验收标准写测试断言来自独立于实现的判据源这才是有效力的测试。这就是「判据先行」的含义——判据的来源必须独立于被验证的产出否则验证只能证明自洽不能证明正确。落到 Java 技术栈映射关系大致是故事级的验收场景翻译成 Spring Boot 的切片测试或以 Testcontainers 起真实依赖的集成测试一个 Given-When-Then 对应一个测试方法命名直接采用「方法名_条件_预期结果」的约定边界条件里输入域类的适合交给 JUnit 5 的参数化测试批量覆盖并发与时序类的边界用多线程测试或 Awaitility 显式构造「核销幂等」「发放数不超库存」这类普遍式约束则值得升格为属性测试jqwik或一条常驻的线上不变式校验。测试资产按故事组织进对应阶段的任务里跟着故事一起验收。值得强调的是顺序颠倒带来的质变传统流程里测试是实现之后的补课SDD 里测试骨架在实现之前就已经由验收标准确定。执行者写代码时判据已经立在那里——这接近测试驱动开发的纪律只是「先写测试」这一步从美德变成了流水线的结构性产物不再依赖个人自觉。六、从规格到任务AI 可执行的颗粒度一先 plan 后 tasks技术上下文进场的时刻规格刻意不谈技术但任务不能不谈——「实现领取接口」这句话在 Spring Boot 单体和微服务网格里对应的动作完全不同。所以规格与任务之间隔着一层plan把技术栈、现有代码结构、数据模型、接口契约、关键设计决策写成实现计划。plan 的第一条纪律是基于现状而不是理想。计划必须建立在仓库真实的模块结构、既有的框架版本、团队的编码规范之上——这也是为什么成熟的 SDD 工具在 plan 阶段会先扫描仓库再落笔。给优惠券功能做计划要回答的是券表建在哪个库、库存扣减用现有的哪个分布式锁组件、领取接口挂在哪个已有的网关路由下、事件用团队现成的 Outbox 机制还是直发。这些答案写下来执行者就不会引入第二套锁组件、第三种事件风格——plan 本质上是在约束生成的自由度把「怎么做都行」压缩成「按这个做」。第二条纪律是一处定义。数据模型、状态机、接口契约各自只在一个地方定义其他地方引用不复制。复制的规格必然漂移漂移的规格比没有规格更危险因为它带着权威的外表。二tasks.md 的阶段结构与依赖排序任务清单是整条流水线上最像「工程图纸」的一份工件。成熟的组织方式是按阶段分组Setup阶段做脚手架依赖引入、配置、数据库迁移文件Foundational阶段做所有故事共享的地基券实体与状态机、库存组件的接入——这个阶段不产出用户可见价值但它是后续所有故事的前置然后每个用户故事一个阶段按优先级排序P1 故事的阶段做完系统就处于「最小闭环可演示」状态最后Polish阶段收尾横切事项文档、监控埋点、性能核对。每个任务一行带三样标记编号T001、可并行标记[P]仅当两个任务不碰同一个文件、不存在依赖时才允许、所属故事标签[US1]。任务描述必须落到具体动作加确切文件路径——「T012 [US1] 在 CouponService 中实现领取的库存原子扣减修改 src/main/java/.../CouponService.java按规格 R3 的并发边界补充单元测试」。模糊的任务「完善优惠券逻辑」对人是偷懒对机器是事故执行者会自行解释「完善」的含义然后把解释执行出来。阶段之间有闸门一个阶段的全部任务完成、该阶段的验证编译、单测、该故事的验收测试通过才进入下一阶段。闸门是止损点的工程化偏差最多存活一个阶段。三一个合格任务的六个要素把颗粒度的经验压缩成一张检查卡一个可以放心委派给编码智能体的任务应当具备六个要素单一目标——一句话说得清做什么做不到就拆确切落点——涉及哪些文件与模块写明路径输入引用——它实现的是规格里哪条需求、哪个场景用编号引用而不是复述复述会漂移完成判据——跑哪个测试、看哪个断言算过依赖声明——它前面必须完成什么能否与谁并行预估边界——改动大致规模超出预估两倍时执行者应停下来报告而不是继续挖。六要素齐备的任务对执行者来说是一个上下文自洽的封闭问题——这正是当前编码智能体最能发挥的问题形态。反过来委派失败的复盘几乎总能归因到某个要素的缺失没有完成判据的任务做完了没人知道对不对没有依赖声明的任务并行时互相覆盖没有预估边界的任务在错误的方向上越挖越深。七、质量闸门在生成之前拦住歧义一clarify有限次提问与答案回写规格初稿写完第一道闸门是澄清。这一步的工程要点不是「多问」恰恰是限制提问成熟的 SDD 实现普遍把澄清约束在最多三到五个问题且只问对架构、数据模型、任务拆分或验收有实质影响的事其余一律采用行业默认值并在假设区显式记录。这个限制背后是一个容易被忽视的成本提问是有价格的。每一个抛回给业务方的问题都消耗对方的注意力与响应时间问题太多太碎对方要么敷衍要么拖延澄清环节自己变成瓶颈。所以要用「建议默认值加影响说明」的方式提问——「单人限领数未指定。建议默认每人一张A每人一张防刷简单B每人可配置多张运营灵活但风控复杂。选哪个」这样的问题三十秒可以回答而开放式的「限领怎么搞」需要对方开一个会。澄清的第二个要点是答案必须回写。回答散落在群聊里等于没回答每个答案要立刻更新进规格的对应章节并在澄清记录区留一条带日期的问答存档。规格文件是唯一真相源这个纪律在澄清环节最容易被破坏也最值得守住。二checklist 与 analyze跨工件一致性第二道闸门核对规格自身的质量第三道闸门核对工件之间的一致性。checklist 是一份针对规格的核对清单每个故事有没有验收场景、边界条件有没有归属故事、需求有没有编号、假设与排除范围有没有写、有没有残留的待澄清标记。它挡住的是「写了但没写完」。analyze 更进一步做跨工件的交叉检查规格里的每条需求在任务清单里有没有对应任务漏实现、任务清单里的每个任务能不能回溯到某条需求幽灵任务、计划里的数据模型与规格里的关键实体是否同名同义术语漂移、三份文件对同一个概念的表述是否一致。这类检查机械而繁琐正适合交给模型做——它是整条流水线里少数几乎不需要人类判断力、纯靠细心的环节。analyze 的产出是一份只读报告不一致清单、覆盖缺口、就绪风险。原则上 analyze 自己不改任何工件——发现问题与修复问题分离修复由人决定方向后再执行避免检查器顺手把两份文件改成一致但都是错的。三converge让代码与规格重新对齐实现完成不是终点最后一道闸门在代码落地之后把代码库对照规格、计划与任务清单重新检查一遍——规格里的需求是否都有对应实现、验收场景是否都有对应测试且通过、有没有代码实现了规格里不存在的行为。发现缺口不是直接改代码而是把缺口追加为新任务再走一轮 implement循环直到收敛。这个环节治的是 SDD 最大的长期风险规格与代码的漂移。紧急修复直接改了代码没回写规格、评审时口头同意的小调整没进文档、模型在实现时「顺手优化」了一个规格没提的行为——漂移的来源全是日常。converge 把「对账」做成流程的固定动作而不是年度专项漂移最多存活一个功能周期。对 Java 团队来说converge 还有一个务实的抓手把规格里的普遍式约束幂等、金额精度、状态机合法迁移沉淀成 ArchUnit 规则与属性测试让一部分对账从「每轮人肉跑」变成「每次构建自动跑」。八、Java 团队的一次完整走查一从一句话到规格片段把前面的方法串起来用优惠券案例走一遍最小闭环。输入还是那句话「下个迭代加个限时优惠券用户领了以后下单能抵扣。」specify 产出的规格文件骨架如下。1、规格文件的四个区1.1 故事与场景区四个故事按 P1 到 P3 排列每个故事下挂验收场景与边界条件。以 P1 领取故事为例验收场景三条正常领取成功、库存为零时领取被拒且提示明确、重复领取被幂等拒绝边界条件五条双击并发、活动未开始、活动已下架但页面缓存、单人限领超限、库存最后一张的并发竞争。1.2 需求区EARS 句式的编号需求。R1事件驱动当用户提交领取请求且活动进行中且库存大于零且用户未超限领时系统应当原子地扣减库存并发放一张属于该用户的券。R2非期望行为如果库存扣减成功但券写入失败系统应当回滚库存并返回可重试错误。R3普遍式领取与核销操作必须幂等同一请求重复到达不产生第二次副作用。R4状态驱动在活动暂停期间系统应当拒绝新领取并保留已发放券的正常使用。1.3 成功判据区上线后可度量的口径大促期间发放数恒不超过配置库存核销率、退回率可按活动导出领取接口 95 分位延迟低于 200 毫秒。1.4 假设与排除区显式假设券不可叠加使用、面额券不找零、有效期按服务器时区计算。明确排除折扣券与满减券本期不做、券转赠不做。待澄清仅一项退款后已过期券的处理建议默认作废等业务确认。2、这份骨架的信息密度从哪来对比原始那句话规格多出来的每一行都有明确的来源故事来自「作为谁」的追问边界来自五来源清单的逐项扫描需求句式来自 EARS 模板的强制填空假设区来自「采用默认值但必须留痕」的纪律。没有一行靠灵感——这是这套方法对普通团队最友好的地方它把「想周全」从个人天赋变成了清单作业。二从规格到任务清单plan 基于仓库现状给出技术落点券与库存表建在订单库、复用团队现有的 Redis 原子扣减组件、领取接口挂在已有的营销网关、状态变更事件走现成的 Outbox。tasks 随后产出大约二十个任务、五个阶段Setup 三个任务迁移脚本、配置、依赖Foundational 四个券实体与状态机、库存组件接入、防重幂等键设计、Testcontainers 基座US1 领取故事六个接口、服务、并发扣减、三条验收测试、五条边界测试、限流接入US2 使用故事五个Polish 三个监控埋点、文档、ArchUnit 规则。每个任务带编号、故事标签、文件路径与完成判据能并行的标了 [P]。到这一步原始需求已经变成了一份编码智能体可以逐个领走的工单每个工单上下文自洽、判据齐备、次序明确。人的角色从「解释需求的人」变成了「签发工单的人」。三执行与阶段验证implement 按阶段推进。Foundational 完成后跑一次全量验证编译、既有测试无回归、新增单测通过。US1 阶段完成后除了单测还要跑该故事的三条验收测试与五条边界测试——其中「库存最后一张的并发竞争」用多线程测试构造一千个并发请求断言发放数恰好等于一。任一闸门失败执行者在当前阶段内修复不带病进入下一阶段。全部阶段完成后跑 converge对照规格逐条核对发现 R4活动暂停语义的实现只拦了领取没保留使用——这正是规格写了「保留已发放券的正常使用」而实现漏了后半句的典型漂移。缺口追加为新任务再走一小轮收敛完成。整个功能从一句话到可验收的实现规格与澄清约占全程人力的一半——这个比例初看吓人但对照第一章的账本这一半正是从「两周后联调返工」那笔账里预付过来的预付的价格远低于事后。九、边界与反模式规格驱动不是万灵药一三类不值得走全流程的工作任何方法论最诚实的部分是它的适用边界。SDD 的全流程有固定开销——写规格、过闸门、维护工件这笔开销只有在它换回的返工节省更大时才划算。三类工作明确不划算。探索性原型。当你自己都不知道要什么、做原型就是为了搞清楚要什么时先写规格是本末倒置——规格描述的是已经想清楚的意图而原型的任务是帮你想清楚。这类工作适合放开手脚快速生成、快速丢弃等方向收敛了再用 SDD 固化。判据很简单这段代码是打算留下来的吗不留下来的代码不配规格。改动半径极小的修补。改一行配置、修一个明确的空指针、调一段文案走 specify 到 converge 的全流程是官僚主义。这类工作要的是快速验证回路测试、评审不是工件链。多数 SDD 工具也承认这一点为小改动保留了轻量路径。判据无法外化的工作。视觉调优、文案打磨、交互手感——这些工作的验收标准本质上是「负责人看了说行」强行写成可判定规格只会产出一堆伪精确的指标。诚实的做法是把它们标注为人工验收项而不是假装它们能被自动核对。反过来越靠近以下画像的工作越值得全流程多人协作、生命周期长、边界条件密集、出错代价高、需要多轮委派给编码智能体。企业级 Java 后端的核心业务模块几乎条条命中。二四个高频反模式的识别指纹与对症治法规格剧场、过度澄清、规格写成设计文档与一次性大爆炸方法落地时坏掉的方式往往比方法本身更有规律。四个反模式覆盖了实践中的绝大多数翻车现场。规格剧场。团队认真地写规格、评审规格、归档规格然后照着自己的旧习惯写代码——规格与实现从第一天起就是两条平行线。Thoughtworks 在技术雷达里对 SDD 的核心担忧正是这个仪式感齐全闭环不存在。识别方法只需一个问题上一次因为规格不过关而拦下实现是什么时候答不上来就是剧场。治法是把闸门做成硬约束——验收测试不过不许合并converge 有缺口不许上线。过度澄清。把「消解歧义」执行成「消灭一切不确定」二十个问题抛给业务方规格环节耗时超过实现环节的三倍业务方从此绕开这个流程。治法是回到有限提问的纪律只问影响架构与验收的问题其余用默认值加假设留痕。假设区的存在就是为了让你不必问全。规格写成设计文档。规格里出现了表结构、缓存策略、类图——技术细节过早进场一方面把实现锁死在写规格那天的认知上另一方面业务方彻底读不懂评审形同虚设。what 与 how 的分层不是洁癖是为了让两类读者各自能在自己那份工件上行使判断力。一次性大爆炸。把三个月的需求写成一份两百页的规格再开工——这是披着 SDD 外衣的瀑布。规格的正确颗粒度是「一个功能」工件链的正确节奏是「一条链几天走完」。规格越大澄清越滞后converge 越无从下手。三一条可信的度量基线最后是度量。推行 SDD 的团队最容易犯的错误是用「规格覆盖率」「工件完整度」这类过程指标自证成功——过程指标只能证明流程被执行了不能证明流程有收益。可信的度量要落在结果侧返工率合并后因需求理解偏差被打回重做的变更占比、缺陷逃逸验收之后才暴露的边界类缺陷数量、委派成功率交给编码智能体的任务一次通过阶段闸门的比例、规格漂移存量converge 每轮发现的缺口数是否收敛。基线的另一半是诚实地计入成本规格与澄清消耗的人时要记账而不是当成免费。METR 那组「主观快 20%、客观慢 19%」的数字提醒的正是这件事——关于效率的体感不可信账要真的算。如果三个月后返工率与缺陷逃逸没有下降问题通常不在方法而在闭环没有真正建立回头检查四个反模式多半能对上号。十、结语把「说清楚」变成工程资产回头看全文走过的路径一句模糊的业务愿望经过四次结构化的拆解——拆成带优先级的用户故事、钉住五类来源的边界条件、写成可判定的验收标准、编译成判据先行的测试资产——最后变成一份编码智能体可以逐个领走、逐个验收的任务清单。中间穿插五道闸门把歧义、漂移与缺口分别拦在生成之前、之中与之后。这条流水线上没有任何一个环节是新发明用户故事与 INVEST 来自二十多年前的敏捷实践EARS 来自航空发动机行业的需求工程Given-When-Then 来自行为驱动开发任务分解与阶段闸门来自任何一本项目管理教材。SDD 做的事情是把它们焊接成一条由机器执行、为机器供料的闭环——过去这些实践产出的文档给人读人可以脑补缺失的部分所以写得潦草也能工作现在它们的读者是一个不会脑补、只会忠实执行的智能体每一处含混都会变成代码里的一次掷硬币。所以规格驱动开发的本质是把过去散落在会议室、聊天记录和资深工程师脑子里的隐性知识逼进版本库变成显性资产。这件事的收益甚至不完全依赖 AI一份边界写全、判据可核的规格对下一个接手的人类同事同样是礼物。生成时代只是把这笔账放大到了无法再赖账的程度——模型写代码的速度越快你说清楚「要什么」的能力就越值钱。这项能力不神秘拆故事有三段式钉边界有五来源写判据有三性质切任务有六要素。全是清单作业练三个功能就能上手而它大概率是未来几年里需求与代码之间那段路上最保值的手艺。参考资料GitHub Spec Kit开源的规格驱动开发工具包Spec Kit 官方文档快速上手指南Spec Kit 文档/speckit.* 命令的完整参考GitHub 官方博客用 Spec Kit 开始规格驱动开发AWS Kiro面向规格驱动开发的智能体 IDEKiro 文档规格需求—设计—任务三件套的概念Alistair MavinEARS 需求句式官方站点Bill WakeINVEST 判据的原始文章Mike Cohn用户故事写作指南Dan NorthIntroducing BDD行为驱动开发的开山文章Martin FowlerGivenWhenThen 句式Martin FowlerSpecification by Example实例化需求Gojko Adzic《Specification by Example》一书Cucumber 官方文档Gherkin 语法参考METR2025 年 AI 工具对资深开源开发者效率影响的随机对照实验Sean GroveOpenAIThe New Code——规格是新的代码AI 工程师大会演讲Thoughtworks 技术雷达Spec-driven development 条目OpenAPI 规范接口先行的契约定义jqwikJava 属性测试框架Testcontainers以真实依赖运行集成测试ArchUnit把架构约束写成可执行测试JUnit 5 官方文档参数化测试
企业数字化 ERP 产品动态
相关推荐
OpenMausBot安全设计详解:密钥write-only、配对机制与回环信任边界 OpenMausBot安全设计详解:密钥write-only、配对机制与回环信任边界 【免费下载链接】OpenMausBot Open-source Grok Bot alternative with a virtual machine that bots can use 项目地址: https://gitcode.com/GitHub_Trending/op/OpenMausBot
OpenMausBot … · 2026/11/21 6:31:41
34 秒 vs 122 秒:Jasna 视频马赛克修复为什么值得等一小时首编? 34 秒 vs 122 秒:Jasna 视频马赛克修复为什么值得等一小时首编? 【免费下载链接】jasna Video restoration tool 项目地址: https://gitcode.com/GitHub_Trending/ja/jasna
第一次任务的进度条卡在模型编译最长一小时,像死机。编完&am… · 2026/11/4 22:30:30
之前考的证在外省能不能转过来 电工证国考证书真实经历告诉你怎么办 之前考的证在外省能不能转过来 电工证国考证书真实经历告诉你怎么办 之前考的证在外省能不能转过来?这事儿我之前就遇到过,朋友小王也是,他在江苏考的低压电工证,后来回河南郑州金水区工作,结果发现证过不了审,差点耽误了项目。这不是个例,很多跨省工… · 2026/11/21 6:31:33
米易哪点能考电工证,真实经历告诉你怎么复审延期 米易哪点能考电工证,真实经历告诉你怎么复审延期 证书过期了不知道怎么复审延期,这是很多电工同行最怕的事。我有个同事,电工证到期后没及时办理延期,结果被公司直接辞退,项目也被停工整改。这事儿不是个例,真实经历摆在那儿,得重视。… · 2026/11/21 6:31:33
鱼台什么地方办电工证多少钱?实操考试心里没底怕挂科 鱼台什么地方办电工证多少钱?实操考试心里没底怕挂科 实操考试心里没底怕挂科,尤其是像你这样在鱼台准备报考电工证的朋友们,担心自己考不过、怕浪费钱,这种焦虑我们太懂了。其实,电工证考试并不像你想象的那么难,只要准备到位、流程清楚, 多少钱… · 2026/11/21 6:31:33
特种工操作证报考费用值不值得考?学历不高怕报不上名怎么办 特种工操作证报考费用值不值得考?学历不高怕报不上名怎么办 你是不是也这样想:自己学历不高,担心报不了名,特种工操作证报考费用到底值不值得考?其实很多人跟你想的一样,但真要干这行,这证还真绕不过去。… · 2026/11/21 6:31:33
丰镇哪里可以考电工证良心建议:怕考不过白交培训费?这篇讲透了 丰镇哪里可以考电工证良心建议:怕考不过白交培训费?这篇讲透了 怕考不过白交培训费?你不是一个人。现在考电工证,很多人就怕花了钱,结果还是没通过,白忙一场。尤其是像丰镇这样的地方,考电工证渠道太多,真假难辨,稍不注意就踩坑。这篇文章是… · 2026/11/21 6:31:33
三门峡建筑工人实操考试怕挂科?登高架设证怎么报名一步到位 三门峡建筑工人实操考试怕挂科?登高架设证怎么报名一步到位 实操考试心里没底怕挂科,这事儿我懂。尤其是像你这种在三门峡干建筑的,每天扛着架子、搭着脚手架,手里攥着的不是工资单,而是一张 上岗必备… · 2026/11/21 6:30:33
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32
电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 你是不是也担心自己学历不高, 怕报不上名 ?尤其是像焦作水利工程这样的从业者,常年在一线作业,但证书却成了晋升、转岗、接项目的关键门槛。 2026河南最新政策… · 2026/11/21 0:00:17
电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 不知道去哪报名怕被中介坑,电工证征求意见填错了不仅白费钱,还可能影响后续考试和工作。最近很多济源的电工朋友都在问: 电工证征求意见怎么填… · 2026/11/21 0:00:17
房建企业特种工考前押题怎么找?别让培训费打了水漂 房建企业特种工考前押题怎么找?别让培训费打了水漂 怕考不过白交培训费?房建企业特种工考试难度高、题型多,很多人报名后才发现没有合适的复习资料,最终考试落榜,白白浪费了时间和金钱。别担心,掌握【考前押题】的技巧,能让你事半功倍,顺利通过考试。… · 2026/11/21 0:00:17
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03