最近在 GitHub 上有一个项目特别火,短短时间就狂揽了 1.9w+ Star,而且还在快速增长中。这个项目就是来自谷歌 Gemini 团队主管 Addy Osmani 的 Agent Skills。
苏米注:如果你在使用 AI 辅助开发的过程中遇到过这些问题:代码质量参差不齐、缺少测试、安全漏洞频发、文档不规范,那么这个项目绝对值得你花时间了解。
它不是什么新框架,也不是什么神奇的模型,而是一套完整的工程化工作流,让 AI 在每个开发阶段都能像资深工程师一样思考和行动。
项目介绍
Agent Skills 是一套为 AI 编程代理人设计的生产级工程技能库。

它的核心思想很简单:把资深工程师在实际工作中使用的工作流、质量门禁和最佳实践,封装成结构化的技能,让 AI 在每个开发阶段都能遵循一致的高标准。
整个项目围绕软件开发生命周期的六个核心阶段设计:定义(Define)、规划(Plan)、构建(Build)、验证(Verify)、评审(Review)、发布(Ship),共计 20 个核心技能。
为什么需要 Agent Skills?
因为 AI 编程助手往往会选择最短路径,也就是跳过需求文档、测试、安全评审等关键环节。Agent Skills 就是要解决这个问题,它给 AI 提供了结构化的工作流,强制它们遵循和资深工程师一样的纪律。
GitHub:https://github.com/addyosmani/agent-skills

核心亮点
1. 完整的开发生命周期覆盖
Agent Skills 不是零散的提示词集合,而是覆盖了从想法到上线的完整流程:
- 定义阶段:把模糊的想法变成具体的提案,写出完整的需求文档
- 规划阶段:把需求拆解成小的、可验证的任务
- 构建阶段:增量式实现、测试驱动开发、上下文工程
- 验证阶段:浏览器测试、调试与错误恢复
- 评审阶段:代码评审、简化、安全加固、性能优化
- 发布阶段:Git 工作流、CI/CD、废弃迁移、文档、发布上线
2. 7 个触发命令,一键激活
| 命令 | 核心理念 |
|---|---|
/spec |
先写需求再写代码 |
/plan |
小的原子化任务增量式构建 |
/build |
一次只做一块 |
/test |
测试就是证明 |
/review |
提高代码健康度 |
/code-simplify |
清晰胜过聪明 |
/ship |
越快越安全 |
3. 20 个核心技能,每个都是结构化工作流

定义阶段:
idea-refine:结构化的发散/收敛思考,把模糊想法变成具体提案spec-driven-development:写需求文档,覆盖目标、命令、结构、代码风格、测试、边界
规划阶段:
planning-and-task-breakdown:把需求拆解成小的可验证任务,带验收标准和依赖顺序
构建阶段:
incremental-implementation:薄垂直切片,实现、测试、验证、提交,特性标志、安全默认值、回滚友好test-driven-development:红 - 绿 - 重构,测试金字塔(80/15/5),测试大小,DAMP 胜过 DRY,Beyonce 规则source-driven-development:基于官方文档做框架决策,验证、引用来源、标记未验证内容frontend-ui-engineering:组件架构、设计系统、状态管理、响应式设计、WCAG 2.1 AA 无障碍api-and-interface-design:契约优先设计、Hyrum 定律、一版本规则、错误语义、边界验证
验证阶段:
browser-testing-with-devtools:Chrome DevTools MCP 用于实时运行时数据,DOM 检查、控制台日志、网络跟踪、性能分析debugging-and-error-recovery:五步分类法:复现、定位、简化、修复、防护,停机规则、安全回退
评审阶段:
code-review-and-quality:五轴评审、变更大小(约 100 行)、严重性标签(Nit/Optional/FYI)、评审速度规范、拆分策略code-simplification:Chesterton 栅栏、500 规则、在保留精确行为的同时降低复杂度security-and-hardening:OWASP Top 10 防护、认证模式、密钥管理、依赖审计、三层边界系统performance-optimization:先测量方法,核心 Web 指标目标、分析工作流、包分析、反模式检测
发布阶段:
git-workflow-and-versioning:基于主干开发、原子提交、变更大小(约 100 行)、提交即保存点模式ci-cd-and-automation:左移、越快越安全、特性标志、质量门禁流水线、失败反馈循环deprecation-and-migration:代码即负债思维、强制与建议废弃、迁移模式、僵尸代码移除documentation-and-adrs:架构决策记录、API 文档、内联文档标准,记录"为什么"shipping-and-launch:发布前检查清单、特性标志生命周期、分阶段推出、回滚流程、监控设置
融入 Google 工程文化
苏米注:这些技能不仅仅是通用的最佳实践,更融入了 Google 的工程文化——API 设计中的 Hyrum 定律、测试中的 Beyonce 规则、代码评审中的变更大小规范、简化中的 Chesterton 栅栏、Git 工作流中的基于主干开发、CI/CD 中的左移和特性标志。
快速上手
Claude Code(推荐)
Marketplace 安装:
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
SSH 错误处理(如果你的 GitHub 没有设置 SSH 密钥,可以用 HTTPS 替代):
git config --global url."https://github.com/".insteadOf "git@github.com:"
本地开发安装:
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills
Cursor
把任何 SKILL.md 复制到 .cursor/rules/ 目录,或者引用完整的 skills/ 目录。
Gemini CLI
从仓库安装:
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills
从本地克隆安装:
gemini skills install ./agent-skills/skills/
其他工具(Codex 等)
因为技能都是纯 Markdown,它们可以在任何接受系统提示或指令文件的代理上工作。
苏米注:如果你已经在用 AI 辅助开发,却总觉得输出质量不够稳定,不妨试试 Agent Skills。它不是要替代你的思考,而是把资深工程师的经验借给 AI,让它们在帮你写代码时,也能遵循生产级的标准。这个项目的价值在于,它把"怎么样才算好代码"这个很主观的问题,变成了一套可执行、可验证的工作流。