antigravity-skills-reference/docs_zh-CN/users/usage.md

📖 使用指南：如何实际使用这些技能

安装后感到困惑？ 本指南逐步指导您下一步该做什么。

---

🤔 "我刚安装了仓库。现在该做什么？"

好问题！以下是刚刚发生的事情以及下一步该怎么做：

您刚刚做了什么

当您运行npx antigravity-awesome-skills或克隆仓库时，您：

✅ 下载了1,204+个技能文件到您的计算机（默认：~/.gemini/antigravity/skills/；如果使用--path则是~/.agent/skills/）
✅ 使它们对您的AI助手可用
❌ 没有自动启用它们（它们就在那里，等待使用）

可以把它想象成安装一个工具箱。您现在拥有所有工具，但您需要为每个工作选择使用哪些工具。

---

🎯 第1步：理解"包"（这不是另一个安装！）

常见困惑："我需要单独下载每个技能吗？"

答案：不需要！ 以下是包的实际含义：

包是什么

• ✅ 按角色组织的推荐技能列表（例如：Web向导、黑客包）
• ✅ 帮助您选择技能的精选起点
• ✅ 发现相关技能的省时快捷方式

包不是什么

• ❌ 单独的安装或下载
• ❌ 不同的git命令
• ❌ 需要您"激活"的东西

如何使用包

1. **查看bundles.md**浏览可用包
2. 找到匹配您角色的包
3. 从该包中选择3-5个技能开始使用
4. 在与AI的对话中引用它们

示例：

# 您是Web开发者？
查看"Web向导"包，从React Patterns、Tailwind Mastery等开始

# 您是安全工程师？
查看"安全专家"包，从Security Audit、Pen Testing等开始

---

🎯 第2步：理解技能引用语法

不同的AI工具有不同的语法，但概念相同：

Claude Code

> 使用 @skill-name 处理这个...

Gemini CLI

(用户消息) 使用 skill-name 来...

Cursor

@skill-name (在聊天中)

Antigravity IDE

(代理模式) 使用 skill... 

OpenCode

opencode run @skill-name

关键点： 您需要明确告诉AI使用哪个技能。它不会自动"知道"要使用哪个。

---

🎯 第3步：您的第一个技能会话

让我们走一遍完整示例：

场景：您需要审核一个React应用的安全性

❌ 错误方式：

用户："检查这个React应用的安全性"

→ AI会使用通用知识，可能错过具体检查项

✅ 正确方式：

用户："使用 @security-audit 检查这个React应用的安全性"

→ AI会加载security-audit技能并遵循其专门的安全检查清单

完整对话示例

用户："使用 @security-audit 审核这个电商React应用：

src/components/PaymentForm.tsx
[组件代码...]

src/components/UserAuth.tsx  
[组件代码...]"

AI："正在使用Security Audit技能进行审核...

🔍 开始安全审核清单...

✅ 认证：使用JWT，实现正确
✅ 输入验证：React Hook Form + Yup验证
⚠️ XSS防护：缺少DOMPurify，建议添加
⚠️ CSRF保护：需要在API端点实现

详细建议：
1. 安装DOMPurify: npm install dompurify
2. 在PaymentForm中添加：import DOMPurify from 'dompurify'
..."

---

🎯 第4步：掌握高级用法

1. 上下文注入

给技能提供特定背景信息：

"使用 @api-design 设计用户管理API：

要求：
- 需要JWT认证
- 支持分页和搜索
- 必须GDPR合规
- 使用TypeScript"

2. 技能组合

一次使用多个技能：

"使用 @react-patterns 构建用户资料页面，
然后用 @test-driven-development 编写测试，
最后用 @performance-analyzer 优化性能"

3. 迭代优化

逐步改进：

# 第一次
"使用 @prompt-engineer 优化这个提示：'写一个登录页面'"

# 第二次  
"使用 @prompt-engineer 进一步优化，目标：
- 转化率更高
- 适合移动端
- 包含错误处理"

---

🎯 第5步：发现合适的技能

方法1：直接询问

"我需要优化PostgreSQL查询性能，有什么相关技能？"

方法2：浏览包

查看bundles.md找到您的角色相关技能。

方法3：搜索常用技能

任务类别	常用技能
前端开发	@react-patterns, @tailwind-mastery, @frontend-design
安全	@security-audit, @pen-testing, @vulnerability-scanner
API开发	@api-design, @openapi-spec, @rest-best-practices
数据库	@schema-design, @query-optimization, @database-audit
部署	@docker-expert, @k8s-deployment, @ci-cd-pipeline
文档	@doc-coauthoring, @technical-writing, @api-documentation
测试	@test-driven-development, @testing-patterns, @e2e-testing
性能	@performance-analyzer, @optimization, @profiling

