规范驱动开发
在编码前把模糊需求转化为可验证的开发规范。
技能要求先澄清假设、人工审查各阶段,并定义 Always/Ask first/Never 边界;这支持一定的权限约束、用户确认和回滚意识。未说明敏感数据处理、外部副作用、依赖安全、数据流披露或具体恢复机制,且发布者身份未获 FollowSkills 验证,因此扣分。
流程阶段、模板、检查清单和失败前置条件较为一致,仓库 CI 也验证技能结构与触发评估。静态材料没有复现该技能关键路径的执行记录,异常输入、无法获得人工确认或引用技能缺失时的诊断反馈不足;按静态校准不超过 10 分。
适用场景和不适用场景写得清楚,触发条件包括新项目、重大变更和模糊需求。未明确输入输出契约、语义触发边界、中文使用指导或大陆网络环境适配;流程还依赖若干其他技能和命令约定,因此扣分。
文档结构清晰,包含概览、适用条件、分阶段流程、模板、反合理化表和验证项,并提供渐进式披露的引用。缺少该技能自身的版本、变更日志、维护责任和更新路径,安装与依赖说明主要位于仓库 README,故扣分。
该技能能直接产出规格、计划、任务和验收标准,对需求澄清和减少返工有明确价值。输出仍依赖人工审查、其他技能和项目命令,且文件写入及实际实现效果未由所给材料直接证明;静态校准下给出接近上限但不满分的结果。
技能提供了六部分规格模板、成功标准和实施前检查项,仓库还提供 CI、技能验证及触发评估流程。所给测试样例与本技能关键路径无关,也没有第三方执行证据或独立交叉验证,因此只能给予有限静态可验证性。
- 引用的 planning-and-task-breakdown、incremental-implementation、test-driven-development 和 context-engineering 技能未在本次材料中提供,实际执行一致性无法确认。
- 技能要求人工逐阶段确认,但未定义超时、拒绝、无权限写入 tasks/ 文件或命令失败时的明确恢复路径。
- 未说明敏感信息、凭据、专有需求内容在规格和提交中的处理规则。
这个 Skill 能做什么,适合哪些场景?
该技能要求在新项目、功能或重大变更开始编码前,先编写结构化规范。它通过澄清问题、公开假设和定义成功标准,建立人与工程师之间的共同事实来源。规范获人工确认后,再生成技术计划、任务清单并进入实现阶段。对于单行修复、拼写修正或需求明确的小改动,不建议使用。
识别适用场景;提出澄清问题并列出假设;生成包含目标、技术栈、命令、项目结构、代码风格、测试策略、边界、成功标准和开放问题的规范;将模糊要求改写为具体、可测试的成功标准;在规范确认后生成技术实施计划和任务清单,并将计划保存到tasks/plan.md、任务清单保存到tasks/todo.md;要求在实现前确认规范已由人工审阅并保存到仓库。
- 负责新项目的工程师需要在写代码前明确目标、技术栈、目录结构和验收条件。
- 面对描述模糊或不完整的功能需求,开发者需要先暴露假设并获得人工确认。
- 涉及多个文件或模块的重大变更,需要先拆解依赖、风险、顺序和验证节点。
- 即将进行架构决策时,团队希望把边界、成功标准和开放问题记录下来。
这个 Skill 有哪些优点和局限?
- 覆盖目标、命令、结构、风格、测试和边界六个核心区域。
- 要求公开假设,并把模糊要求转为具体、可测试的成功标准。
- 通过Specify、Plan、Tasks、Implement四阶段和人工审核形成明确闸门。
- 支持持续更新规范,并要求将其与代码一起纳入版本控制。
- 对单行修复和明确的小改动而言,完整流程可能增加不必要的开销。
- 实现阶段依赖仓库中的其他技能,如增量实现和测试驱动开发;本技能本身不定义完整的编码或测试流程。
- 源材料未提供该技能的独立自动化测试或跨客户端验证证据。
如何安装这个 Skill?
该技能位于GitHub仓库addyosmani/agent-skills的skills/spec-driven-development/SKILL.md。安装整个技能集合可运行:npx skills add addyosmani/agent-skills。也可仅安装本技能:npx skills add addyosmani/agent-skills --skill spec-driven-development。README未说明其他客户端的单技能安装步骤。
如何使用这个 Skill?
在兼容Agent Skills的编码代理中触发spec-driven-development,或提出类似“我要开始一个新功能,请先帮我编写规范,不要写代码”的请求。先完成规范并等待人工审阅;确认后生成tasks/plan.md和tasks/todo.md,再进入实现。
这个 Skill 与同类方案有什么区别?
README提到Superpowers和Matt Pocock's skills,但所提供材料没有给出具体对比结论。