规格驱动开发是一个面向项目与功能启动阶段的工作流技能。它在以下情况被触发:新项目或新功能开始、需求不清晰、变更涉及多个模块,或任务预计超过约30分钟。它不用于“按已有规格实现”,那属于另一类工作。
用途与核心思路 该技能的核心是先固化规格、再计划、再拆任务、最后实现。它把人工批准作为每个阶段的闸门:规格、计划、任务清单都必须由人审阅并批准后才能进入下一阶段。技能的完成条件是:一份覆盖六个方面的、经审阅批准的规格保存在仓库中,实现严格遵循该规格。
六项规格内容
- 目标:构建什么、为什么、用户是谁、成功标准。
- 命令:项目实际技术栈的完整可执行命令及参数(构建、测试、lint、dev),要求记录精确命令而非工具名。
- 项目结构:源码、测试、文档各自位置。
- 代码风格:给出项目真实风格片段,包含命名约定、格式规则和一个被接受的示例。
- 测试策略:勾勒功能将被测试的接缝,优先复用现有接缝、使用最高可用接缝;记录框架、测试位置、覆盖率期望,以及各关注点由哪一测试层级覆盖;接缝需先与用户确认,因为接缝分歧会使测试策略失效。
- 边界:三档——总是(提交前跑测试、遵守命名、校验输入)、先问(改 schema、加依赖、改 CI 配置)、绝不(提交密钥、编辑 vendored 目录、未经批准删除失败测试)。
使用方式与流程 第一步先列出所有假设并要求明确纠正,不得静默填补模糊需求。然后撰写覆盖上述六方面的规格并交人审阅批准。接着从规格生成计划(组件、依赖、顺序、风险与缓解、并行/串行划分、验证检查点),再交人批准。之后把计划拆成离散任务:每个任务可在一个专注时段内完成、有明确验收标准、包含验证步骤、按依赖排序、改动不超过约5个文件,再次交人批准。实现阶段采用“攻击优先”的 TDD,一次一个任务:把验收标准转成必须因正确原因变红的攻击,实现到攻击不再破坏代码,绝不为了变绿而修改测试或夹具,然后对照验收标准验证。只加载当前任务需要的规格章节和源文件。
拒绝与停止条件 人未批准时不得推进,需指出具体异议并等待;实现中途范围扩大要停下回到规格、更新并获批后再继续;规格写完后浮现假设要立即提出,解决或获批前不推进;没有写下并保存规格则不满足完成条件,不得实现任何内容;若人始终不批准,技能以“无实现”结束并明确说明。决策变更时先更新规格再实现,最终规格与代码一同提交版本控制,并在每个 PR 中引用规格。
适用场景与限制 适用于新项目/新功能起步、需求模糊、跨模块变更等需要先明确契约与边界的场景;产品名称、收费、平台支持、效果指标等事实暂未提供。其权威范围是可逆的本地操作:只写当前工作树范围内的文件与版本控制,回滚依赖版本控制,不进行远程变更、不暴露凭据、不做不可逆操作。