agent-skills：把工程纪律写成 25 个智能体技能

AI 编程 agent 默认走最短路径：跳 spec、跳测试、跳安全审查，你叮嘱过的规矩，它下轮就忘。addyosmani（Google Chrome 团队）今年 2 月开源的 agent-skills（MIT 协议，截至 2026-10-13 约 106k star、11k fork）想治的就是这个毛病：它不换模型，把资深工程师的工作流程、质量门禁和最佳实践写成 25 个 SKILL.md，让 Claude Code、Codex、Cursor 这类智能体在每个开发阶段按同一套纪律办事。

核心功能

• 25 个技能覆盖完整生命周期：24 个生命周期技能加 1 个 using-agent-skills 元技能。定义阶段有 interview-me（一次一个问题把真实需求问出来）、spec-driven-development（先写 PRD 再写代码）；计划阶段有 planning-and-task-breakdown；构建阶段按竖切片推进；验证阶段有 test-driven-development；上线前有 code-review-and-quality、security-auditor 等。
• 9 个 slash 命令做入口：/spec 定需求、/plan 拆任务、/build 写代码、/test 验一遍、/constraints 定质量红线、/review 评审、/webperf 查性能、/code-simplify 简化、/ship 上线，每条命令自动激活对应技能；/build auto 还能在批准一次计划后自主跑完所有任务，失败即停。
• 反合理化表是它的招牌：每个技能都带一张「Common Rationalizations」表，把 agent 跳步最爱用的借口逐条列出并写死反驳。以 spec-driven-development 为例，「这个很简单不需要 spec」对应「简单任务不需要长 spec，但仍需要验收标准」；「我之后再写测试」对应「那是文档，不是规范」。
• 验证不可协商：每个技能末尾都是 Verification 清单——测试通过、构建产物、运行时数据，「看起来对」不算完成。spec-driven-development 甚至把「写完 spec 立即停止回合」列为硬规则，计划必须等人类批准 spec 之后的另一回合才能开始。
• 质量红线写成文件：constraint-driven-development 会采访你定一套带默认阈值的质量门禁，写进 CONSTRAINTS.md 并按成本排布检查位置，专门抓 agent 为了让构建变绿而静默测试、跳过检查的行为。
• 四个预置智能体人设：code-reviewer（五轴评审）、test-engineer（测试策略）、security-auditor（威胁建模）、web-performance-auditor（Core Web Vitals），可按任务单独调用。
• 一条命令装进 70+ 智能体：走开放 skills CLI，Claude Code、Cursor、Codex、Copilot、Cline 都认；也提供 Claude Code 插件市场、Cursor 规则目录和 Antigravity CLI 原生插件四种接入。技能也会按你手头的活自动激活——设计 API 时跳出 api-and-interface-design，写 UI 时跳出 frontend-ui-engineering，不用记名字。

典型使用场景

• 团队里 agent 写的代码能跑但没人敢 review：用 /constraints 把质量门禁写成 CONSTRAINTS.md，每次提交前自动过。
• 新功能需求模糊：让 interview-me 一次一个问题把需求问到 95% 置信，再进 /spec。
• 老代码库渐进改造：按 Adoption Guide 走 verification-first 路线，先给现有流程加门禁，不推倒重来。
• 架构决策没人记：documentation-and-adrs 逼着把「为什么这么做」写成 ADR，下次 agent 改同一处时先读到决策，而不是重新发明一遍。

快速上手

npx skills add addyosmani/agent-skills            # 装全部 25 个技能
npx skills add addyosmani/agent-skills --list     # 先浏览再决定

也可以只装单个技能，比如 npx skills add addyosmani/agent-skills --skill test-driven-development。装完在 Claude Code 里输入 /spec 就能看到流程跑起来。

小结

适合已经在用编码智能体写生产代码、又被「它总跳步」折磨的开发者；只是偶尔让 AI 写脚本的人未必需要这么重的流程。106k star 里有多少是收藏了没用不好说，但它治的问题真实存在，值不值得装取决于你的团队有没有这个问题、又愿不愿意把流程固化下来。三个坑先知道：只装单个技能会丢仓库级 references/ 共享清单（issue #361）；Claude Code 插件市场走 SSH 克隆，没配 GitHub key 会报 Permission denied；Antigravity CLI 某些版本的 legacy 命令装了也发现不了，要直接调命名空间技能。想找 Claude Code 生态的其它资源，同站的 everything-claude-code 是一份持续更新的清单；animate 则展示了另一种思路——把「先确认再渲染」写进 skill 来约束智能体。