技能介绍
Agent Skills 是 Addy Osmani(Google Chrome EM)整理的一套面向 AI 编码代理的生产级工程技能。这些技能封装了高级工程师在构建软件时使用的工作流、质量门和最佳实践,被打包成 AI 代理可以在开发每个阶段一致遵循的格式。
它要解决的问题是:AI 编码代理默认走最短路径——这通常意味着跳过规范、测试、安全审查,以及那些让软件真正可靠的实践。Agent Skills 为代理提供结构化工作流,强制执行高级工程师在生产代码中使用的同一套纪律。每个技能编码的都是来之不易的工程判断:何时编写规范、测试什么、如何审查、何时发布。它们不是通用提示,而是有意见、过程驱动的工作流,把生产质量的工作与原型质量的工作区分开。
适用场景
- 把一个功能需求拆成 Define → Plan → Build → Verify 的执行计划
- 审查一段实现,按测试、边界条件和发布风险列出必须补齐的证据
- 为一个 PR 设计可验证的质量门禁,包括测试命令和验收标准
- 需求不明确、需要把模糊想法收敛成具体提案时
- 风险高(生产、安全、不可逆)或在不熟悉的代码中工作时
- 合并前的质量门、发布前的检查清单与回滚准备
核心能力
8 个斜杠命令,映射到开发生命周期,每个命令会自动激活正确的技能:
| 你正在做什么 | 命令 | 关键原则 |
|---|---|---|
| 定义要构建什么 | /spec | 先写规范,后写代码 |
| 规划如何构建 | /plan | 小粒度原子任务 |
| 增量构建 | /build | 一次一个切片 |
| 证明它工作 | /test | 测试就是证据 |
| 合并前审查 | /review | 改善代码健康 |
| 审计Web性能 | /webperf | 先测量,再优化 |
| 简化代码 | /code-simplify | 清晰胜过巧妙 |
| 发布到生产 | /ship | 更快就是更安全 |
24 个技能:23 个生命周期技能加上 using-agent-skills 元技能(把传入的工作映射到正确的技能工作流,并定义共享操作规则)。按阶段分组:
- 定义:
interview-me(逐次提问的访谈,提取用户真正想要的东西而不是他们认为自己应该想要的,直到约 95% 置信度)、idea-refine(结构化发散/收敛思维)、spec-driven-development(编码前先写涵盖目标、命令、结构、代码风格、测试和边界的 PRD) - 计划:
planning-and-task-breakdown(拆成小的、可验证、带验收标准与依赖排序的任务) - 构建:
incremental-implementation(薄垂直切片,特性开关、安全默认值、易回滚)、test-driven-development(红-绿-重构、测试金字塔 80/15/5、DAMP 优于 DRY、Beyonce 规则、浏览器测试)、context-engineering(在正确的时间给代理正确的信息)、source-driven-development(基于官方文档做每个框架决策并标注未经验证的内容)、doubt-driven-development(对非平凡决策做对抗性新上下文审查,CLAIM → EXTRACT → DOUBT → RECONCILE → STOP)、frontend-ui-engineering(组件架构、设计系统、状态管理、WCAG 2.1 AA 可访问性)、api-and-interface-design(契约优先、Hyrum 定律、One-Version 规则、错误语义、边界验证) - 验证:
browser-testing-with-devtools(Chrome DevTools MCP 获取实时运行时数据)、debugging-and-error-recovery(复现、定位、简化、修复、防护五步分类法) - 审查:
code-review-and-quality(五轴审查、约 100 行变更大小、Nit/Optional/FYI 严重级别、审查速度规范)、code-simplification(Chesterton's Fence、500 规则)、security-and-hardening(OWASP Top 10 预防、认证模式、秘密管理、依赖审计)、performance-optimization(先测量再优化、Core Web Vitals 目标、打包分析) - 发布:
git-workflow-and-versioning(基于主干开发、原子提交、提交即保存点)、ci-cd-and-automation(左移、更快即更安全、质量门流水线)、deprecation-and-migration(代码即负债思维、强制性与建议性弃用)、documentation-and-adrs(架构决策记录——记录为什么)、observability-and-instrumentation(结构化日志、RED 指标、OpenTelemetry 追踪、基于症状的告警)、shipping-and-launch(发布前检查清单、特性开关生命周期、分阶段发布、回滚程序)
4 个预配置专家代理角色,用于针对性审查:code-reviewer(高级职员工程师视角的五轴代码审查)、test-engineer(测试策略、覆盖率分析、Prove-It 模式)、security-auditor(漏洞检测、威胁建模、OWASP 评估)、web-performance-auditor(快速/深度模式的 Core Web Vitals 审计与指标诚实规则,通过 /webperf 运行)。
7 份参考清单,技能在需要时拉入:definition-of-done.md、testing-patterns.md、security-checklist.md、performance-checklist.md、accessibility-checklist.md、observability-checklist.md、orchestration-patterns.md(认可的多角色编排模式、反模式,以及「角色不调用角色」规则)。
技能会根据你正在做的事情自动激活——设计 API 时触发 api-and-interface-design,构建 UI 时触发 frontend-ui-engineering,以此类推。你也可以直接引用任何技能。
效果预览

工作方式
每个技能遵循一致的结构:Frontmatter(名称、描述、使用时机)、Overview(该技能做什么)、When to Use(触发条件)、Process(逐步工作流)、Rationalizations(借口 + 反驳)、Red Flags(出问题的迹象)、Verification(证据要求)。
关键设计选择:
- 过程而非散文。 技能是代理遵循的工作流,而不是它们阅读的参考文档,每个都有步骤、检查点和退出标准。
- 反合理化。 每个技能都包含一张表格,列出代理常用跳过步骤的借口(例如「我稍后添加测试」),并附有文档化的反驳论据。
- 验证不可协商。 每个技能都以证据要求结束——测试通过、构建输出、运行时数据。「看起来正确」永远不够。
- 渐进式披露。
SKILL.md是入口点,支持性参考仅在需要时加载,保持 token 使用最小化。
如果你希望规范存在后减少手动步骤,`/build auto` 会生成计划并一次性批准执行所有任务——你批准一次计划,然后它自动运行。它消除了任务之间的人工干预,但不消除验证:每个任务仍然是测试驱动并单独提交的,遇到失败或风险步骤时会暂停。
你需要提供
- 一个能加载并使用 Skill 的 AI 编码代理(技能以结构化工作流形式分发,代理读取后按步骤执行)
- 使用
browser-testing-with-devtools时需要 Chrome DevTools MCP,用于获取 DOM 检查、控制台日志、网络追踪、性能分析等实时运行时数据 - 需要外部工具或知识接入时,按
context-engineering的规则文件、上下文打包与 MCP 集成方式准备上下文 - 一个可以从 Google 工程实践文档中受益的真实工程场景(规范、任务、PR 或待发布变更)
你会获得
- 24 个结构化技能(23 个生命周期技能 + 1 个元技能),每个都带步骤、验证门与反合理化表
- 8 个映射开发生命周期的斜杠命令,以及按场景自动激活的技能
- 4 个专家代理角色,用于代码审查、测试策略、安全审计与 Web 性能审计
- 7 份按需拉入的参考清单(完成标准、测试模式、安全、性能、可访问性、可观测性、编排模式)
- 一份
/build auto计划,可在一次批准后自动执行、仍保持每任务测试驱动与独立提交
使用示例
使用斜杠命令逐阶段推进:
/spec 定义要构建什么
/plan 规划如何构建
/build 增量构建
/test 证明它工作
/review 合并前审查
/webperf 审计 Web 性能
/code-simplify 简化代码
/ship 发布到生产一次批准、自动执行:
/build auto技能自动激活(无需手动指定):
设计 API 时触发 api-and-interface-design,构建 UI 时触发 frontend-ui-engineering需求不明确时主动调用访谈技能:
interview me
grill me本组合包含 24 个可安装子 Skill,支持智能安装(由 Cola 评估后安装最适合你的 Skill)、全部安装,或复制选装后发给你在用的 Agent。
想了解它与 Superpowers 或 Matt Pocock's skills 的差异,作者提供了 comparison.md 的并排对比,以及一个头对头实验的链接。



