
最近在 GitHub 上有一个项目特别火,短短时间就狂揽了 1.9w+ Star,而且还在快速增长中。
这个项目就是来自谷歌 Gemini 团队主管 Addy Osmani 的 Agent Skills。

如果大家在使用 AI 辅助开发的过程中遇到过这些问题:代码质量参差不齐、缺少测试、安全漏洞频发、文档不规范,那么这个项目绝对值得你花时间了解。
它不是什么新框架,也不是什么神奇的模型,而是一套完整的工程化工作流,让 AI 在每个开发阶段都能像资深工程师一样思考和行动。
这次他把谷歌内部的工程实践和自己多年的经验总结成了一套可复用的 Skills,免费开源给所有人使用。
Agent Skills 是一套为 AI 编程代理人设计的生产级工程技能库。

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

1、完整的开发生命周期覆盖
Agent Skills 不是零散的提示词集合,而是覆盖了从想法到上线的完整流程:
2、7 个触发命令,一键激活
项目提供了 7 个斜杠命令,每个命令对应开发生命周期的一个环节,会自动激活相关的技能:
你要做什么 | 命令 | 核心理念 |
|---|---|---|
定义要构建什么 | /spec | 先写需求再写代码 |
规划如何构建 | /plan | 小的原子化任务 |
增量式构建 | /build | 一次只做一块 |
证明它能工作 | /test | 测试就是证明 |
合并前评审 | /review | 提高代码健康度 |
简化代码 | /code-simplify | 清晰胜过聪明 |
发布到生产 | /ship | 越快越安全 |
这些命令会根据你正在做的事情自动激活相应的技能,比如设计 API 时会触发 API 和接口设计技能,构建 UI 时会触发前端 UI 工程技能。
3、20 个核心技能,每个都是结构化工作流
这 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:发布前检查清单、特性标志生命周期、分阶段推出、回滚流程、监控设置4、融入 Google 工程文化
这些技能不仅仅是通用的最佳实践,更融入了 Google 的工程文化:
这些都不是抽象的原则,而是直接嵌入到 AI 遵循的一步步工作流中。
Agent Skills 支持目前主流的 AI 编程工具,让我们来看具体的安装方法:
Claude Code(推荐)
Marketplace 安装:
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skillsSSH 错误处理:如果你的 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-skillsCursor
把任何 SKILL.md 复制到 .cursor/rules/ 目录,或者引用完整的 skills/ 目录。详细设置可以查看 docs/cursor-setup.md。
Gemini CLI
可以安装为原生技能用于自动发现,或者添加到 GEMINI.md 用于持久化上下文。
从仓库安装:
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills从本地克隆安装:
gemini skills install ./agent-skills/skills/其他工具(Codex 等)
因为技能都是纯 Markdown,它们可以在任何接受系统提示或指令文件的代理上工作。详细设置可以查看 docs/getting-started.md。
如果你已经在用 AI 辅助开发,却总觉得输出质量不够稳定,不妨试试 Agent Skills。
它不是要替代你的思考,而是把资深工程师的经验借给 AI,让它们在帮你写代码时,也能遵循生产级的标准。
这个项目的价值在于,它把"怎么样才算好代码"这个很主观的问题,变成了一套可执行、可验证的工作流。从需求到上线,每个环节都有明确的步骤和检查点,这正是工程化的核心所在。
GitHub:https://github.com/addyosmani/agent-skills
如果本文对您有帮助,也请帮忙点个 赞👍哈!❤️
在看你就赞赞我!