Agent Skills 完全指南：用 Addy Osmani 的开源框架提升 AI 编程效率

Agent Skills 是什么？

Agent Skills 是由 Addy Osmani（Google Chrome 团队资深工程师，Web 性能领域知名专家）创建的一个开源框架，旨在为 AI 编程助手（如 Claude Code、Cursor、Windsurf 等）提供生产级的工程技能和最佳实践。

简单来说，Agent Skills 将资深软件工程师在开发过程中使用的工作流、质量门禁和最佳实践编码成可复用的技能包，让 AI Agent 能够像经验丰富的工程师一样，在每个开发阶段都保持一致的高标准。

为什么需要 Agent Skills？

当前 AI 编程助手（Claude Code、Codex、Gemini CLI 等）虽然能生成代码，但往往缺乏系统性的工程思维：

• ❌ 直接写代码，不先写规格说明（Spec）
• ❌ 一次性实现太多功能，任务粒度过大
• ❌ 缺少测试驱动开发的意识
• ❌ 代码审查流于形式
• ❌ 部署前没有充分验证

Agent Skills 通过 7 个 Slash 命令映射完整的开发生命周期，每个命令会自动激活对应的技能模块：

项目亮点

• 🚀 GitHub 38,971+ stars，社区活跃度高
• 🔧 支持多个 AI 平台：Claude Code、Cursor、Windsurf、OpenClaw 等
• 📦 模块化设计：每个技能独立封装，可按需启用
• 🎯 自动化触发：根据上下文自动激活相关技能（如设计 API 时自动触发 api-and-interface-design）
• 🆓 完全开源免费：MIT 许可证

安装 Agent Skills

前置条件

• 已安装 Claude Code 或其他支持的 AI 编程助手
• GitHub 账号（用于 Marketplace 安装）

方法一：通过 Claude Code Marketplace 安装（推荐）

# 添加插件
/plugin marketplace add addyosmani/agent-skills

# 安装
/plugin install agent-skills@addy-agent-skills

如果遇到 SSH 错误（Marketplace 默认通过 SSH 克隆仓库），可以改用 HTTPS URL：

/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills

方法二：本地安装（适合开发者调试）

# 克隆仓库
git clone https://github.com/addyosmani/agent-skills.git

# 指定插件目录启动 Claude Code
claude --plugin-dir /path/to/agent-skills

方法三：Cursor 用户

对于 Cursor 编辑器用户，可以将任意 SKILL.md 文件复制到 .cursor/rules/ 目录下：

