Addy Agent Skills：从 /spec 走到 /ship

Addy Osmani 的 agent-skills 把「从规格到上线」的工程习惯打成 25 个 Agent Skill，并用 9 条斜杠命令串起 DEFINE→PLAN→BUILD→VERIFY→REVIEW→SHIP。MIT 开源，可用 npx skills 一次装齐。最新插件清单版本 0.6.14。

它是什么

这是一套面向生产级软件交付的 Agent Skills：把规格先行、小步实现、测试即证明、合并前审查、上线检查等写成可激活的工作流。Skill 会按任务类型自动挂上（例如做 API 触发 api-and-interface-design，做 UI 触发 frontend-ui-engineering）；也可以用斜杠命令显式推进阶段。站点 skills.addy.ie 与 README 同步介绍这套生命周期。

解决什么问题

编程 Agent 常一上来就写代码，规格和验收含糊；或者一次改太多，review 和测试跟不上。这套 Skill 把阶段门写进默认行为：先 /spec 问清要什么，再 /plan 拆成原子任务，再 /build 按片实现，用 /test 证明，用 /review 与 /constraints 守质量，最后 /ship。README 还介绍 /build auto：你批准计划后连续实现各任务，失败或高风险步骤仍会停下——省的是任务间的人工切换，不是验证。

原则写在命令表上：Spec before code；Tests are proof；Faster is safer。

怎么用

# 通用：装全部 25 个 Skill
npx skills add addyosmani/agent-skills
npx skills add addyosmani/agent-skills --list

# 只装单个
npx skills add addyosmani/agent-skills --skill code-review-and-quality
npx skills add addyosmani/agent-skills --skill interview-me
npx skills add addyosmani/agent-skills --skill test-driven-development

# Claude Code 插件市场
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
# 若 SSH 失败，可用 HTTPS：
# /plugin marketplace add https://github.com/addyosmani/agent-skills.git

README 提醒：用 --skill 只拷单个目录时，仓库根级 references/ 共享清单不会一起带上，Skill 仍能用，但补充检查表路径可能缺失；整仓安装、克隆仓库，或把需要的清单拷进 Skill 内 references/ 可规避（议题 #361）。本站装 Skill 的通用工具见 npx skills。

用法要点

当前 skills/ 下 25 项，覆盖：规格与访谈（spec-driven-development、interview-me、idea-refine）、规划与增量实现、TDD、调试恢复、代码审查与简化、前端 UI、API 设计、性能与可观测、安全加固、CI/CD、文档与 ADR、弃用迁移、git 工作流、上线发布，以及 using-agent-skills 自身用法。

和偏「少写代码」的 Ponytail、偏设计品味的 TasteSkill 不同，这套强调交付全流程门禁。九条命令可按阶段选用，不必一次跑完；与宿主内置同名命令冲突时，优先用命名空间形式。

维护活跃：0.6.12（10-03）→ 0.6.13（10-13）→ 0.6.14（10-29）。装第三方 Skill 前仍建议过安全扫描（例如 SkillSpector）。

斜杠命令推进阶段，质量门由对应 Skill 自动带上，不必死记一一对应。例如审查阶段会激活五轴代码审查相关 Skill；性能相关任务可走 /webperf。README 也说明这些 Skill 可在「你正在做的事」被识别时自动触发，不一定非要点命令。

适合谁，不适合谁

适合：用 Agent 做中长期功能开发、希望规格→实现→测试→审查默认齐全的个人与小团队；已经在用 Claude Code / Cursor / Codex，想统一一套工程口令的人。

不适合：只想丢一句提示马上出原型、不愿走规格与测试门的探索阶段；以及需要垂直领域（Android、科学计算）官方包的人——Android 见本批 Android Skills，科学向可关注候选池里的 scientific-agent-skills。

最后：npx skills add addyosmani/agent-skills 装齐后，先对一个真实小需求跑 /spec → /plan → /build，看 Agent 是否按原子任务推进并留下测试。