---

🔧 故障排除

问题1：AI说找不到技能

原因： 技能未安装在正确位置

解决：

# 检查安装位置
ls ~/.gemini/antigravity/skills/  # 或您的自定义路径

# 重新安装
npx antigravity-awesome-skills --path ~/.agent/skills

问题2：技能效果不理想

原因： 缺少具体上下文

解决：

# ❌ 模糊请求
"使用 @api-design 设计API"

# ✅ 具体请求  
"使用 @api-design 设计用户管理API，需要：
- JWT认证
- 分页支持
- RESTful设计
- 错误处理"

问题3：不知道用哪个技能

解决：

"我需要[任务描述]，有什么推荐的技能吗？"

# 示例
"我需要重构这个遗留代码，有什么推荐的技能吗？"

问题4：技能回答太泛泛

原因： 可能技能不适合这个具体场景

解决：

1. 尝试更具体的技能（如用@sql-injection-testing而不是@security-audit）
2. 组合多个技能
3. 提供更多上下文

---

💡 专业技巧

1. 建立"技能栈"

像技术栈一样，为每个项目建立技能栈：

# SaaS项目技能栈
@react-patterns + @api-design + @security-audit + @docker-expert

# 移动应用技能栈  
@react-native-patterns + @mobile-testing + @performance-analyzer

# 数据项目技能栈
@python-patterns + @data-visualization + @ml-model-development

2. 创建"工作流模板"

为重复任务创建模板：

# 新功能开发模板
"使用 @brainstorming 设计功能架构 → 使用 @react-patterns 实现前端 → 使用 @api-design 创建后端 → 使用 @test-driven-development 编写测试 → 使用 @performance-analyzer 优化"

# 安全审计模板  
"使用 @security-audit 进行初步扫描 → 使用 @vulnerability-scanner 深度检查 → 使用 @pen-testing 渗透测试 → 使用 @incident-response 制定响应计划"

3. 渐进式复杂度

从简单到复杂：

# 第1级：基础使用
"使用 @skill-name 处理这个"

# 第2级：上下文注入
"使用 @skill-name 处理这个，要求：..."

# 第3级：技能组合
"使用 @skill1 和 @skill2 一起处理..."

# 第4级：工作流编排
"按顺序使用这些技能：@skill1 → @skill2 → @skill3"

---

🎯 实际案例研究

案例1：快速原型开发

场景： 需要2小时内构建一个简单的CRUD应用

技能组合：

"使用 @brainstorming 设计数据库模式 → 使用 @api-design 快速生成CRUD端点 → 使用 @react-patterns 创建基础UI → 使用 @tailwind-mastery 美化界面"

结果： 1.5小时完成功能完整的应用

案例2：安全加固现有系统

场景： 需要对生产系统进行全面安全评估

技能组合：

"使用 @security-audit 进行基础检查 → 使用 @vulnerability-scanner 扫描依赖 → 使用 @pen-testing 进行渗透测试 → 使用 @incident-response 制定安全计划"

结果： 发现并修复了17个安全漏洞

案例3：性能优化

场景： React应用加载缓慢

技能组合：

"使用 @performance-analyzer 识别瓶颈 → 使用 @optimization 优化关键路径 → 使用 @profiling 深度分析 → 使用 @code-simplifier 重写低效代码"

结果： 页面加载时间从4.2秒降到1.1秒

---

🆘 获取帮助

常见问题快速解答

Q: 技能可以用在哪些AI工具上？ A: Claude Code、Gemini、Cursor、Antigravity、OpenCode、Codex等

Q: 可以同时使用多个技能吗？
A: 可以，鼓励组合使用以获得最佳效果

Q: 技能会更新吗？ A: 会，运行git pull更新仓库获取最新技能

Q: 可以自定义技能吗？ A: 可以，参见贡献指南

社区资源

• 📋 常见问题 - 更多答疑
• 🎯 技能包指南 - 发现更多技能
• 👥 GitHub讨论 - 与用户交流
• 🐛 问题报告 - 报告问题

---

🎉 恭喜！您现在是技能专家

您已掌握：

✅ 理解技能系统 - 知道技能是什么以及如何工作
✅ 掌握引用语法 - 能在不同AI工具中使用技能
✅ 学会高级技巧 - 上下文注入、技能组合、工作流编排
✅ 了解最佳实践 - 建立技能栈、创建模板、渐进式复杂度

下一步：

• 🎯 探索技能包发现更多专业技能组合
• 🔧 配置本地环境优化体验
• 🤝 加入社区与其他用户交流

开始您的技能之旅：

"使用您最需要的技能开始第一个任务吧！"

祝您使用愉快！🚀