Addy Osmani 生产级 AI 工程技能库 agent-skills：让 Claude 从”能跑”到”可合并PR”

Claude Code、Cursor、Codex 这些 AI 编程工具已经非常强大，但用过的人几乎都遇到过同一个痛点：给它一个模糊需求，它噼里啪啦写完代码、跑完测试，潇洒地说「Done!」——结果代码根本没有产品思维、没有测试覆盖、PR 描述写得像乱码。Addy Osmani 的 agent-skills 解决的正是这个问题：把资深工程师的工程文化——Spec → Plan → Build → Test → Review → Ship——封装成 AI Agent 可执行的 Skill，让 AI 的输出从「能跑」变成「可合并」。

功能与原则

核心能力： 将软件工程生命周期（Define → Plan → Build → Verify → Review → Ship）的每一个环节封装为可被 AI Agent 自动调用的 Skill。8 条斜杠命令（/spec、/plan、/build、/test、/review、/ship、/webperf、/code-simplify）覆盖从需求定义到上线监控的完整流程。

设计原则：
– Spec before Code：任何代码实现前必须有规格说明
– Small, atomic tasks：任务拆分到最小可执行单元
– One slice at a time：增量构建，一次只做一件事
– Tests are proof：测试即证明，不是可选项
– Improve code health：Review 改善代码健康，不只是找 bug

认可度

• GitHub Star：84,029（截至 2026-08-08）
• 今日新增：1,131 星（持续 trending）
• Fork：8,977
• GitHub Trending 多次上榜
• CSDN、博客园等技术社区多篇深度解析文章
• 被 Cursor、Codex、Copilot、Cline、Gemini CLI、Windsurf 等 70+ 主流 AI 编程工具兼容

链接

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

原作者

Addy Osmani（GitHub: @addyosmani）
Google Chrome 团队工程负责人，前端社区知名大牛。著有《JavaScript 设计模式》《高性能网站建设指南》等经典技术书籍，是 Web 性能优化领域最具影响力的作者之一。

介绍

agent-skills 不是一个模型，也不是一个工具——它是一套生产级工程技能框架。Addy Osmani 将自己在 Google 十余年做工程负责人积累的「资深工程师工作方法」提炼成 24 个可组合的 Skill，每个 Skill 对应一个工程环节的最佳实践。

当你让 AI 编程助手「帮我加一个用户导出功能」时，传统的 AI 会直接开写。但装了 agent-skills 后，AI 会先问：「导出的数据格式是什么？需要支持哪些字段？要不要分页？有没有隐私合规要求？」——这就是 /spec 的力量，先把需求对齐，再动代码。

整个框架围绕一个六阶段开发环：IdeaRefine → SpecPRD → CodeImpl → TestDebug → QAGate → GoLive。每个阶段对应明确的输入、输出和质量门禁，AI 会自动在合适的时机激活对应 Skill。

特点

• 8 条斜杠命令覆盖全流程：/spec 定规格、/plan 做任务拆分、/build 增量实现、/test TDD 驱动、/review 五轴代码审查、/webperf 性能审计、/code-simplify 简化代码、/ship 一键上线
• 自动上下文激活：设计 API 时自动触发 api-and-interface-design，构建 UI 时自动加载 frontend-ui-engineering，无需手动指定
• 70+ 工具兼容：Claude Code、Cursor、Codex、Copilot、Cline、Gemini CLI、Windsurf、Antigravity CLI，安装到任何主流 AI 编程工具
• 可单独安装：用 npx skills add addyosmani/agent-skills --skill <name> 按需安装，不需要的 Skill 不装
• /build auto 自动化：批准计划后自动生成任务列表并逐一执行，每个任务仍 TDD 驱动，失败自动暂停

使用方法

一键安装全部（推荐）：

npx skills add addyosmani/agent-skills

Claude Code 原生插件安装：

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

只安装特定 Skill：

npx skills add addyosmani/agent-skills --skill code-review-and-quality
npx skills add addyosmani/agent-skills --skill test-driven-development
npx skills add addyosmani/agent-skills --skill interview-me

查看所有 Skill：

npx skills add addyosmani/agent-skills --list

使用场景与人群

适用场景：
– 团队级 AI 编程项目，需要统一的工程标准
– AI 输出质量不稳定，代码可维护性差
– 想让 AI 自主完成从需求到上线的完整流程
– 代码审查流程不规范，PR 质量参差不齐

目标用户：
– 使用 Claude Code、Cursor、Codex 等 AI 编程工具的个人开发者
– 引入 AI 辅助编程但缺乏工程规范的团队
– 希望 AI 输出「可合并 PR」而非「能跑就行」的工程师

输入与输出案例

案例 1：需求定义

• Input：/spec 添加一个图片上传功能，支持 JPG/PNG，最大 5MB，需要压缩
• Output：AI 追问「压缩到什么分辨率？」「要不要生成缩略图？」「上传失败重试策略？」——输出结构化规格文档，确认后才开始实现

案例 2：增量构建

• Input：/build（在已批准的 Spec 基础上）
• Output：自动拆分任务列表 → 实现基础版 → 写测试用例 → TDD 验证 → 提交 → 继续下一项，全程无需人工介入，失败时自动暂停等待指令

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