开发与工程

规范驱动开发

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

55/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 107k
最近更新
14 天前
License
MIT
spec-writingrequirements-analysisproject-planningacceptance-criteria
+1human-review-gates

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

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

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

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

如何安装这个 Skill?

使用前请注意
  • 引用的 planning-and-task-breakdown、incremental-implementation、test-driven-development 和 context-engineering 技能未在本次材料中提供,实际执行一致性无法确认。
  • 技能要求人工逐阶段确认,但未定义超时、拒绝、无权限写入 tasks/ 文件或命令失败时的明确恢复路径。
  • 未说明敏感信息、凭据、专有需求内容在规格和提交中的处理规则。
开始前你需要
Agent 需要具备
  • 本地文件系统

该技能位于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未说明其他客户端的单技能安装步骤。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/addyosmani/agent-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/spec-driven-development" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 我要开始一个新功能,请先帮我编写规范,不要写代码

在兼容Agent Skills的编码代理中触发spec-driven-development,或提出类似“我要开始一个新功能,请先帮我编写规范,不要写代码”的请求。先完成规范并等待人工审阅;确认后生成tasks/plan.md和tasks/todo.md,再进入实现。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖目标、命令、结构、风格、测试和边界六个核心区域。
  • 要求公开假设,并把模糊要求转为具体、可测试的成功标准。
  • 通过Specify、Plan、Tasks、Implement四阶段和人工审核形成明确闸门。
  • 支持持续更新规范,并要求将其与代码一起纳入版本控制。
局限
  • 对单行修复和明确的小改动而言,完整流程可能增加不必要的开销。
  • 实现阶段依赖仓库中的其他技能,如增量实现和测试驱动开发;本技能本身不定义完整的编码或测试流程。
  • 源材料未提供该技能的独立自动化测试或跨客户端验证证据。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
规范驱动开发 本页 55 · 谨慎使用 ★ 107k 14 天前 MIT
规划与任务拆解 54 · 谨慎使用 ★ 107k 14 天前 MIT
DeepChat 规格驱动开发(SDD)技能 58 · 推荐 ★ 6.4k 15 天前 Apache-2.0
锤炼设计:结构化的计划拷问 57 · 谨慎使用 ★ 28k 13 天前 MIT
Loki Mode 自主 SDLC 技能 53 · 谨慎使用 ★ 1.1k 19 天前 NOASSERTION

README提到Superpowers和Matt Pocock's skills,但所提供材料没有给出具体对比结论。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
55/ 100 五分制 2.8 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全18 / 25 · 3.6/5

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

2可靠稳定8 / 20 · 2.0/5

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

3适用触发11 / 15 · 3.7/5

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

4规范维护8 / 15 · 2.7/5

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

5有效结果6 / 15 · 2.0/5

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

6证据核验4 / 10 · 2.0/5

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

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 2fbfa004a019 评估证据[1][2][3][4][5]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

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

同仓库的其他 Skills

均来自 addyosmani/agent-skills

开发与工程

规划与任务拆解

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

★ 107k FS 54 谨慎使用 14 天前
开发与工程

合并前代码质量审查

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

★ 107k FS 49 谨慎使用 14 天前
开发与工程

工程技能导航器

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

★ 107k FS 46 谨慎使用 14 天前
开发与工程

需求访谈助手

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

★ 107k FS 59 推荐 14 天前
开发与工程

代码简化审查

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

★ 107k FS 57 谨慎使用 14 天前
开发与工程

性能优化工程技能

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

★ 107k FS 54 谨慎使用 14 天前
开发与工程

怀疑驱动开发

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

★ 107k FS 52 谨慎使用 14 天前
开发与工程

Idea Refine 创意打磨

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

★ 107k FS 51 谨慎使用 14 天前
开发与工程

上下文工程指南

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

★ 107k FS 49 谨慎使用 14 天前
自动化与运维

CI/CD 自动化工程指南

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

★ 107k FS 48 谨慎使用 14 天前
开发与工程

系统弃用与迁移指南

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

★ 107k FS 48 谨慎使用 14 天前
开发与工程

浏览器 DevTools 测试

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

★ 107k FS 59 推荐 14 天前
开发与工程

测试驱动开发工作流

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

★ 107k FS 57 谨慎使用 14 天前
开发与工程

Git 协作与版本发布规范

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

★ 107k FS 54 谨慎使用 14 天前
开发与工程

架构决策与工程文档助手

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

★ 107k FS 53 谨慎使用 14 天前
设计与前端

生产级前端界面工程

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

★ 107k FS 53 谨慎使用 14 天前
自动化与运维

生产可观测性工程

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

★ 107k FS 53 谨慎使用 14 天前
开发与工程

增量实现

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

★ 107k FS 52 谨慎使用 14 天前
自动化与运维

安全加固工程技能

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

★ 107k FS 52 谨慎使用 14 天前
开发与工程

官方文档驱动开发

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

★ 107k FS 51 谨慎使用 14 天前

相关 Skills