AI 编码代理（能听懂指令、自动读写代码文件的 AI 助手程序）写代码很快，但默认习惯是走最短路径：直接甩出代码，跳过写规格、补测试、做安全审查这些步骤。Agent Skills 这个开源项目，就是来解决这个问题的——它把资深工程师的完整干活流程整理成一份份说明书，让 AI 编码代理按同样的标准一步步执行。项目作者是 Google Chrome 团队的 Addy Osmani，仓库 addyosmani/agent-skills 目前有 89.6k Star、9.6k Fork，采用 MIT 许可，最新版本 0.6.7 发布于 2026 年 8 月 14 日。

适合谁用：正在使用 Claude Code、Cursor、Codex、GitHub Copilot、Cline 等 AI 编码工具的开发者，尤其是觉得 AI 输出「能用但不够稳」、希望它按规范流程干活的人。个人开发者和小团队可直接上手；团队管理者也可以把它当作「AI 版工程规范」，让所有成员手里的代理遵循同一套标准。

它解决什么问题：AI 代理默认走最短路径

AI 编码代理的核心能力是快速产出代码，但「快」常常以省略工程步骤为代价。原型阶段无所谓，可一旦代码要上线、要长期维护，缺了规格、测试、审查的代码就会累积隐患。Agent Skills 的思路是把资深工程师的习惯——先写什么、再做什么、做完拿什么证明——拆成 AI 能照做的分步流程，从源头减少「代码能跑但不敢合」的情况。

8 个斜杠命令：开发生命周期的入口

斜杠命令是在代理对话框里输入以 / 开头的指令，触发对应工作流。这套技能包提供 8 个命令，一一对应软件开发的主要阶段：

  • /spec：先写规格再写代码，明确要做什么、不做什么
  • /plan：把规格拆成小颗粒任务，每项有验收标准
  • /build：一次只实现一小片，边做边验证边提交
  • /test：用测试证明代码可用，而不是「看起来没问题」
  • /review：合并前做代码审查，提升代码健康度
  • /webperf：先测量性能数据再动手优化
  • /code-simplify：优先清晰可读，而不是炫技
  • /ship：更快、更安全地把版本发布上线

另有 /build auto 自动模式：规格就绪后，你只需批准一次计划，代理就会自动生成任务清单并逐个实现；每个任务仍先写测试再提交，遇到失败或风险步骤会停下来等你，而不是闷头跑完。

24 个技能：每份都是一张可执行的工作流说明书

斜杠命令是入口，背后是 24 个技能（23 个生命周期技能加 1 个元技能），按 Define（定义）、Plan（计划）、Build（构建）、Verify（验证）、Review（审查）、Ship（发布）六个阶段组织。每个技能是一份结构化说明，包含适用时机、分步流程、常见借口与反驳、红旗警示、验证要求五部分。

几个代表性技能：interview-me 一次只问一个问题，反复追问直到把模糊需求问清楚；spec-driven-development 要求写代码前先产出 PRD（产品需求文档，说明目标、结构、边界和验收口径）；test-driven-development 执行测试驱动开发的「红-绿-重构」循环；code-review-and-quality 在合并前进行五维审查，控制单次改动规模；security-and-hardening 覆盖 OWASP Top 10（十大 Web 安全风险清单）等安全加固项。

一个值得注意的设计：每个技能都带**「反借口」表格**，把 AI 偷懒时常用的理由（比如「测试以后再加」）和反驳写在一起，让代理想跳过步骤时被自己挡住；同时以验证证据收尾——测试通过、构建输出、运行时数据，明确不接受「看起来没问题」这类说法。

安装与使用：一条命令覆盖 70 多种代理

安装走 vercel-labs 出品的 skills CLI，一条命令把整套技能装进 70 多种支持技能的代理工具（Claude Code、Cursor、Codex、Copilot、Cline 等）：

npx skills add addyosmani/agent-skills

也可以只装单个技能，例如只装代码审查：npx skills add addyosmani/agent-skills --skill code-review-and-quality。官方推荐的完整接入方式是 Claude Code 插件市场（/plugin marketplace add addyosmani/agent-skills）；Codex、Gemini CLI、Windsurf、OpenCode、Antigravity 等工具各有原生安装方式，仓库文档里都给了逐步说明。

规则的来源：Google 工程实践

技能里的不少规则直接来自 Google 的工程文化，并写成了代理可执行的步骤：API 设计参考海勒姆定律（Hyrum's Law，指任何对外可见的行为都会被用户依赖，因此改动接口要格外谨慎）；测试遵循测试金字塔（大量单元测试打底、少量集成测试、极少数端到端测试）；代码简化参考切斯特顿围栏（Chesterton's Fence，删代码前先弄清它为什么存在）；版本管理用主干开发（团队频繁向主干分支提交小改动）配合小步提交。这些不是挂在文档里的口号，而是嵌进每一步流程的硬性要求。

与同类项目的差异

同类项目还有 Superpowers 和 Matt Pocock's skills。Agent Skills 的仓库里提供了三者并排对比文档，并附有一场受控对照实验的链接，结论是三者形态各有侧重，可按团队现状选择。

总结：值得一试的场景

一句话带走：Agent Skills 是把「资深工程师的工程纪律」翻译成 AI 编码代理能持续遵守的工作流。如果你正在用 AI 编码代理写要上线的代码，又担心它跳过测试和审查，这个 MIT 许可的开源技能包值得装上试试——从写规格到发布，代理的每一步都有明确的流程和验证要求，装与不装的区别，用一次 /build auto 就能感受到。