AI编码助手技能库：Antigravity Awesome Skills安装与实战指南

1. 项目概述：一个为AI编码助手准备的“技能库”

如果你和我一样，每天都在和Claude Code、Cursor、GitHub Copilot这些AI编码助手打交道，那你肯定遇到过这样的场景：想让AI帮你写个单元测试，得先花五分钟描述清楚测试框架、边界条件和断言逻辑；想让它做个安全审计，又得把OWASP Top 10的关键点复述一遍。每次都要重新“教”AI，效率实在不高。

Antigravity Awesome Skills这个项目，就是为了解决这个问题而生的。你可以把它理解为一个专为AI编码助手打造的“技能应用商店”或“工具箱”。它不是一个简单的提示词合集，而是一个包含1431+个可安装、可复用的SKILL.md“剧本”的GitHub库。这些剧本覆盖了从项目规划、编码、调试、测试、安全审查，到基础设施、产品设计甚至增长营销的方方面面。它的核心价值在于，通过结构化的操作指令，让AI助手在执行重复性任务时，能获得更好的上下文、更强的约束和更清晰的输出，从而将你从繁琐的提示工程中解放出来，真正实现“开箱即用”的高效协作。

这个项目支持主流的AI编码工具，包括Claude Code、Cursor、Codex CLI、Gemini CLI、Antigravity、Kiro等。无论你是全栈开发者、安全工程师，还是产品经理，都能在这里找到提升你与AI协作效率的利器。

2. 核心设计思路：从“灵感库”到“生产力工具”的转变

很多类似的仓库只是罗列了一些提示词片段，供人复制粘贴。Antigravity Awesome Skills的设计哲学完全不同，它致力于成为一个真正的“生产力工具”。这种转变体现在以下几个关键设计决策上。

2.1 可安装性与生态集成

项目最核心的特性是“可安装”。它提供了一个npm安装器（npx antigravity-awesome-skills），能够一键将技能库部署到你的AI工具预期的目录中。例如，对于Antigravity，默认会安装到~/.gemini/antigravity/skills；对于Cursor，则可以通过--cursor标志安装到.cursor/skills/目录。

注意：这种设计避免了手动复制文件带来的版本管理和路径错误问题。安装器使用浅克隆，确保首次安装轻量快速。

为什么强调可安装性？因为只有集成到工具的工作流中，技能才能被无缝调用。想象一下，在Cursor的聊天框里直接输入@brainstorming来启动头脑风暴，远比打开一个文档、复制一段提示词、再粘贴回聊天框要流畅得多。这种设计让技能从“需要主动查找的参考资料”，变成了“唾手可得的工具”。

2.2 结构化与模块化：SKILL.md 剧本

每个技能都是一个独立的目录，其中包含一个SKILL.md文件。这个文件不是随意的提示词，而是一个结构化的“剧本”。一个典型的SKILL.md会包含：

• 角色与目标：清晰定义AI在此次协作中扮演的角色（如“安全审计员”、“测试工程师”）和要达成的具体目标。
• 上下文与约束：提供任务相关的背景知识、行业最佳实践（如API设计原则、React性能优化模式）以及必须遵守的约束条件（如代码风格、安全规范）。
• 操作步骤与示例：将复杂任务分解为可执行的步骤，并提供输入输出的示例，引导AI按既定流程工作。
• 输出格式：明确要求AI以特定的格式（如Markdown表格、JSON、结构化的代码块）交付结果，便于后续处理。

这种模块化设计带来了巨大的灵活性。你可以单独使用某个技能解决特定问题，也可以通过“捆绑包”（Bundles）和“工作流”（Workflows）将多个技能组合起来，应对更复杂的场景。

2.3 面向不同用户的路径设计：广度优先 vs. 深度优先

面对1400多个技能，新用户很容易感到无从下手。项目通过多路径入口解决了这个问题：

1. 全库安装：适合想要探索所有可能性的高级用户或研究者。一条命令即可获得完整技能库。
2. 捆绑包：按角色或目标预定义的技能组合。例如，“Web Wizard”捆绑包可能包含前端设计、API集成、性能优化等技能；“安全工程师”捆绑包则聚焦于代码审计、依赖扫描、漏洞分析。这是绝大多数用户的最佳起点。
3. 工作流：为达成特定成果（如“发布一个SaaS MVP”）而设计的有序执行剧本。它会告诉你先调用哪个技能进行规划，再调用哪个进行开发，接着进行测试，最后进行部署。工作流确保了技能执行的逻辑性和连贯性。
4. 插件分发：针对Claude Code和Codex等支持插件的工具，项目提供了插件市场兼容的分发方式。这与全库安装的区别在于，插件更强调安全性和沙箱环境，适合在团队或受控环境中使用。

