Agent Skills:Google工程师把工程规范做成24个可执行Skill

总结

Agent Skills 是 Google 工程师 Addy Osmani 开源的一套生产级 AI 编程技能库(24 个结构化 Skill + 8 条斜杠命令),将 Google 工程规范——Hyrum’s Law、Beyoncé Rule、trunk-based development 等——封装成 AI Agent 可直接加载执行的 Markdown 工作流,让 Claude Code、Cursor 等工具在每个开发阶段都遵守「先写规范、再写代码、测过再审、审过再发」的严格纪律。截至 2026-10-04,GitHub 获星 101,056 个,是当前最受欢迎的 Agent 技能合集之一。

功能与原则

Agent Skills 的核心功能是把资深工程师的「系统性工程思维」编码成 AI 可读取的结构化 Skill 文件。每个 Skill 包含:明确步骤(Steps)、验证门(Verification Gates)、Anti-Rationalization 表格(防止 AI 找借口跳过关键环节)。

设计原则:
– Spec-First:任何代码交付前必须有 PRD / Spec,先想清楚再动手
– Test-Driven:用红-绿-重构循环代替「先写再补测试」
– Small & Verifiable:每次改动 ≤100 行,每个任务可独立验证
– Parallel Review:v0.6.0 后 /ship 并行触发代码审查、安全审计、测试工程三路评审,汇总为单一 go/no-go 决策
– Auto-Activation:Skill 根据当前操作上下文自动激活(如正在设计 API → 自动触发 api-and-interface-design)

认可度

  • GitHub Star:101,056 颗(截至 2026-10-04,官方 API 实时核实)
  • 语言/许可证:JavaScript,MIT
  • 近期增长:持续稳定在 GitHub Trending 前列,月增量数万星
  • 社媒热度:X/Twitter、HN、51CTO 等平台持续有开发者讨论和推荐
  • 兼容 Agent:Claude Code、Cursor、Codex、GitHub Copilot、Gemini CLI、Windsurf、OpenCode、Kiro

链接

GitHub 仓库:https://github.com/addyosmani/agent-skills

原作者

Addy Osmani(GitHub: @addyosmani),Google Chrome 团队工程经理,知名开源作者,著有《Learning JavaScript Design Patterns》等技术书籍,长期活跃于前端工程与开发者工具领域。其工程规范Skill的权威性吸引了大量开发者信任。

介绍

Agent Skills 起源于一个观察:AI 编程工具天然倾向于走最短路径——跳过 spec、跳过测试、不做安全审查直接上线。这套技能库通过把 Google 内部工程文化(Hyrum’s Law:「公开 API 的行为即使未文档化也视为承诺」;Beyoncé Rule:「同一环境中的多个服务要有独立测试」;trunk-based development 等)编码为 Skill 文件,让 AI Agent 在每次介入时都遵循这些纪律。

整个 Skill 包覆盖软件开发的六大阶段,每阶段对应一个核心指令:

阶段 指令 说明
定义 /spec 写 PRD / 产品规范,Spec before code
规划 /plan 将 Spec 拆解为原子化可验证任务
构建 /build 增量交付,每片功能独立可测
验证 /test 驱动测试,红-绿-重构循环
审查 /review 代码审查,五重质量门
上线 /ship 分阶段发布,并行触发四维评审

Skill 以纯 Markdown 文件存在(SKILL.md 格式),可被任何支持 Agent Skills 标准的工具加载,支持按需安装或全量安装。

特点

  • 24 个结构化 Skill:覆盖从需求采集到上线的完整工程生命周期
  • 8 条斜杠命令:/spec /plan /build /test /review /code-simplify /ship /webperf,对应不同开发阶段
  • Anti-Rationalization 机制:内置「借口识别」表,防止 AI 用「先发布再修复」等理由跳过质量门
  • 多 Agent 兼容:不仅支持 Claude Code,还支持 Cursor、Codex、Copilot、Gemini CLI、Windsurf、Kiro、OpenCode 等主流 AI 编程工具
  • 并行评审管道:/ship v0.6.0+ 实现代码审查员、安全审计员、测试工程师三路并行,综合决策是否放行
  • 自动上下文激活:Skill 根据正在进行的操作类型自动触发,无需人工干预
  • MIT 许可证:完全开源,可自由定制和分发

使用方法

安装方式一(推荐,Claude Code 插件市场):

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

安装方式二(本地克隆):

git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills

Cursor 用户:将 SKILL.md 文件复制到 .cursor/rules/ 目录,或直接引用整个 skills 目录。

基本使用:

# 定义要做什么(先写规范)
/spec

# 规划如何做
/plan

# 增量构建
/build

# 写测试并验证
/test

# 提交审查
/review

# 并行评审后上线
/ship

使用场景与人群

适用场景:
– 团队在用 Claude Code / Cursor 做中大型功能开发,需要统一工程纪律
– AI 生成的代码质量不稳定,需要强制测试和安全审查环节
– 希望 AI 遵循 trunk-based development 和 code review 规范
– 多名开发者共用 AI 编程工具,需要一致的工程流程

目标用户:
– 使用 Claude Code、Cursor 等 AI 编程工具的专业开发者
– 工程团队负责人,想在 AI 辅助开发中保持代码质量标准
– AI 编程工具的重度用户,对 AI「跳步」问题有困扰

输入与输出案例

案例一:使用 /spec 定义功能

Input(用户对 Claude Code 说):/spec 然后描述需求:「实现一个支持 OAuth2 的第三方登录模块」

Output:Claude 生成一份结构化 PRD,包含:背景与目标、用户故事、API 设计(含端点、鉴权流程)、错误处理方案、安全考量(OAuth2 state 参数、CSRF 防护)、验收标准。每项都有检查点,无规范文档不进入下一阶段。

案例二:使用 /ship 并行评审

Input(用户):/ship — 对一个含数据库迁移和 API 改动的 PR 触发上线流程

Output:Claude 启动三路并行处理——代码审查员检查改动范围与代码质量;安全审计员扫描 SQL 注入、XSS 等 OWASP Top 10 风险;测试工程师运行全套集成测试。三路结果汇总后输出「GO / NO-GO」决策,并附具体阻塞项(如「安全门:发现一处未参数化查询,需修复后重审」)。


GitHub:https://github.com/addyosmani/agent-skills


GitHub: https://github.com/addyosmani/agent-skills

评论区

0 条评论

登录后可评论。

Skill超级捕获手 415 阅读