Agent Skills

Agent Skills — 让AI编程代理遵循专业工程师的工作流

Agent Skills 是一套面向 AI 编程代理的工程技能系统，由 Google Chrome 团队工程师 Addy Osmani 创建。它将资深工程师在软件开发中的质量门控、流程规范和最佳实践，封装为可直接注入 AI 上下文的技能集，使 AI 代理不再只输出代码，而是完成整个工程生命周期。

核心能力

Agent Skills 包含 9 条 slash 命令，映射到软件开发全生命周期：

• /spec 定义产品规格，先写文档再写代码
• /plan 将任务拆解为原子化小任务
• /build 增量构建，垂直切片而非大爆炸
• /test 测试驱动，先写失败测试再写实现
• /constraints 一次决策，处处强制执行
• /review 合并前五轴代码审查
• /webperf 审计 Web 性能
• /code-simplify 清晰优于巧妙
• /ship 安全发布到生产环境

此外还有 25 个专项技能，涵盖代码审查与质量（code-review-and-quality）、前端 UI 工程（frontend-ui-engineering）、测试驱动开发（test-driven-development）、API 与接口设计（api-and-interface-design）、面试需求澄清（interview-me）等，覆盖 AI 编程代理在真实项目中遇到的主要场景。

安装配置

Agent Skills 支持 70+ 主流 AI 编程代理，包括 Claude Code、Cursor、Copilot、Codex、Cline 等。

一键安装全部技能： npx skills add addyosmani/agent-skills

安装单个技能（如测试驱动开发）： npx skills add addyosmani/agent-skills --skill test-driven-development

全局安装（用户级）： npx skills add addyosmani/agent-skills --global

Claude Code 用户可通过市场安装： /plugin marketplace add addyosmani/agent-skills /plugin install agent-skills@addy-agent-skills

安装后会在当前目录生成 skills/ 目录，每个子目录对应一个技能。

使用步骤

第一步：启动代理后发出指令 在 Claude Code、Cursor 等代理中，根据任务类型直接调用 slash 命令。例如：/spec 启动产品规格定义流程。

第二步：代理激活对应技能 技能路由器（using-agent-skills）根据当前任务类型自动激活相关技能。设计 API 时触发 api-and-interface-design，构建 UI 时触发 frontend-ui-engineering。

第三步：按流程执行并产生证据 每个技能都有明确的检查点和退出条件。例如 /test 会强制 AI 先写一个必定失败的测试用例，运行它，确认失败，再写最小代码让它通过，最后重构——而非直接写代码然后补测试。

第四步：质量门控贯穿全程 /review 在合并前触发五轴代码审查，/constraints 在整个会话中强制执行项目级决策，/webperf 测量并验证性能改进。没有"看起来正确"——只有通过的测试、干净的构建输出和签收的审查。

第五步：发布 /ship 执行发布前检查清单，确认测试通过、代码可读、无性能回归后安全发布到生产环境。

适用场景

• 工程团队引入 AI 编程：不想让 AI 写出难以维护的代码，需要质量门控
• 企业级开发流程：需要在 AI 辅助下保持代码审查和测试规范
• 高质量 AI 辅助开发：个人开发者希望 AI 编程产出专业级代码
• 团队工程规范建设：用技能系统固化团队的编码规范和流程要求

适用人群

• 正在使用 Claude Code、Cursor 等 AI 编程工具的开发者
• 希望 AI 编程产出符合工程规范的团队
• 需要在 CI/CD 中嵌入 AI 质量门控的 DevOps 工程师
• 想让 AI 代理完成完整工程周期而非只写代码的项目负责人

工作原理

每个技能是一个包含 frontmatter 的 Markdown 文件，被注入到 AI 代理的上下文中触发特定行为。技能包含工作流步骤（而非参考文档），每一步都有进度指示器和退出条件，确保 AI 的每一步都有可验证的产出而非空洞的承诺。

反理性化表格（Anti-rationalization Tables）是 Agent Skills 最独特的设计：预置了 AI 可能用来跳过步骤的借口列表及其反驳，防止 AI 在简单任务面前跳过测试或审查。"这个任务太简单不需要规格"——不行。"我之后再写测试"——不行，因为"之后"永远不会来。

技能路由器根据任务类型渐进式激活相关技能，避免一次加载全部 25 个技能导致上下文膨胀和性能下降。

官方链接

• GitHub：https://github.com/addyosmani/agent-skills
• 官方博客详解：https://addyosmani.com/blog/agent-skills/
• 技能市场：https://skills.sh
• 趋势追踪：https://trendshift.io/repositories/25200