开发与工程 spec-writingrequirements-analysisproject-planningacceptance-criteriahuman-review-gates

规范驱动开发

在编码前把模糊需求转化为可验证的开发规范。

FollowSkills 评估 · FSRS-2.0
不推荐
55/ 100 五分制 2.8 / 5
信任安全18 / 25 · 3.6/5

技能要求先澄清假设、人工审查各阶段,并定义 Always/Ask first/Never 边界;这支持一定的权限约束、用户确认和回滚意识。未说明敏感数据处理、外部副作用、依赖安全、数据流披露或具体恢复机制,且发布者身份未获 FollowSkills 验证,因此扣分。

可靠稳定8 / 20 · 2.0/5

流程阶段、模板、检查清单和失败前置条件较为一致,仓库 CI 也验证技能结构与触发评估。静态材料没有复现该技能关键路径的执行记录,异常输入、无法获得人工确认或引用技能缺失时的诊断反馈不足;按静态校准不超过 10 分。

适用触发11 / 15 · 3.7/5

适用场景和不适用场景写得清楚,触发条件包括新项目、重大变更和模糊需求。未明确输入输出契约、语义触发边界、中文使用指导或大陆网络环境适配;流程还依赖若干其他技能和命令约定,因此扣分。

规范维护8 / 15 · 2.7/5

文档结构清晰,包含概览、适用条件、分阶段流程、模板、反合理化表和验证项,并提供渐进式披露的引用。缺少该技能自身的版本、变更日志、维护责任和更新路径,安装与依赖说明主要位于仓库 README,故扣分。

有效结果6 / 15 · 2.0/5

该技能能直接产出规格、计划、任务和验收标准,对需求澄清和减少返工有明确价值。输出仍依赖人工审查、其他技能和项目命令,且文件写入及实际实现效果未由所给材料直接证明;静态校准下给出接近上限但不满分的结果。

证据核验4 / 10 · 2.0/5

技能提供了六部分规格模板、成功标准和实施前检查项,仓库还提供 CI、技能验证及触发评估流程。所给测试样例与本技能关键路径无关,也没有第三方执行证据或独立交叉验证,因此只能给予有限静态可验证性。

证据充分度: 评估于 2026年7月20日 审查版本 2fbfa004a019
使用前请注意
  • 引用的 planning-and-task-breakdown、incremental-implementation、test-driven-development 和 context-engineering 技能未在本次材料中提供,实际执行一致性无法确认。
  • 技能要求人工逐阶段确认,但未定义超时、拒绝、无权限写入 tasks/ 文件或命令失败时的明确恢复路径。
  • 未说明敏感信息、凭据、专有需求内容在规格和提交中的处理规则。
评估证据 [1][2][3][4][5]
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

该技能要求在新项目、功能或重大变更开始编码前,先编写结构化规范。它通过澄清问题、公开假设和定义成功标准,建立人与工程师之间的共同事实来源。规范获人工确认后,再生成技术计划、任务清单并进入实现阶段。对于单行修复、拼写修正或需求明确的小改动,不建议使用。

识别适用场景;提出澄清问题并列出假设;生成包含目标、技术栈、命令、项目结构、代码风格、测试策略、边界、成功标准和开放问题的规范;将模糊要求改写为具体、可测试的成功标准;在规范确认后生成技术实施计划和任务清单,并将计划保存到tasks/plan.md、任务清单保存到tasks/todo.md;要求在实现前确认规范已由人工审阅并保存到仓库。

  1. 负责新项目的工程师需要在写代码前明确目标、技术栈、目录结构和验收条件。
  2. 面对描述模糊或不完整的功能需求,开发者需要先暴露假设并获得人工确认。
  3. 涉及多个文件或模块的重大变更,需要先拆解依赖、风险、顺序和验证节点。
  4. 即将进行架构决策时,团队希望把边界、成功标准和开放问题记录下来。

这个 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,但所提供材料没有给出具体对比结论。

常见问题

这个技能适合所有代码变更吗?
不适合。它明确面向新项目、新功能、需求不清、跨多个文件或模块,以及超过约30分钟的重大变更;单行修复、拼写修正和需求明确的小改动通常不需要它。
规范必须由谁确认?
每个阶段都要求human reviews;进入实现前,必须确认规范已由人审阅批准,并已保存到仓库。
它会直接修改代码吗?
该SKILL.md主要定义规范、计划和任务拆分流程。实现阶段要求遵循其他实现和测试技能,但本技能文本没有提供具体编码实现步骤。
安装需要付费服务或网络调用吗?
源材料只提供通过npx skills add安装技能集合或单个技能的命令,并未说明费用、权限或运行时网络调用。

同仓库的其他 Skills

均来自 addyosmani/agent-skills

开发与工程

规划与任务拆解

将明确需求拆分为有依赖顺序、可实现且可验证的工程任务。

开发与工程

合并前代码质量审查

在合并前从正确性、可读性、架构、安全性和性能五个维度审查代码变更。

开发与工程

工程技能导航器

根据任务阶段发现并调用合适的工程工作流技能。

开发与工程

需求访谈助手

在规划或编码前,通过逐题访谈确认用户真正想解决的问题。

开发与工程

代码简化审查

在不改变行为的前提下,降低代码复杂度并提升可读性与可维护性。

开发与工程

性能优化工程技能

通过测量、定位和验证,系统解决前端、后端、查询与数据库性能瓶颈。

开发与工程

怀疑驱动开发

在非平凡决策落地前,用新上下文主动寻找错误。

开发与工程

Idea Refine 创意打磨

把模糊想法转化为经过验证、可执行的产品方向。

开发与工程

上下文工程指南

帮助编码代理在正确时间获取正确项目上下文,减少臆测并保持开发规范一致。

自动化与运维

CI/CD 自动化工程指南

为项目建立可验证、可回滚的持续集成与部署流水线。

开发与工程

系统弃用与迁移指南

帮助工程团队安全淘汰旧系统、迁移用户并验证移除结果。

开发与工程

浏览器 DevTools 测试

用真实浏览器运行数据验证、调试并测试网页应用。

开发与工程

测试驱动开发工作流

用可执行的测试先证明需求,再以最小改动实现、重构并验证行为。

开发与工程

Git 协作与版本发布规范

用可审查、可回滚的 Git 流程管理代码变更与版本发布。

开发与工程

架构决策与工程文档助手

帮助工程团队记录决策依据、维护文档并保留长期代码上下文。

设计与前端

生产级前端界面工程

帮助 AI 编码代理构建可访问、响应式且符合设计系统的生产级用户界面。

自动化与运维

生产可观测性工程

为生产代码建立日志、指标、追踪与告警,让系统行为可见且便于诊断。

开发与工程

增量实现

用可验证的小步迭代安全交付多文件工程变更。

自动化与运维

安全加固工程技能

帮助编码代理在处理不可信输入、身份验证、敏感数据和外部服务时建立系统化安全防线。

开发与工程

官方文档驱动开发

让框架与库的实现决策基于当前官方文档,而不是过时记忆。

相关 Skills