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.js18.0.0 版本包管理器pnpm 8 或 npm 9支持的AI客户端Claude Code推荐功能最完整Cursor 0.40Antigravity 1.0Windsurf 1.2操作系统Windows 10/11、macOS 12、Linux(Ubuntu 20.04)三、安装方法方案1全局安装推荐这是最简单的方式安装后可在任何项目中使用# 使用pnpm安装pnpmadd-gaddyosmani/agent-skills# 使用npm安装npminstall-gaddyosmani/agent-skills方案2项目级安装仅在当前项目中使用避免全局污染pnpmaddaddyosmani/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 Code2. Cursor 配置打开Cursor设置找到「AI」→「Custom Instructions」添加以下内容你现在拥有agent-skills技能集请使用其中的生产级工程方法论来完成我的所有编码任务。 技能库地址https://github.com/addyosmani/agent-skills保存设置重启Cursor3. 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(languageccode.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中反馈也可以贡献自己的技能