夜雨聆风学习资料网

ARTICLE · 1151483

给 AI 编程 Agent 装上工程师的纪律

给 AI 编程 Agent 装上工程师的纪律
AI ENGINEERING · 工具盘点2026.10

Agent 自动写码就够?

给 AI 编程 Agent装上

工程师的纪律

25 套工作流 · 9 条命令 · 10 万 + Star

Agent Skills · by Addy Osmani

PRODUCTIONMIT

📦 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

指标
数值
Star
104,197(十万 +,现象级)
Fork
10,878
协议
MIT(可随意用于项目、团队、工具)
语言
JavaScript
创建 / 更新
2026-02-15 / 2026-10-10
主页
https://skills.addy.ie
话题标签
agent-skills · claude-code · codex · cursor · skills

作者团队是三个人:创建者 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。命令本身就是开发流程的入口:

你在做什么
命令
核心原则
定义要做什么
/spec
先写规格,再写代码
规划怎么做
/plan
小、原子的任务
增量构建
/build
一次一个切片
证明它能跑
/test
测试即证据
设定质量红线
/constraints
一次定标准,处处强制
合并前评审
/review
提升代码健康度
审计 Web 性能
/webperf
先度量,再优化
简化代码
/code-simplify
清晰优于巧妙
上线生产
/ship
越快越安全

还有一个 /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 · 想清楚要做什么

技能
它解决什么
什么时候用
interview-me
一次一个问题,逼问出你真正想要的
需求含糊时
idea-refine
发散加收敛,把模糊点子变具体提案
有粗糙概念要探索
spec-driven-development
写覆盖目标与测试的 PRD,再写代码
新项目或重大变更
constraint-driven-development
敲定质量红线写 CONSTRAINTS.md
没有成文标准时

PLAN · 拆成小块

技能
它解决什么
什么时候用
planning-and-task-breakdown
把规格拆成小、可验证、带验收标准的任务
有规格要落地时

BUILD · 写代码(7 个,最多)

技能
它解决什么
什么时候用
incremental-implementation
薄垂直切片,特性开关,易回滚
改动涉及多文件
test-driven-development
红绿重构,测试金字塔,Beyonce 法则
实现或改行为
context-engineering
在正确时间给 Agent 正确信息
切任务或质量下降
source-driven-development
框架决策锚定官方文档并标注来源
要带引用的代码
doubt-driven-development
对抗式复审每个非平凡决策
高 stakes 或陌生代码
frontend-ui-engineering
组件架构、设计系统、WCAG AA
构建用户可见界面
api-and-interface-design
契约优先,Hyrum 定律,边界校验
设计 API 或模块边界

VERIFY · 证明它能跑

技能
它解决什么
什么时候用
browser-testing-with-devtools
Chrome DevTools MCP 拿实时运行数据
调试浏览器内东西
debugging-and-error-recovery
五步分诊,停线规则,安全降级
测试失败或构建崩

REVIEW · 合并前质量门

技能
它解决什么
什么时候用
code-review-and-quality
五轴评审,变更约 100 行
合并任何变更前
code-simplification
Chesterton 栅栏,保持行为降复杂度
代码能跑但难维护
security-and-hardening
OWASP 预防,密钥管理,三层边界
处理输入或鉴权
performance-optimization
度量优先,Core Web Vitals 目标
有性能要求时

SHIP · 有信心地上线(6 个)

技能
它解决什么
什么时候用
git-workflow-and-versioning
主干开发,原子提交,约 100 行
做任何代码变更
ci-cd-and-automation
左移,特性开关,质量门管道
搭构建或部署管道
deprecation-and-migration
代码即负债,迁移与僵尸清理
移除旧系统或下线
documentation-and-adrs
架构决策记录,记录为什么
做架构决策时
observability-and-instrumentation
结构化日志,RED,OpenTelemetry
发任何上生产的东⻄
shipping-and-launch
上线前清单,灰度,回滚
准备部署生产

元技能 using-agent-skills:把 incoming 的工作映射到正确的 Skill 工作流,并定义共享操作规则。新开会话或拿不准该用哪个 Skill 时,先调它。

05

PART

Skill 解剖:六段式结构

SKILL ANATOMY

每个 Skill 都写入一个 SKILL.md,遵循一致的结构。下面这张图就是它的骨架:

...SKILL.md

┌─ Frontmatter(name / description)──────────┐

│ Overview → 这个 Skill 做什么 │

│ When to Use → 触发条件 │

│ Process → 分步工作流 │

│ Rationalizations → 借口 + 反驳 │

│ Red Flags → 出问题的迹象 │

│ Verification → 证据要求 │

└─────────────────────────────────────────────┘

四个关键设计选择,决定了它和「一篇好博客」的本质区别:

STEP 01

流程,而非散文

Skill 是 Agent 照做的工作流,不是它读一遍的参考文档。每个都有步骤、检查点、退出标准。

STEP 02

反合理化 Anti-rationalization

每个 Skill 都带一张「Agent 用来跳过步骤的借口」表(例如「测试我待会补」),并附上反驳论证。

STEP 03

验证不可商量

每个 Skill 都以「证据要求」收尾——测试通过、构建输出、运行时数据,「看起来对」永远不够。

STEP 04

渐进式披露

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

各工具原生接入(节选):

...claude-code · codex

/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 按需拉取)。

Persona
角色
视角
code-reviewer
资深 Staff 工程师
五轴评审,会批准吗
test-engineer
QA 专家
测试策略,Prove-It
security-auditor
安全工程师
漏洞检测,OWASP
web-performance-auditor
Web 性能工程师
Core Web Vitals,用 /webperf

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

相关学习资料