核心信息
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-implementation | Thin 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-devtools | Chrome DevTools MCP 实时运行时数据 |
| debugging-and-error-recovery | 五步分类:复现→定位→缩减→修复→防护 |
审查阶段(Review)
| 技能 | 作用 |
|---|
| code-review-and-quality | 五轴审查、变更 ~100 行、严重级别标签 |
| code-simplification | Chesterton’s Fence 原则、500 规则 |
| security-and-hardening | OWASP 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-engineer | QA 专家,测试策略 |
| security-auditor | 安全工程师,OWASP 评估 |
Skills 设计结构(“解剖结构”)
每个技能遵循统一模板:
- Frontmatter:名称和描述
- Overview:该技能的作用
- When to Use:触发条件
- Process:逐步工作流
- Rationalizations:常见借口 + 反驳(反合理化表)
- Red Flags:出问题的迹象
- Verification:证据要求
核心设计哲学
- “Process, not prose” — 技能是代理遵循的工作流,非供阅读的参考文档
- 反合理化表格 — 每个技能包含代理跳过步骤的常见借口及反驳
- 验证不可协商 — 每个技能以证据要求结尾
- 渐进式披露 — SKILL.md 是入口,支持性引用仅在需要时加载
支持的工具
Claude Code(推荐)、Cursor、Gemini CLI、Windsurf、OpenCode、GitHub Copilot、Kiro IDE & CLI、Codex 等。
关联连接