1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | spec-driven-development-addyosmani-agent-skills |
| 项目自述名称 | Agent Skills（合集仓库总名；本 skill 子目录名为 spec-driven-development） |
| 作者/维护者 | Addy Osmani（创建者），Federico Bartoli、Joan León（协作者） |
| 来源链接 | https://github.com/addyosmani/agent-skills/tree/main/skills/spec-driven-development |
| 许可证 | MIT |
| GitHub Stars | 78,565（来源：GitHub API，注：为合集仓库整体数据，非该子技能独占，见第 6 章说明） |
| Forks | 8,436（来源：GitHub API） |
| 最新版本 | 0.6.4（2026-07-12 发布，来源：GitHub Releases API） |
| 安装方式 | npx skills add 通用 CLI，或 Claude Code 插件市场 |
2. 功能介绍与亮点
spec-driven-development 是 Addy Osmani（前 Google Chrome 团队工程师）主创的 agent-skills 工程技能合集中的旗舰技能，对应该合集 README 首图里的 /spec 命令。核心能力：
- 四阶段闸门流程：Specify → Plan → Tasks → Implement，每阶段完成后需人工确认才能进入下一阶段，杜绝“AI 自己想当然往下写”。
- 强制暴露假设：写规格前先列出全部隐含假设，让人类在编码前纠正，而非事后返工。
- 结构化规格模板：目标、命令、目录结构、代码风格、测试策略、“总是做/先问/绝不做”三级边界、成功标准——覆盖工程规格该有的全部要素。
- 常见借口对照表：针对“这个简单不用写规格”“写完代码再补规格”等 5 类典型偷懒理由逐条给出反驳，是该合集的标志性设计（多篇独立文章将其列为区别于普通提示词库的核心亮点）。
- 与合集内其他技能联动：Plan/Implement 阶段显式引用同合集的
planning-and-task-breakdown、incremental-implementation、test-driven-development、context-engineering，形成完整生命周期闭环。
亮点：纯 Markdown 提示词技能，零依赖零外联；作者具真实身份与行业公信力；合集在 GitHub Trending 榜单出现（trendshift.io 收录）；近 3 个月内持续更新。
3. 适用场景
所属分类：工程效率与代码质量
适合初中级开发者在启动新项目、新功能或较大改动、且需求尚模糊时使用——把“我想要一个更快的仪表盘”这类模糊诉求转化为可验证的规格文档，再进入编码。单行 bug 修复、需求已明确的小改动不建议使用（技能文档本身也明确标注了“不适用场景”）。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——提供插件市场安装（
/plugin marketplace add+/plugin install）与本地插件目录两种方式，文档专门列出常见 SSH 报错的解决办法 - Codex：✅ 原生支持——README 明确列入“70+ 已验证平台”清单，可通过通用
npx skills addCLI 安装 - OpenClaw：❓ 未验证——官方文档未提及，且未为兼容性单独发起搜索验证
- Hermes Agent：❓ 未验证——同上
判断依据：仅基于仓库 README 与已抓取的 SKILL.md 内容，未做额外验证性搜索。
5. 推荐理由
先写规格再动手，四阶段闭环工作流大幅减少 AI 编码返工——把“人类审核点”显式嵌进流程，而不是寄望于 AI 自觉。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 合集仓库 78.6k stars，但该数字不可直接记给单个子技能（特殊规则一）；改看该技能自身证据：README 首图将其列为 8 个旗舰命令之一，被 DEV Community 独立文章、多个第三方技能聚合站（heyclau.de、agentskill.work、crossaitools.com）单独收录介绍，合集在 Hacker News 有多轮独立讨论且被 trendshift.io 收录为 Trending 项目 |
| 可用性 | 9 | 两种一键安装方式（通用 CLI / Claude Code 插件市场）；SKILL.md 含完整模板、示例与边界规则；该子目录最近提交 2026-06-29，仓库整体最近发布 2026-07-12（近 3 个月内持续维护）；MIT 许可，无付费依赖 |
| 安全性 | 9 | 该技能目录内仅含一个 SKILL.md 文件，无脚本、无可执行代码；不联网、不要求 API Key/凭据；内容全文人工审阅未发现可疑指令；作者为可验证真实身份的公开人物，仓库许可证明确（MIT）、维护活跃 |
| 综合 | 8.7 | 三项均值，达标（≥7.0 且安全性 ≥6） |
安全检查清单逐项：①无 shell 执行（纯 Markdown 提示词）②不联网外发数据③不要求凭据④全文审阅无 prompt injection 迹象⑤作者信誉高，真实身份可查⑥License 为 MIT，明确⑦最近一次提交 2026-06-29，维护活跃
7. 跟同类 Skills 相比的优势
| 方案 | 形态 | 生态位 | 差异化 |
|---|---|---|---|
| spec-driven-development（本次推荐） | 纯 Markdown 技能，随 Agent Skills 装 | 与同合集 test-driven-development、code-review-and-quality 等技能联动，构成完整生命周期 | 零额外安装成本，直接复用已装的技能生态；不需要单独学一套 CLI |
GitHub Spec Kit（github/spec-kit） |
独立 CLI + 模板工具包 | GitHub 官方出品，同样是 Specify→Plan→Tasks→Implement 四阶段闸门流程，宣称支持 30+ 编码 Agent | 品牌背书更强、独立于任何技能合集；但需要额外安装一套专用 CLI 与模板体系，不与其他工程技能天然联动 |
合集内 planning-and-task-breakdown |
同合集姊妹技能 | spec-driven-development 的 Plan 阶段显式引用它作为“权威来源” | 二者互补而非竞争：本技能定义“写什么”，它定义“怎么拆任务” |
核心差异：spec-driven-development 的价值不在于“发明”了规格驱动开发（GitHub Spec Kit 同期已有官方实现），而在于把这套方法论无缝嵌入一个已被广泛采用的多技能生命周期合集，安装成本几乎为零。
8. 用户评价
该技能目前可查到 1 条可追溯来源：DEV Community 作者 韩（Han，2026-06-10 发文）在分析 agent-skills 合集时指出，其“anti-rationalization tables”（针对偷懒借口的预置反驳表）是区别于普通提示词库的核心价值所在，规格驱动流程是该合集任务路由树的入口环节。除此之外，公开渠道尚无直接针对该技能的独立用户证言。
9. 其他补充
该技能是合集 24 个技能中的 1 个，合集本身在 GitHub Trending 有收录记录，且已有中文/英文多篇独立技术博客解读其设计理念（如“anti-rationalization tables”机制）。合集采用滚动版本号（当前 0.6.4），未见传统意义上的里程碑式 changelog。
10. 安装使用方式
方式一（通用，推荐用于 Codex / 其他兼容 Agent）：
npx skills add addyosmani/agent-skills --skill spec-driven-development方式二（Claude Code 插件市场）：
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills方式三（本地开发）：
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills安装后无需重启，Agent 会在检测到“新项目/新功能/需求模糊”等场景时自动触发该技能，也可通过 /spec 命令主动调用。Claude Code 插件市场安装若遇到 SSH 报错，可执行 git config --global url."https://github.com/".insteadOf git@github.com: 强制走 HTTPS。
11. 注意事项
- 该技能默认假设团队愿意为“写规格”投入前期时间，对追求极速原型验证的场景（单文件改动、需求已明确）不适用，文档本身也建议此时跳过
- OpenClaw、Hermes Agent 的兼容性未经官方文档确认，实际使用前建议先小范围验证
- 受欢迎程度数据基于合集仓库整体统计，非该子技能独立数据，需理性看待