agent-skills:Google 工程师开源 20 个 Skill,强制 AI 写代码守规矩
标签: 开源项目 / AI Agent / 编码规范 / Google工程实践
原文: 微信公众号「Python之禅」https://mp.weixin.qq.com/s/oaK4w9nvk9wKyiHpWfUCKw
核心亮点
agent-skills 是 Google Gemini 团队工程师 Addy Osmani 开源的项目,3 个月获得 41,000+ Star。包含 20 个 Skill 文件、7 个斜杠命令、3 个专家 Agent 角色,覆盖完整研发生命周期。核心理念:流程优于辞藻,工作流优于参考手册。
问题背景:AI 写代码的四大痛点
你有没有过这种经历?
- 让 AI 帮你写代码,它写得飞快,看着也像那么回事,跑起来全是坑。
- 让它改一个 bug,它顺手改了二十个文件,每个都优化了一点点,最后 diff 你看到崩溃。
- 沟通不对齐,你说的「优化性能」它理解成「重写整个模块」。
- 术语混乱,同一个概念在不同文件里用不同的命名。
高级工程师的工作,大部分都不出现在 diff 里。规格、测试、评审、范围纪律、拒绝交付无法被验证的东西——AI 编码 Agent 默认跳过所有这些。
资深工程师的价值不在打字速度,在那些看不见的工作:先问清需求、先想测试、改完就跑、不碰任务外的代码、留下可验证的证据。
agent-skills 的解决方案
agent-skills 把 Google 二十年的工程文化翻译成了 AI 可执行的工作流。
1. 20 个 Skill 文件,覆盖完整研发流程
按研发生命周期分布:
| 阶段 | Skill 示例 |
|---|---|
| 规格定义 | /spec - 需求澄清 |
| 任务拆解 | /plan - 分解实施步骤 |
| 增量实现 | /build - 按计划逐项交付 |
| TDD | /test - 红绿重构强制执行 |
| 调试 | 诊断与修复流程 |
| 代码评审 | /review - 专业审查清单 |
| 性能优化 | 性能指标检查 |
| 安全加固 | 安全审计 Agent |
| Git 工作流 | 提交规范与分支策略 |
| CI/CD | 持续集成配置 |
| 上线发布 | /ship - 发布检查 |
2. 7 个斜杠命令
| 命令 | 用途 |
|---|---|
| /spec | 规格定义,澄清需求边界 |
| /plan | 任务拆解,生成实施计划 |
| /build | 按计划增量实现 |
| /test | 强制 TDD 流程 |
| /review | 代码评审,专业清单检查 |
| /code-simplify | 代码简化,砍掉冗余 |
| /ship | 发布检查,上线前最后验证 |
3. 3 个专家 Agent 角色
| 角色 | 职责 |
|---|---|
| 代码评审专家 | 审查代码质量、命名规范、设计模式 |
| 测试专家 | 设计测试用例、覆盖率检查、边界条件验证 |
| 安全审计专家 | 漏洞扫描、权限检查、敏感数据处理 |
4. 4 份参考清单
- 测试模式清单
- 安全检查清单
- 性能指标清单
- 可访问性清单
设计理念:流程优于辞藻
Addy Osmani 在博客里讲了项目的出发点:
流程优于辞藻。工作流优于参考手册。带退出条件的步骤,优于不带退出条件的长篇大论。
agent-skills 的规则不是 Addy 自己拍脑袋想的,全部出自 Google 内部的工程实践,部分写在《Software Engineering at Google》一书。
这些理念在书里是原则,在 agent-skills 里是 AI 必须执行的步骤。
安装使用
Claude Code 安装
# 从 marketplace 安装
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
装完即可使用 7 个斜杠命令,Skill 根据上下文自动激活。
其他 Agent 工具
agent-skills 的 Skill 文件是纯文本格式,可以适配到其他支持 Skill 的 Agent 工具(如 Cursor、Aider 等),只需将对应的 .skill 文件复制到工具的 Skill 目录即可。
核心价值
1. 强制工程规范
不是「建议你做测试」,而是「不跑测试就不能进入下一步」。agent-skills 把工程规范变成了 AI 必须执行的流程。
2. 范围纪律
改一个 bug 就只改这一个 bug,不会顺手优化二十个文件。每个任务有明确的退出条件。
3. 可验证的交付
每一步都有检查点,AI 不能糊弄过去。代码评审、测试覆盖、安全审计都有专业清单。
4. 知识沉淀
把高级工程师的经验变成了可复用的 Skill 文件,团队可以基于此继续定制。
项目信息
| 属性 | 详情 |
|---|---|
| 项目名 | agent-skills |
| 作者 | Addy Osmani (Google Gemini 团队) |
| GitHub | https://github.com/addyosmani/agent-skills |
| Star 数 | 41,000+ (3 个月) |
| 开源协议 | MIT |
| Skill 数量 | 20 个 |
| 斜杠命令 | 7 个 |
| 专家 Agent | 3 个 |
| 参考清单 | 4 份 |
适用场景
- 新项目从零开始,希望建立良好的工程规范
- 团队协作,需要统一的代码质量标准
- AI 编码工作流优化,减少返工和混乱
- 工程文化落地,把原则变成可执行的步骤
写在最后
AI 编码 Agent 的价值不在打字速度,在工程能力的复用。
agent-skills 做的事情,本质上是把「高级工程师是怎么工作的」这个隐性知识,变成了显性的工作流。让 AI 不只是写代码,而是按照专业工程师的方式工作。
这不是银弹,不能替代工程判断。但它提供了一个起点——一个让 AI 不乱写代码、不乱改文件、不乱糊弄你的起点。
如果你厌倦了 AI 写的代码跑起来全是坑,如果你希望 AI 能按照专业工程师的标准工作,不妨试试 agent-skills。
本文整理自微信公众号「Python之禅」,原文链接:https://mp.weixin.qq.com/s/oaK4w9nvk9wKyiHpWfUCKw