ARTICLE · 1151483
给 AI 编程 Agent 装上工程师的纪律
Agent 自动写码就够?
给 AI 编程 Agent装上
工程师的纪律
25 套工作流 · 9 条命令 · 10 万 + Star
Agent Skills · by Addy Osmani
📦 9 Parts + Conclusion
👉 滑动
PART 01
一句话定位
工程师的纪律
PART 02
硬核数据
10 万 Star 背后
PART 03
9 条命令
开发全生命周期
PART 04
25 个 Skill
六阶段拆解
PART 05
Skill 解剖
六段式结构
PART 06
设计哲学
Google 工程文化
PART 07
一键安装
npx 到原生接入
PART 08
Persona 清单
专家与参考
PART 09
横向对比
Superpowers · Pocock
PART ///
写在最后
要不要装
一句话结论
它不教你写 Prompt,而是把「何时写规格、测什么、怎么评审、何时上线」嵌进 Agent 照做的工作流。
最近 AI 编码 Agent 很火,但用过的都知道一个尴尬:它总爱走最短路径——为了跑通而跳过测试,为了变绿而关掉检查,把「能跑」当成「生产级」。Google Chrome 性能工程负责人 Addy Osmani 把这套问题看得很透,于是有了今天要盘点的 Agent Skills。
它是一套生产级工程技能库:把资深工程师在写软件时遵循的工作流、质量门禁与最佳实践,打包成 25 个结构化 Skill,让 Agent 在开发的每个阶段都一致地执行同样的纪律。仓库地址在 https://github.com/addyosmani/agent-skills。
01
PART
一句话定位:工程师的纪律
WHAT · WHY
Agent Skills 的核心主张很朴素:AI 编码 Agent 缺的不是能力,而是纪律。它把「什么时候该写规格、该测什么、怎么评审、何时能上线」这类工程判断,直接嵌进 Agent 一步步照做的工作流里,而不是交给它临场发挥。
和那些「教你写一句神 Prompt」的玩法不同,它交付的是流程而非散文:每个 Skill 都有步骤、检查点、退出标准,并且以「证据要求」收尾——测试通过、构建输出、运行时数据,「看起来对」永远不够。
一句话总结:它不教你写 Prompt,而是把资深工程师的纪律,做成了一套 Agent 无法偷懒的工作流。
02
PART
硬核数据:10 万 Star 背后
BY THE NUMBERS
作者团队是三个人:创建者 Addy Osmani(Google Chrome 性能工程负责人,著有《高性能 JavaScript》),协作者 Federico Bartoli 与 Joan León(nucliweb)。这不是一个人的玩具,而是把 Google 工程文化(Software Engineering at Google、Google 工程实践指南)系统性「配方化」的产物。
03
PART
9 条命令:开发全生命周期
SLASH COMMANDS
Agent Skills 提供 9 个斜杠命令,每条命令自动激活对应阶段的 Skill。命令本身就是开发流程的入口:
还有一个 /build auto:在 /spec 之后,它一次性生成计划并自动实现每个任务,你只需批准一次计划。它移除的是任务之间的「人工环节」,不是验证——每个任务仍测试驱动、独立提交,遇失败或高风险步骤会暂停。
此外,Skill 会按你「正在做什么」自动触发:设计 API 时自动激活 api-and-interface-design,写 UI 时自动激活 frontend-ui-engineering,依此类推。
04
PART
25 个 Skill:六阶段拆解
25 SKILLS · 6 PHASES
整套技能覆盖从「想法」到「上线」的完整链路,按阶段分成 DEFINE / PLAN / BUILD / VERIFY / REVIEW / SHIP,外加一个元技能 using-agent-skills(帮你判断该用哪个 Skill)。下面按阶段逐一拆解。
DEFINE · 想清楚要做什么
PLAN · 拆成小块
BUILD · 写代码(7 个,最多)
VERIFY · 证明它能跑
REVIEW · 合并前质量门
SHIP · 有信心地上线(6 个)
元技能 using-agent-skills:把 incoming 的工作映射到正确的 Skill 工作流,并定义共享操作规则。新开会话或拿不准该用哪个 Skill 时,先调它。
05
PART
Skill 解剖:六段式结构
SKILL ANATOMY
每个 Skill 都写入一个 SKILL.md,遵循一致的结构。下面这张图就是它的骨架:
┌─ Frontmatter(name / description)──────────┐
│ Overview → 这个 Skill 做什么 │
│ When to Use → 触发条件 │
│ Process → 分步工作流 │
│ Rationalizations → 借口 + 反驳 │
│ Red Flags → 出问题的迹象 │
│ Verification → 证据要求 │
└─────────────────────────────────────────────┘
四个关键设计选择,决定了它和「一篇好博客」的本质区别:
流程,而非散文
Skill 是 Agent 照做的工作流,不是它读一遍的参考文档。每个都有步骤、检查点、退出标准。
反合理化 Anti-rationalization
每个 Skill 都带一张「Agent 用来跳过步骤的借口」表(例如「测试我待会补」),并附上反驳论证。
验证不可商量
每个 Skill 都以「证据要求」收尾——测试通过、构建输出、运行时数据,「看起来对」永远不够。
渐进式披露
SKILL.md 是入口,支撑性的 references/ 只在需要时加载,token 用量最小。
06
PART
设计哲学:Google 工程文化配方化
DESIGN PHILOSOPHY
Agent Skills 最值钱的地方,是把 Google 工程文化的硬核判断直接嵌进步骤,而不是当口号念:
Hyrum 定律 → 出现在 API 设计里
你依赖的不仅是公开契约,还有所有被观测到的行为。
Beyonce 法则 + 测试金字塔(80/15/5)→ 测试
80% 单元、15% 集成、5% 端到端,且测试即证据。
Chesterton 栅栏 → 代码简化
不明白「为什么存在」之前,别急着拆掉它。
主干开发 / 左移 / 特性开关 / 代码即负债
分别出现在 Git 工作流、CI/CD、以及专门的废弃技能里。
一句话:这些不是抽象原则,而是直接写进 Agent 一步步照做的工作流。
07
PART
一键安装:从 npx 到原生接入
INSTALL
最快路径——任意 Agent,一条命令。官方 skills CLI(vercel-labs/skills)可装进 70+ Agent(Claude Code、Cursor、Codex、Copilot、Cline 等):
CMDnpx skills add addyosmani/agent-skills
CMDnpx skills add addyosmani/agent-skills --list
CMDnpx skills add addyosmani/agent-skills --skill code-review-and-quality
各工具原生接入(节选):
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills
git config --global url."https://github.com/".insteadOf git@github.com:
Cursor 放 .cursor/skills/,Gemini CLI / Windsurf / OpenCode / Copilot / Kiro / Antigravity / Command Code 均有对应原生接入文档。聊天里用 @spec-driven-development 这样的方式直接调用。
!踩坑提示 🕳
单技能 npx 安装只复制 skills/<name>/,不带仓库级 references/ 目录。Skill 仍能工作,但共享清单路径不可用——需要整仓库集成、克隆仓库,或把清单拷进 Skill 内的 references/。
08
PART
专家 Persona 与共享清单
PERSONAS · CHECKLISTS
除了 25 个 Skill,仓库还带了 4 个预置专家 Persona(用于定向评审)和 7 份共享参考清单(Skill 按需拉取)。
7 份参考清单(references/):
definition-of-done · testing-patterns
项目统一红线 vs 单任务验收;测试结构、Mock、React/API/E2E 示例。
security-checklist · performance-checklist
提交前检查、CORS、OWASP;Core Web Vitals 目标与度量命令。
accessibility · observability · orchestration
键盘导航/读屏/ARIA;RED/USE 指标、症状告警;多 Persona 编排规则(含「Persona 不调 Persona」)。
09
PART
横向对比:Superpowers / Pocock
HOW IT COMPARES
仓库里专门有一份 docs/comparison.md 做诚实的并排对比,并附了一场受控的 head-to-head 实验链接。三者形态不同、适用场景不同:
Superpowers
obra · 认知/元技能框架
Matt Pocock
TS / 教学向 skills
Agent Skills
生产级工作流 + 验证门禁
一句话:如果你的场景是「让 AI Agent 稳定输出生产级代码」,Agent Skills 是最直接的那一个——它强调验证门禁与反合理化,且分发最彻底。
///
LAST
写在最后:要不要装
SHOULD YOU USE IT
Agent Skills 的价值,不在于它多了一堆 Prompt,而在于它把「资深工程师的纪律」做成了一套Agent 无法偷懒的工作流——先写规格、测试即证据、评审有红线、上线有清单、废弃有章法。
对正在用 Claude Code / Codex / Cursor / Hermes / CodeBuddy 这类多工具搬技能的人来说,它还是目前分发最彻底的一套:一条 npx 命令就能进 70+ Agent,原生接入覆盖你手头几乎所有工具。
如果你的 Agent 总是「为了跑通而跳过测试、为了变绿而关掉检查」,不妨装上去,让它替你守住那条线。
项目地址:https://github.com/addyosmani/agent-skills
既然看到这里了,如果觉得有用,随手点个赞、在看、转发三连吧。
THANKS FOR READING