165 lines
7.3 KiB
Markdown
165 lines
7.3 KiB
Markdown
# Antigravity Awesome Skills 入门指南 (V11.5.0)
|
||
|
||
**新手入门？本指南将在 5 分钟内帮助您增强 AI 代理的能力。**
|
||
|
||
> **💡 安装后不知道该做什么？** 查看 [**完整使用指南**](usage.md) 获取详细说明和示例！
|
||
|
||
---
|
||
|
||
## 什么是"技能"(Skills)？
|
||
|
||
AI 代理（如 **Claude Code**、**Gemini**、**Cursor**）非常智能，但它们缺乏关于您工具的特定知识。
|
||
**技能** 是专门的操作手册（markdown 文件），用于教授您的 AI 如何完美地执行特定任务。
|
||
|
||
**类比：** 您的 AI 是一个聪明的实习生。**技能** 是使它们成为高级工程师的 SOP（标准操作程序）。
|
||
|
||
---
|
||
|
||
## 快速入门："入门包"(Starter Packs)
|
||
|
||
不要因为仓库的规模而感到恐慌。您不需要一次性安装所有内容。
|
||
我们策划了**入门包** 以帮助您立即开始使用。
|
||
|
||
您**只需安装一次完整的仓库**（通过 npx 或克隆）；入门包是按角色策划的列表，帮助您**选择要使用哪些技能**（例如 Web Wizard、Hacker Pack）——它们不是另一种安装方式。
|
||
|
||
### 1. 安装仓库
|
||
|
||
**选项 A — npx（最简单）：**
|
||
|
||
```bash
|
||
npx antigravity-awesome-skills
|
||
```
|
||
|
||
默认情况下，这会克隆到 `~/.agents/skills`。使用 `--cursor`、`--claude`、`--gemini`、`--codex` 或 `--kiro` 为特定工具安装，或使用 `--path <dir>` 指定自定义位置。运行 `npx antigravity-awesome-skills --help` 查看详细信息。
|
||
|
||
如果看到 404 错误，请使用：`npx github:sickn33/antigravity-awesome-skills`
|
||
|
||
**选项 B — git clone：**
|
||
|
||
```bash
|
||
# 通用（适用于大多数代理）
|
||
git clone https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills
|
||
```
|
||
|
||
### 2. 选择您的角色
|
||
|
||
找到与您角色匹配的捆绑包（参见 [bundles.md](bundles.md)）：
|
||
|
||
| 角色 | 捆绑包名称 | 内容 |
|
||
| :-------------------- | :------------- | :------------------------------------------------ |
|
||
| **Web 开发者** | `Web Wizard` | React 模式、Tailwind 精通、前端设计 |
|
||
| **安全工程师** | `Hacker Pack` | OWASP、Metasploit、渗透测试方法论 |
|
||
| **经理 / 产品经理** | `Product Pack` | 头脑风暴、规划、SEO、战略 |
|
||
| **所有功能** | `Essentials` | 清洁代码、规划、验证（基础） |
|
||
|
||
---
|
||
|
||
## 捆绑包 vs 工作流
|
||
|
||
捆绑包和工作流解决不同的问题：
|
||
|
||
- **捆绑包** = 按角色策划的集合（选择什么）。
|
||
- **工作流** = 分步剧本（如何执行）。
|
||
|
||
首先从 [bundles.md](bundles.md) 中的捆绑包开始，然后在需要指导执行时从 [workflows.md](workflows.md) 运行工作流。
|
||
|
||
示例：
|
||
|
||
> "使用 **@antigravity-workflows** 并为我的项目想法运行 `ship-saas-mvp`。"
|
||
|
||
---
|
||
|
||
## 如何使用技能
|
||
|
||
安装后，只需自然地与您的 AI 对话。
|
||
|
||
### 示例 1：规划功能（**Essentials**）
|
||
|
||
> "使用 **@brainstorming** 帮助我设计新的登录流程。"
|
||
|
||
**发生什么：** AI 加载头脑风暴技能，向您提出结构化问题，并生成专业规范。
|
||
|
||
### 示例 2：检查代码（**Web Wizard**）
|
||
|
||
> "在此文件上运行 **@lint-and-validate** 并修复错误。"
|
||
|
||
**发生什么：** AI 遵循技能中定义的严格代码检查规则来清理您的代码。
|
||
|
||
### 示例 3：安全审计（**Hacker Pack**）
|
||
|
||
> "使用 **@api-security-best-practices** 审查我的 API 端点。"
|
||
|
||
**发生什么：** AI 根据 OWASP 标准审计您的代码。
|
||
|
||
---
|
||
|
||
## 🔌 支持的工具
|
||
|
||
| 工具 | 状态 | 路径 |
|
||
| :-------------- | :-------------- | :-------------------------------------------------------------------- |
|
||
| **Claude Code** | ✅ 完全支持 | `.claude/skills/` 或通过 `/plugin marketplace add sickn33/antigravity-awesome-skills` 安装 |
|
||
| **Gemini CLI** | ✅ 完全支持 | `.gemini/skills/` |
|
||
| **Codex CLI** | ✅ 完全支持 | `.codex/skills/` |
|
||
| **Kiro CLI** | ✅ 完全支持 | 全局：`~/.kiro/skills/` · 工作区：`.kiro/skills/` |
|
||
| **Kiro IDE** | ✅ 完全支持 | 全局：`~/.kiro/skills/` · 工作区：`.kiro/skills/` |
|
||
| **Antigravity** | ✅ 原生支持 | 全局：`~/.agents/skills/` · 工作区：`.agent/skills/` |
|
||
| **Cursor** | ✅ 原生支持 | `.cursor/skills/` |
|
||
| **OpenCode** | ✅ 完全支持 | `.agents/skills/` |
|
||
| **AdaL CLI** | ✅ 完全支持 | `.adal/skills/` |
|
||
| **Copilot** | ⚠️ 仅文本 | 手动复制粘贴 |
|
||
|
||
---
|
||
|
||
## 信任与安全
|
||
|
||
我们对技能进行分类，以便您了解正在运行的内容：
|
||
|
||
- 🟣 **官方**：由 Anthropic/Google/供应商维护（高信任度）。
|
||
- 🔵 **安全**：非破坏性的社区技能（只读/规划）。
|
||
- 🔴 **风险**：修改系统或执行安全测试的技能（仅授权使用）。
|
||
|
||
添加新技能时，高风险指导会在发布前通过仓库范围的 `security:docs` 扫描进行额外审查。
|
||
|
||
_查看 [技能目录](../../CATALOG.md) 获取完整列表。_
|
||
|
||
---
|
||
|
||
## FAQ
|
||
|
||
如果您更喜欢使用 Claude Code 的插件市场流程而不是复制到 `.claude/skills/`，请使用：
|
||
|
||
```text
|
||
/plugin marketplace add sickn33/antigravity-awesome-skills
|
||
/plugin install antigravity-awesome-skills
|
||
```
|
||
|
||
**问：我需要安装每个技能吗？**
|
||
答：您只需克隆一次整个仓库；您的 AI 仅_读取_您调用（或相关）的技能，因此保持轻量级。[bundles.md](bundles.md) 中的**入门包** 是策划的列表，帮助您发现适合您角色的正确技能——它们不会改变您的安装方式。
|
||
|
||
**问：我可以制作自己的技能吗？**
|
||
答：可以！使用 **@skill-creator** 技能来构建您自己的技能。
|
||
|
||
**问：如果 Antigravity 在 Windows 上遇到截断崩溃循环卡住怎么办？**
|
||
答：按照 [windows-truncation-recovery.md](windows-truncation-recovery.md) 中的恢复步骤操作。它说明了哪些 Antigravity 存储文件夹需要备份和清除，并包含可选的批处理助手，改编自 [issue #274](https://github.com/sickn33/antigravity-awesome-skills/issues/274)。
|
||
|
||
**问：如果 Antigravity 在 Linux 或 macOS 上因太多技能激活而过载怎么办？**
|
||
答：使用 [agent-overload-recovery.md](agent-overload-recovery.md) 中的激活流程。它展示如何从克隆的仓库运行 `scripts/activate-skills.sh`，以便您可以将完整的库归档，并仅激活实时 Antigravity 目录中所需的捆绑包或技能。
|
||
|
||
**问：这是免费的吗？**
|
||
答：是的。原始代码和工具采用 MIT 许可证，原始文档/非代码编写内容采用 CC BY 4.0。参见 [../../LICENSE](../../LICENSE) 和 [../../LICENSE-CONTENT](../../LICENSE-CONTENT)。
|
||
|
||
---
|
||
|
||
## 下一步
|
||
|
||
首先需要特定工具的起点？
|
||
|
||
- [Claude Code 技能](claude-code-skills.md)
|
||
- [Cursor 技能](cursor-skills.md)
|
||
- [Codex CLI 技能](codex-cli-skills.md)
|
||
- [Gemini CLI 技能](gemini-cli-skills.md)
|
||
|
||
1. [浏览捆绑包](bundles.md)
|
||
2. [查看真实示例](../contributors/examples.md)
|
||
3. [贡献技能](../../CONTRIBUTING.md)
|