这种设计确保了无论是追求“广度”的探索者，还是追求“深度”和“效率”的实践者，都能快速找到适合自己的使用路径。

3. 核心技能解析与实战应用要点

技能库的广度令人印象深刻，但深度才是其价值所在。我们深入看几个核心技能类别，理解它们如何在实际工作中发挥作用。

3.1 开发与工程类技能

这是技能库中最庞大的部分，旨在将软件工程的最佳实践“编码”进AI的协作中。

• @test-driven-development：这不是简单地让AI写测试。这个技能会强制AI遵循严格的TDD循环：先写一个必定失败的单功能测试，再实现最小化代码使其通过，然后重构。它会引导AI思考测试的隔离性、可读性，并避免实现细节泄露。对于新手来说，这相当于一个随身的TDD教练。
• @api-design-principles：当设计API时，AI会基于RESTful原则、HATEOAS（可选的）、一致的命名规范、版本化策略、错误处理格式（如Problem Details for HTTP APIs）以及安全性考量（如认证、限流）来提供建议。它能帮你产出不仅能用，而且健壮、易维护的API设计。
• @debugging-strategies：当遇到Bug时，这个技能会引导AI采用系统化的排查方法：从日志和错误信息入手，进行问题隔离（是前端、后端还是数据库？），提出可验证的假设，然后设计实验（如添加调试日志、编写复现脚本）来验证假设。它改变了AI从“猜答案”到“做侦探”的思维模式。

实操心得：在让AI使用@debugging-strategies时，一定要提供完整的错误堆栈、相关代码片段和你的环境信息。技能提供的是一套方法论，输入的上下文质量直接决定了输出结果的有效性。

3.2 安全与审计类技能

将安全左移，让AI在开发阶段就成为安全伙伴。

• @security-auditor：这是一个重量级技能。它会让AI以安全审计员的视角审查代码，检查点包括但不限于：注入漏洞（SQL、NoSQL、命令、模板）、身份认证与授权缺陷、敏感数据泄露、不安全的反序列化、使用含有已知漏洞的组件（通过分析package.json或pom.xml）、安全配置错误（如CORS、HTTPS）、不足的日志记录和监控等。它会生成一份带风险等级（高危、中危、低危）的审计报告。
• @lint-and-validate：这是一个轻量但高频使用的技能。它不仅仅是运行linter，还会检查代码风格一致性、未使用的变量/导入、可能的逻辑错误、以及基本的代码异味（code smell）。在提交代码前运行一下，能有效提升代码库的整洁度。

3.3 产品与协作类技能

这些技能扩展了AI在非纯编码领域的应用。

• @brainstorming：这是最受欢迎的通用技能之一。它通过提供结构化的头脑风暴框架（如SCAMPER、六顶思考帽、逆向思维），帮助你将一个模糊的产品想法转化为具体的MVP功能列表、用户故事和技术栈选型建议。它能有效避免思维发散和遗漏关键点。
• @create-pr：这个技能旨在规范化Pull Request的创建。它会引导AI根据本次变动的性质（功能、修复、重构、文档），生成格式规范的PR标题和描述。描述模板会包括变更动机、修改内容、测试情况、对现有功能的影响等。这大大减轻了开发者在提交代码后的文案工作，也方便了代码审查者。

4. 完整安装与多工具适配实战

理论再好，不如动手一试。下面我们以最常见的几个工具为例，完成从安装到调用的全流程。

4.1 基础安装：全库获取

无论你使用哪种工具，全库安装都是基础。打开你的终端（Terminal, CMD, PowerShell等），执行以下命令：

npx antigravity-awesome-skills

这条命令会启动安装过程。默认情况下，它会将技能库安装到Antigravity的全局技能目录（~/.gemini/antigravity/skills）。安装器使用浅克隆，所以速度很快。

安装完成后，可以通过以下命令验证：

