核心信息

Agent Skills 是由 Google Chrome 团队资深工程师 Addy Osmani 创建的生产级工程技能框架。它将资深工程师的工作流、质量门禁和最佳实践编码为结构化流程,强制 AI 编码代理执行生产级工程纪律。

  • 作者:Addy Osmani(Google Chrome 团队)
  • Stars:42.7k
  • Forks:4.7k
  • 许可证:MIT
  • 最新版本:v0.6.0(2026-04-28)
  • 核心语言:Shell 78.6%, JavaScript 21.4%

核心理念

AI 编码代理默认走最短路径——跳过规格说明、测试、安全审查等环节。Agent Skills 强制它们执行生产级工程纪律。

融入了 Google 工程文化中的最佳实践,包括《Software Engineering at Google》和 Google 工程实践指南。

技能体系总览:开发生命周期 6 阶段 × 23 技能

元技能

技能作用
using-agent-skills将传入工作映射到正确的技能,定义共享操作规则

定义阶段(Define)

技能作用
interview-me逐一提问式访谈,提取真正需求,达 95% 置信度
idea-refine结构化发散/收敛思维,模糊想法→具体提案
spec-driven-development编写 PRD,覆盖目标、命令、结构、代码风格、测试、边界

计划阶段(Plan)

技能作用
planning-and-task-breakdown规格→小型可验证任务,含验收标准和依赖排序

构建阶段(Build)

技能作用
incremental-implementationThin vertical slices 实现、特性标志、安全默认值
test-driven-development红-绿-重构、测试金字塔(80/15/5)、Beyonce 规则
context-engineering在正确时间为 AI 提供正确上下文
source-driven-development每项决策基于官方文档,验证并引用来源
doubt-driven-development对抗性新鲜上下文审查:CLAIM→EXTRACT→DOUBT→RECONCILE→STOP
frontend-ui-engineering组件架构、设计系统、状态管理、WCAG 2.1 AA 无障碍
api-and-interface-design契约优先设计、Hyrum 定律、单版本规则、边界验证

验证阶段(Verify)

技能作用
browser-testing-with-devtoolsChrome DevTools MCP 实时运行时数据
debugging-and-error-recovery五步分类:复现→定位→缩减→修复→防护

审查阶段(Review)

技能作用
code-review-and-quality五轴审查、变更 ~100 行、严重级别标签
code-simplificationChesterton’s Fence 原则、500 规则
security-and-hardeningOWASP Top 10、三层边界系统
performance-optimization先测量后优化、Core Web Vitals、反模式检测

发布阶段(Ship)

技能作用
git-workflow-and-versioning主干开发、原子提交、“commit-as-save-point”
ci-cd-and-automation左移、更快即更安全、特性标志、质量门禁
deprecation-and-migration代码即负债、强制/建议弃用、僵尸代码清理
documentation-and-adrs架构决策记录、记录”为什么”
shipping-and-launch发布前检查清单、特性标志生命周期、分阶段发布

七大斜杠命令(开发生命周期映射)

命令阶段核心原则
/spec定义先写规格,后写代码
/plan计划小原子任务
/build构建一次一个切片
/test验证测试即证据
/review审查改善代码健康度
/code-simplify审查清晰胜过巧妙
/ship发布更快即更安全

三个 AI 专家角色

角色视角
code-reviewer资深工程师,五轴审查
test-engineerQA 专家,测试策略
security-auditor安全工程师,OWASP 评估

Skills 设计结构(“解剖结构”)

每个技能遵循统一模板:

  • Frontmatter:名称和描述
  • Overview:该技能的作用
  • When to Use:触发条件
  • Process:逐步工作流
  • Rationalizations:常见借口 + 反驳(反合理化表
  • Red Flags:出问题的迹象
  • Verification:证据要求

核心设计哲学

  1. “Process, not prose” — 技能是代理遵循的工作流,非供阅读的参考文档
  2. 反合理化表格 — 每个技能包含代理跳过步骤的常见借口及反驳
  3. 验证不可协商 — 每个技能以证据要求结尾
  4. 渐进式披露 — SKILL.md 是入口,支持性引用仅在需要时加载

支持的工具

Claude Code(推荐)、Cursor、Gemini CLI、Windsurf、OpenCode、GitHub Copilot、Kiro IDE & CLI、Codex 等。

关联连接

  • Agent_Skills — Agent Skills 项目实体
  • Agentic_Systems — 智能体系统(Skills 是 AI 编码代理的高级编排方式)
  • 摘要-agency-agents-zh — 角色库(互补:角色库提供领域专家,Skills 提供工程工作流)
  • 摘要-hello-agents — 智能体构建教程(互补:教程教构建,Skills 教如何使用 AI 编码)