用 Addy Osmani 的 Agent Skills 大概两周了,说说真实感受
用 Addy Osmani 的 Agent Skills 大概两周了,说说真实感受
先说结论:这不是另一个 AI 编程玩具,而是一套把”资深工程师的工作纪律”注入 AI 编码过程的完整框架。
它解决什么问题
AI 编程助手有一个根本矛盾:它擅长快速生成代码,但默认不走工程流程——不写规格、不写测试、不做安全审查、不考虑性能优化,直接给你一个”能用但不可维护”的结果。
Addy Osmani(Google 工程总监)开源的 agent-skills 就是来解决这个问题的。它把 Google 内部的工程规范——”先写规格再写代码”、”测试即证明”、”代码审查是质量门禁”——封装成 20 个结构化的技能文件,让 AI 在编码的每个环节都遵循这些纪律。
83K Star,活跃维护,最新版 0.6.6(2026-08-04),支持 Claude Code、Codex、Cursor、Copilot、Cline 等主流 AI 编程工具。
核心机制:8 个斜杠命令覆盖全生命周期
这是 agent-skills 最核心的设计。它提供 8 个斜杠命令,对应软件开发的 6 个阶段:
| 命令 | 阶段 | 核心理念 |
|---|---|---|
/spec |
Define | 先写需求再写代码 |
/plan |
Plan | 小的原子化任务 |
/build |
Build | 一次只做一块 |
/test |
Verify | 测试即证明 |
/review |
Review | 代码审查是质量门禁 |
/webperf |
Review | 测量再优化 |
/code-simplify |
Review | 清晰胜过聪明 |
/ship |
Ship | 越快越安全 |
工作流是这样的:
DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP
Idea Spec Code Test QA Go
最有意思的是 /build auto:你批准一次计划,然后 AI 会自主执行所有原子任务,每个任务仍然遵循 TDD(红→绿→重构),失败会自动暂停。这解决了 AI 编程助手”一次生成太多代码无法维护”的核心痛点。
实测体验
我的用法:在一个中等规模的 Node.js 项目里,用 /spec 定义了一个新功能的规格文档,然后 /build auto 生成实现计划并自动执行。
几个真实感受:
好的部分:
- 强制先写规格这个环节,比我想象中更有价值。AI 在开始写代码前会列出边界条件、错误处理、API 契约,代码质量明显更高。
- 自动触发机制很聪明——你写 API 时自动激活
api-and-interface-design技能,写前端时自动激活frontend-ui-engineering,不用每次手动调命令。 - 8 月 4 日刚发了 0.6.6,修复了 Claude Code 插件里四个 agent persona 加载失败的问题,维护很活跃。
需要注意的:
- 如果你只是想让 AI 帮你写一个小脚本,这个框架反而是过度设计。它适合需要长期维护的真实项目。
- 生态锁定:虽然宣传支持多 agent,但深度集成仍然是 Claude Code 最佳,Codex 次之,Cursor 等其他工具的功能覆盖有差异。
适合谁 / 不适合谁
适合:
- 团队用 AI 编程助手做真实项目开发,需要工程纪律约束
- 想要让 AI 生成的代码有测试、有规格、可维护,而不是一次性代码
- 已经在用 Claude Code 或 Codex,想提升输出质量
不适合:
- 快速原型、一次性脚本——框架开销大于收益
- 对工程流程没有概念的纯新手——需要先理解这些纪律在说什么
- 不愿意花时间配置和定制技能的”开箱即用”期待者
怎么快速上手
最简单的方式,通过 Vercel 的 skills CLI 安装(支持 70+ agents):
# 安装全部 20 个技能
npx skills add addyosmani/agent-skills
# 或者安装单个技能
npx skills add addyosmani/agent-skills --skill code-review-and-quality
Claude Code 用户可以直接用插件市场安装:
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
安装完成后,在任意项目里输入 /spec 就能开始体验。
最后说一句
AI 编程助手最让人担心的事,不是它写不出代码,而是它让你习惯于接受没有规格、没有测试、没有审查的代码。agent-skills 的价值在于:它把这个问题摆到台面上,并且给了一个可操作的解法。
不管你用不用这套框架,”先写规格再写代码”和”测试即证明”这两条原则,值得每个用 AI 编程的人记住。
仓库: https://github.com/addyosmani/agent-skills
最新版本: v0.6.6(2026-08-04)
Star: 83,064
评论区
登录后可评论。