# 检查默认目录是否存在 ls -la ~/.gemini/antigravity/skills/ # 或者查看技能数量 find ~/.gemini/antigravity/skills -name "SKILL.md" | wc -l

4.2 工具专属安装与配置

全库安装后，技能文件已经在你本地了。接下来需要根据你使用的工具，进行路径配置或使用工具专属安装命令。

1. 用于 Claude Code：Claude Code 通常从~/.claude/skills目录读取技能。你有两种方式：

• 方式一（推荐-工具专属安装）：直接使用--claude标志，安装器会自动处理路径。

  npx antigravity-awesome-skills --claude

• 方式二（手动链接）：如果你已经全库安装，可以创建一个符号链接。

  # Linux/macOS ln -s ~/.gemini/antigravity/skills ~/.claude/skills # Windows (CMD，需要管理员权限) mklink /D C:\Users\你的用户名\.claude\skills C:\Users\你的用户名\.gemini\antigravity\skills

在Claude Code中使用：在聊天框中，你可以通过>> /技能名的格式来调用。例如，输入>> /brainstorming 帮我规划一个个人博客系统。

2. 用于 Cursor：Cursor 的技能目录是项目本地的.cursor/skills/。

• 方式一（项目级安装）：进入你的项目根目录，运行：

  npx antigravity-awesome-skills --cursor

  这会在当前项目下创建.cursor/skills/目录并填充技能。
• 方式二（全局安装并引用）：你也可以在全库安装后，在Cursor的设置中，将技能目录指向~/.gemini/antigravity/skills。在Cursor中使用：在聊天框中，使用@技能名的格式。例如，输入@security-auditor 请检查这段Node.js Express路由代码的安全性。

3. 用于 Antigravity：Antigravity 默认就使用~/.gemini/antigravity/skills目录，所以全库安装后即可直接使用。在Antigravity中使用：格式与Cursor类似，使用@技能名。

4. 用于 GitHub Copilot：Copilot 没有统一的技能目录概念。通常你需要将特定技能的SKILL.md内容，作为自定义指令（Custom Instructions）或聊天上下文的一部分手动提供。你可以从安装的目录中复制你需要的技能内容。

4.3 安装参数详解：按需定制

安装器提供了丰富的参数，让你可以精确控制安装内容，避免技能过多导致AI上下文窗口压力过大。

# 安装到自定义目录 npx antigravity-awesome-skills --path ./my-local-skills # 仅安装特定分类的技能（例如，只安装开发和后端相关技能） npx antigravity-awesome-skills --category development,backend # 仅安装风险等级为 safe 或 none 的技能（过滤掉实验性或高风险技能） npx antigravity-awesome-skills --risk safe,none # 组合使用：安装到OpenCode的目录，且只要安全的后端开发技能 npx antigravity-awesome-skills --path .agents/skills --category backend --risk safe

这些参数对于使用OpenCode这类对上下文长度敏感的工具尤其重要，可以实现“按需加载，精细控制”。

5. 捆绑包与工作流：高阶使用指南

当你熟悉了单个技能的使用后，捆绑包和工作流能将你的效率提升到新的高度。

5.1 使用捆绑包快速启动

捆绑包文件位于docs/users/bundles.md。它不是一个独立的可安装实体，而是一个“推荐清单”。例如，“Full-Stack Developer”捆绑包可能推荐了以下技能：

• @frontend-design(UI/UX)
• @api-design-principles(后端API)
• @database-design(数据层)
• @test-driven-development(测试)
• @deployment-checklist(部署)

你的操作步骤是：

1. 查看bundles.md，找到符合你当前角色或任务的捆绑包（如“SaaS MVP”、“Security Engineer”）。
2. 记下捆绑包内推荐的技能名称。
3. 在你的AI工具中，依次或组合使用这些技能来完成任务。

例如，要开发一个新功能，你可以：

1. 用@brainstorming进行功能拆解。
2. 用@api-design-principles设计接口。
3. 用@test-driven-development编写实现和测试。
4. 用@create-pr生成提交说明。

5.2 遵循工作流执行复杂任务

工作流文件位于docs/users/workflows.md。它更像一个完整的项目剧本。以“Ship a SaaS MVP”工作流为例，它可能包含以下阶段和对应的技能：

使用工作流时，你不再是随机地调用技能，而是按照一个经过验证的、有序的流程来推进项目，极大减少了决策成本和遗漏风险。