# 复制所有技能文件
cp -r agent-skills/skills/* ~/.cursor/rules/

或者在 Cursor 设置中引用远程仓库。

方法四：其他 AI 助手

Agent Skills 的核心是 Markdown 格式的技能描述文件（SKILL.md），理论上任何支持自定义规则的 AI 编程助手都可以使用：

• Windsurf：将 SKILL.md 放入 .windsurfrules/
• OpenClaw：参考项目的 skills/ 目录结构
• 自定义 Agent：解析 SKILL.md 并注入到 system prompt 中

核心功能实战

1. /spec — 先写规格，再写代码

这是 Agent Skills 最重要的理念之一：在写任何代码之前，先明确你要构建什么。

使用方法：

/spec 我想构建一个 REST API，支持用户注册、登录和 JWT 认证

AI 会生成一份结构化的规格文档，包括：

• 功能需求列表
• API 端点设计
• 数据模型定义
• 技术栈选择理由
• 验收标准

示例输出片段：

## API 规格说明

### 端点设计

- POST /api/auth/register
  - 请求体: { email, password, name }
  - 响应: { userId, token }
  - 错误: 409 (邮箱已存在), 400 (密码强度不足)

- POST /api/auth/login
  - 请求体: { email, password }
  - 响应: { token, expiresIn }

### 数据模型

User:
  - id: UUID
  - email: string (unique, indexed)
  - password_hash: string (bcrypt)
  - created_at: timestamp

2. /plan — 小而原子的任务

有了规格后，不要急着写代码。先用 /plan 将大任务拆解为小而原子的子任务，每个任务应该：

• 可在 15-30 分钟内完成
• 有明确的输入和输出
• 可独立测试

使用方法：

/plan 基于上面的规格，规划实现步骤

AI 会生成类似这样的任务列表：

## 实施计划

### Phase 1: 项目初始化
- [ ] Task 1.1: 初始化 Node.js 项目，安装 express、jsonwebtoken、bcrypt
- [ ] Task 1.2: 配置 ESLint + Prettier
- [ ] Task 1.3: 设置数据库连接（PostgreSQL + Prisma）

### Phase 2: 用户模型
- [ ] Task 2.1: 定义 User Schema
- [ ] Task 2.2: 编写单元测试：创建用户、查询用户

### Phase 3: 认证逻辑
- [ ] Task 3.1: 实现密码哈希工具函数
- [ ] Task 3.2: 实现 JWT 生成和验证
- [ ] Task 3.3: 编写集成测试：注册 → 登录 → 验证 token
...

3. /build — 增量式构建

这是最强大的命令之一。/build 会自动生成计划并逐个执行所有任务，你只需批准一次计划，然后它可以自主运行。

关键设计理念： - ✅ 移除人工逐步确认的繁琐步骤 - ✅ 保留每个任务的测试驱动和独立提交 - ✅ 遇到失败或高风险步骤时自动暂停

使用方法：

/build 实现上述计划

AI 会： 1. 显示完整计划供你审批 2. 批准后，逐个执行任务 3. 每个任务完成后自动运行测试 4. 测试通过后提交 git commit 5. 遇到错误时暂停并等待人工干预

4. /test — 测试即证明

Agent Skills 强调测试驱动开发（TDD）。在执行任何代码变更前，先确保有相应的测试。

使用方法：

/test 为新添加的用户注册接口编写测试

AI 会生成： - 单元测试（Jest/Vitest） - 集成测试（Supertest） - 边界情况测试（空值、重复邮箱、弱密码等）

5. /review — 提升代码健康度

在合并代码前，使用 /review 进行代码审查。这不仅检查 bug，还关注：

• 代码可读性
• 性能隐患
• 安全漏洞
• 架构一致性

使用方法：

/review 审查最近的 PR #42

6. /code-simplify — 清晰胜于聪明

这个技能专门用于重构复杂代码，遵循"清晰胜于聪明"的原则。

使用方法：

/code-simplify 简化 auth.middleware.js 中的逻辑

AI 会： - 提取长函数为小函数 - 消除嵌套过深的条件判断 - 用更直观的命名替换晦涩变量名 - 添加必要的注释

7. /ship — 更快更安全

部署前的最后检查。/ship 确保：

• 所有测试通过
• 没有未提交的变更
• CI/CD 管道正常
• 回滚方案就绪

使用方法：

/ship 准备部署到生产环境

自动触发的技能

除了手动调用 Slash 命令，Agent Skills 还会根据上下文自动激活相关技能：

这意味着你不需要记住所有命令——只需自然描述你的任务，Agent Skills 会自动匹配合适的最佳实践。

自定义技能

Agent Skills 的设计是模块化的，你可以创建自己的技能。每个技能是一个 SKILL.md 文件，包含：

---
name: my-custom-skill
description: 我的自定义技能描述
---

## 何时使用

当满足以下条件时使用此技能：
- 条件 1
- 条件 2

## 执行步骤

1. 第一步
2. 第二步
3. ...

## 注意事项

- 注意 1
- 注意 2

将文件放入 skills/ 目录即可生效。

与其他工具的对比

Agent Skills 的最大优势是开放性和社区生态——任何人都可以贡献技能，形成共享的最佳实践库。

总结

Agent Skills 代表了 AI 编程助手的下一个演进方向：从"能写代码"到"会工程化"。

通过将资深工程师的经验编码为可复用的技能包，它让 AI Agent 不再只是代码生成器，而是真正具备系统性思维的工程伙伴。

推荐阅读路径：

1. 先阅读 官方文档 了解完整技能列表
2. 从 /spec 和 /plan 开始，培养"先思考再编码"的习惯
3. 尝试 /build 体验自动化执行的魅力
4. 根据需要自定义或贡献新技能

对于正在使用 Claude Code、Cursor 或其他 AI 编程助手的开发者来说，Agent Skills 是一个值得投入时间学习的生产力倍增器。

相关链接：

• Agent Skills GitHub 仓库
• Addy Osmani 个人网站
• Claude Code 官方文档