34.3K+ star 的 AI 工程技能库:让编程助手写出生产级代码

AI 编程助手生成代码飞快，但为什么质量还是参差不齐？

问题不在 AI 本身，而在于缺乏工程纪律——没有人在旁边喊「先写测试」「先做安全审查」「变更太大需要拆分」。

今天介绍的这个项目，用 20 个结构化技能，给所有主流 AI 编程助手补上了这门课。

01 它是什么？

Agent Skills 是 Google 工程师 Addy Osmani 开源的生产级工程技能库，为 AI 编程代理补上「资深工程师的工作流」。

它解决的问题：当你在 Cursor、Claude Code、Gemini CLI 里写代码时，AI 默认走最短路径——能跑就行，不写测试，不做 review，不考虑安全。而这套技能库，把 DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP 的完整工程闭环，编码成了 AI 可以遵循的指令模板。

与通用提示词不同，这里的每个 Skill 都是带验证门的可执行工作流：有步骤、有检查点、有反借口清单、有退出标准。「测试以后再补」？Skill 会告诉你：不行，测试是证明。

02 核心原理/亮点

整个系统的设计哲学浓缩在三个关键词：Process、Anti-rationalization、Verification。

1. Process 而非 Prose

每个 SKILL.md 都是工作流，不是参考文档。结构固定：Overview → When to Use → Process → Rationalizations → Red Flags → Verification。AI 按步骤执行，不用理解上下文。

2. Anti-rationalization 反借口机制

这是精髓。每个 Skill 内置「常见借口 + 反驳」表格：

3. Verification 验证非可选

每个 Skill 结尾都有「Evidence Requirements」：不是「看起来对」就完了，必须有测试通过、构建输出、运行时数据。

7 个斜杠命令是技能入口：

/spec  → 先写规格说明再动手/plan  → 拆解成可验证的小任务/build → 垂直切片，一次只做一件事/test  → 红-绿-重构，测试金字塔/review → 五轴 review，质量门禁/code-simplify → 降低复杂度，保持行为不变/ship  → 特性开关，分阶段发布，回滚预案

 每个命令背后触发对应技能集，确保 AI 执行时不会跳步。

03 应用场景

谁适合用？

• 工程团队想让 AI 编程助手输出生产级代码而非 demo

• CTO 想要统一团队的 AI 开发规范

• 开发者希望 AI 遵循自己团队的开发流程

真实场景示例：

你让 Claude Code 写一个新功能。没用 Skill 之前，它可能直接开干，代码直接提交。

用了 /spec 之后，Claude 会先问：需求是什么？边界条件？成功标准？然后输出结构化 PRD，再进入 /build。

代码完成后，/test 会强制写测试，/review 触发五轴检查（正确性、安全性、性能、可维护性、测试覆盖），/ship 前还要过 CI/CD 质量门。

全程不需要你盯着，AI 自己卡住每一步。

04 快速上手

Claude Code（推荐方式）：

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

本地开发模式：

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

Cursor：

把需要的 SKILL.md 复制到 .cursor/rules/ 目录即可。

Gemini CLI：

gemini skills install https://github.com/addyosmani/agent-skills.git--path skills

其他 IDE：

Copilot、Windsurf、OpenCode、Kiro 等均支持，详见 docs/getting-started.md。

写在最后

34K+ stars 说明这不是玩具项目——它解决的是真实痛点：AI 编程助手能写代码，但不知道怎么写好代码。

Agent Skills 把 Google 十几年的工程实践（Test Pyramid、Beyonce Rule、Hyrum's Law、Shift Left……）封装成 AI 可执行的指令集，让每一次 AI 生成都默认走正确的工程路径。

你的团队值得拥有更高质量的 AI 输出。

相关链接

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

• 官方文档：https://github.com/addyosmani/agent-skills/blob/main/docs/getting-started.md

• Skill 格式规范：https://github.com/addyosmani/agent-skills/blob/main/docs/skill-anatomy.md