agent-skills 完整使用教程（2026最新版）
agent-skills是由Google Chrome工程负责人Addy Osmani打造的生产级AI编码代理技能集，彻底解决了不同AI编程平台技能不互通的痛点。它基于TypeScript构建，一套技能可在Claude Code、Cursor、Antigravity等多个主流AI编辑器中无缝运行，内置了经过工业界验证的软件工程方法论，能显著提升AI生成代码的质量和可维护性。
一、项目核心信息
- 项目地址：github.com/addyosmani/agent-skills
- 开发语言：TypeScript
- 核心定位：生产级AI编码代理技能集，跨客户端兼容
- 三大核心功能：
- 跨客户端兼容：原生支持Claude Code、Cursor、Antigravity等多个AI编程平台
- 生产级工程方法论：内置代码审查、测试驱动开发(TDD)、架构诊断等最佳实践
- 工具链无关：不绑定单一工具链，一套技能可在多端复用
- 适用场景：多工具开发工作流、TypeScript工程师、提升AI编程质量、团队标准化开发
二、环境要求
- Node.js：18.0.0+ 版本
- 包管理器：pnpm 8+ 或 npm 9+
- 支持的AI客户端：
- Claude Code（推荐，功能最完整）
- Cursor 0.40+
- Antigravity 1.0+
- Windsurf 1.2+
- 操作系统：Windows 10/11、macOS 12+、Linux(Ubuntu 20.04+)
三、安装方法
方案1：全局安装（推荐）
这是最简单的方式，安装后可在任何项目中使用：
# 使用pnpm安装pnpmadd-g@addyosmani/agent-skills# 使用npm安装npminstall-g@addyosmani/agent-skills方案2：项目级安装
仅在当前项目中使用，避免全局污染：
pnpmadd@addyosmani/agent-skills --save-dev方案3：从源码安装（开发者）
适合想要自定义技能或贡献代码的用户：
gitclone https://github.com/addyosmani/agent-skills.gitcdagent-skillspnpminstallpnpmbuildpnpmlink--global四、初始配置（分客户端）
1. Claude Code 配置（推荐）
Claude Code对agent-skills的支持最完善，可直接使用所有功能：
- 打开Claude Code设置
- 找到「Skills」选项卡
- 点击「Add Skill Library」
- 输入：
@addyosmani/agent-skills - 等待安装完成，重启Claude Code
2. Cursor 配置
- 打开Cursor设置
- 找到「AI」→「Custom Instructions」
- 添加以下内容：
你现在拥有agent-skills技能集，请使用其中的生产级工程方法论来完成我的所有编码任务。 技能库地址：https://github.com/addyosmani/agent-skills - 保存设置，重启Cursor
3. Antigravity 配置
- 打开Antigravity
- 点击左侧「Skills」面板
- 点击「Import」
- 输入：
npm:@addyosmani/agent-skills - 点击「Install」完成安装
五、核心功能使用
1. 生产级代码审查
这是agent-skills最强大的功能之一，它会按照Google工程标准进行全面的代码审查：
使用agent-skills的代码审查技能，审查我当前打开的main.c文件审查维度：
- 代码风格和可读性
- 潜在的bug和安全漏洞
- 性能优化建议
- 可维护性和可扩展性
- 测试覆盖率
- 符合行业最佳实践
输出示例：
🔍 代码审查结果（基于Google工程标准） ✅ 优点： - 代码结构清晰，注释完整 - 错误处理基本到位 ⚠️ 建议改进： 1. 第45行：存在内存泄漏风险，建议使用智能指针 2. 第78行：循环中重复计算常量，建议提前提取 3. 第120行：缺少边界检查，可能导致数组越界 🔧 自动修复：是否应用以上建议？[Y/n]2. 测试驱动开发(TDD)
内置完整的TDD工作流，引导你先写测试再写实现：
使用agent-skills的TDD技能，为我开发一个STM32的GPIO驱动工作流程：
- 生成测试用例
- 运行测试（预期失败）
- 生成最小实现代码
- 运行测试（预期通过）
- 重构代码
- 重复以上步骤
3. 架构诊断与重构
对现有项目进行全面的架构分析，提供重构建议：
使用agent-skills的架构诊断技能，分析我当前项目的架构问题分析内容：
- 模块划分是否合理
- 依赖关系是否清晰
- 是否存在循环依赖
- 代码耦合度评估
- 可测试性评估
- 性能瓶颈分析
4. 跨客户端统一体验
无论你使用哪个AI客户端，agent-skills都会提供一致的输出格式和质量标准：
- 统一的代码风格
- 统一的错误处理模式
- 统一的文档格式
- 统一的测试规范
六、内置技能列表
agent-skills内置了超过50个生产级技能，以下是最常用的几个：
| 技能名称 | 功能描述 |
|---|---|
code-review | 全面的代码审查，符合Google工程标准 |
tdd-develop | 测试驱动开发工作流 |
architecture-diagnose | 项目架构诊断与重构建议 |
performance-optimize | 代码性能分析与优化 |
security-audit | 安全漏洞扫描与修复 |
documentation-generate | 自动生成高质量文档 |
refactor-code | 智能代码重构 |
debug-assist | 辅助调试，快速定位问题 |
七、高级使用技巧
1. 自定义技能开发
你可以轻松开发自己的技能，并与内置技能结合使用：
// skills/stm32-code-review.tsexportdefault{name:"stm32-code-review",description:"STM32嵌入式代码审查技能",run:async(context)=>{const{code,language}=context;// 你的自定义审查逻辑constissues=[];if(language==="c"&&code.includes("HAL_Delay")){issues.push({line:findLine(code,"HAL_Delay"),message:"建议使用定时器代替HAL_Delay，避免阻塞主线程",severity:"warning"});}return{issues};}};2. 技能组合使用
可以将多个技能组合起来，完成复杂的任务：
先使用architecture-diagnose分析项目架构，然后使用refactor-code进行重构，最后使用code-review审查重构后的代码3. 团队共享技能库
创建团队专属的技能库，统一团队的编码规范和最佳实践：
- 创建一个新的GitHub仓库
- 按照agent-skills的格式编写团队技能
- 发布到npm
- 团队成员安装使用：
pnpm add -g @your-team/agent-skills
八、常见问题与解决方案
技能安装失败：
- 检查Node.js版本是否满足要求
- 尝试使用pnpm代替npm
- 清除npm缓存：
npm cache clean --force
技能不生效：
- 重启AI客户端
- 检查技能是否正确安装
- 确认AI客户端版本是否支持
不同客户端功能差异：
- Claude Code支持所有功能
- Cursor和Antigravity目前不支持自动文件修改
- 查看官方文档了解各客户端的功能支持情况
自定义技能无法加载：
- 检查技能文件的语法是否正确
- 确保技能导出格式符合要求
- 查看日志文件排查错误
九、注意事项
- 生产环境验证：AI生成的代码和建议在生产环境使用前必须经过人工审核和充分测试
- 定期更新：agent-skills更新频繁，建议定期更新到最新版本获取新功能和修复
- 敏感信息保护：不要在技能中包含敏感信息，如API密钥、密码等
- 团队规范：建议在团队中统一使用agent-skills，形成一致的编码风格和工作流
- 反馈贡献：遇到问题可以在GitHub Issues中反馈，也可以贡献自己的技能