6. 常见问题与故障排查实录

在实际使用中，你可能会遇到一些问题。以下是我和社区成员遇到过的一些典型情况及解决方案。

6.1 安装与路径问题

问题1：安装命令执行失败，提示网络或权限错误。

• 排查：首先检查Node.js和npm版本是否过旧（建议Node.js > 16，npm > 8）。可以尝试使用npm cache clean --force清除缓存后重试。如果使用公司网络，可能需要配置代理。
• 解决方案：也可以选择手动克隆仓库到本地目录，然后将该目录链接或复制到你的AI工具的技能路径下。

  git clone --depth 1 https://github.com/sickn33/antigravity-awesome-skills.git /path/to/local/skills # 然后手动创建符号链接或复制文件

问题2：技能安装成功，但在AI工具中无法识别或调用。

• 排查：99%的问题出在路径上。确认技能文件是否确实安装到了你的AI工具正在读取的目录。
  • Claude Code:~/.claude/skills/
  • Cursor:你的项目根目录/.cursor/skills/
  • Antigravity:~/.gemini/antigravity/skills/
• 解决方案：检查AI工具的设置或文档，确认其技能目录配置。有时需要重启AI工具或重新加载编辑器窗口才能识别新技能。

6.2 技能使用与效果问题

问题3：调用技能后，AI的回复似乎没有遵循技能指令，或效果不佳。

• 排查：这通常是由于上下文冲突或指令不清晰造成的。AI的上下文窗口是有限的，如果你在聊天中已经有了很长的历史记录，新加入的技能指令可能会被挤到上下文之外，或与其他指令冲突。
• 解决方案：
  1. 开启新会话：对于重要的、复杂的任务，建议开启一个新的聊天会话，并首先调用技能。
  2. 明确指令：在调用技能时，除了技能名，务必提供清晰、具体的任务描述。例如，@security-auditor 请审查下面这段用户登录API的代码，重点关注SQL注入和会话管理漏洞。就比@security-auditor 看看这段代码要好得多。
  3. 检查技能完整性：偶尔，社区贡献的技能可能不够完善。你可以直接打开对应的SKILL.md文件查看其内容，必要时进行微调以适应你的具体需求。

问题4：技能太多，导致AI响应变慢或出错。

• 排查：一些工具（尤其是早期版本的Antigravity或某些配置下）会在启动时加载所有技能文件到上下文，如果技能库过大，可能触及上下文长度限制或导致性能下降。
• 解决方案：
  1. 使用过滤安装：如前所述，使用--category和--risk参数进行精简安装。
  2. 动态管理：对于支持动态加载的工具，可以建立一个“常用技能”目录，只将当前项目需要的技能链接或复制过去。项目提供了Workspace Manager这样的社区工具来辅助此过程。
  3. 参考恢复指南：项目文档中的agent-overload-recovery.md提供了详细的解决方案。

6.3 社区与贡献问题

问题5：我想贡献一个新技能，流程是怎样的？

1. Fork仓库：在GitHub上Fork本项目。
2. 创建技能：在skills/目录下创建一个新的文件夹，例如skills/my-awesome-skill/。
3. 编写SKILL.md：参照docs/contributors/skill-template.md模板，编写你的技能剧本。务必确保结构清晰、目标明确、示例详实。
4. 本地验证：在项目根目录运行npm run validate，确保你的技能格式正确，没有语法错误。
5. 提交PR：将你的修改推送到你的Fork，然后向主仓库发起Pull Request。
6. 代码审查：你的PR会经过自动化检查（如技能格式验证）和项目维护者的人工审查。请耐心等待并积极参与讨论。

重要提示：贡献时，请只提交源代码（即你创建的SKILL.md等）。不要提交任何自动生成的目录文件，如CATALOG.md或data/*.json，这些文件由仓库的自动化流程生成。

Antigravity Awesome Skills 的价值在于它不仅仅是一个集合，更是一个不断进化的、由社区驱动的AI协作标准库。通过将人类的最佳实践编码成AI可理解的“技能”，它正在重塑我们与机器协作开发软件的方式。从今天开始，选择一个你最常用的工具，安装它，尝试调用@brainstorming来规划下一个功能，你会发现，一个更高效、更智能的编程伙伴已经就位。