内容
# 🚀 Claude 代码 × 反重力 CLI 技能
> **适用于 Claude 代码的多代理技能**，可将繁重任务委托给谷歌的反重力 CLI 代理 — 在解锁网络搜索、图像生成、代码库分析和 40 多个科学数据库集成同时节省令牌。
[](LICENSE)
[](https://docs.anthropic.com/en/docs/claude-code)
[](https://blog.google/technology/google-deepmind/antigravity/)
> **从 `gemini-cli` 迁移？** 此技能是其直接继任者。Gemini CLI 二进制文件将于 **2026 年 6 月 18 日** 停止工作 — 换入此技能和 `agy` 二进制文件以保持所有功能正常。
---
## 为什么？
Claude 代码在交互式编码方面表现出色。反重力 CLI (`agy`) 拥有 Claude 所没有的专属工具 — **谷歌搜索、图像生成、Chrome DevTools 和 40 多个科学数据库**。此技能使 Claude 能够在合适的情况下智能地委托给反重力 CLI，然后仅处理最终输出。
**结果：** 您获得了两个 AI 代理的优势，同时 Claude 使用的令牌更少。
```
您 ──► Claude 代码 ──► "这需要网络搜索" ──► agy -p "..." ──► 结果 ──► Claude 代码 ──► 您
│ │
保持上下文精简 仅处理最终输出
```
## Claude 代码可以委托的内容
| 功能 | 为什么委托？ |
|-----------|---------------|
| 🔍 **网络研究** | `google_web_search` 的基础更权威、更实时，而不是 Claude 代码的 DuckDuckGo |
| 🎨 **图像生成** | 反重力具有 `generate_image` — Claude 代码没有 |
| 🏗️ **代码库架构** | 反重力的 `codebase_investigator` 映射整个项目只需一次遍历 |
| 🧬 **科学查询** | 40 多个专业技能：gnomAD、UniProt、PubMed、AlphaFold、ChEMBL... |
| 🌐 **浏览器调试** | Chrome DevTools 协议，用于性能、a11y、网络检查 |
| 🔄 **多文件重构** | 在其自己的上下文中运行 — 不会耗尽 Claude 的窗口 |
| 👀 **代码审查** | 不同的模型 = 不同的视角 = 捕获不同的错误 |
| 📝 **批量生成** | 测试、文档、样板代码，无需填充 Claude 的上下文 |
## 快速入门
### 先决条件
- [Claude 代码](https://docs.anthropic.com/en/docs/claude-code) 已安装
- [反重力 CLI](https://blog.google/technology/google-deepmind/antigravity/) (`agy`) 已安装并经过身份验证
### 安装
```bash
# 克隆到 Claude 代码的技能目录
git clone git@github.com:SafeMantella/claude-code-agy-CLI-skill.git ~/.claude/skills/antigravity-cli
```
Claude 代码在启动时自动发现 `~/.claude/skills/` 中的技能。
### 设置二进制文件路径
该技能硬编码了您的 `agy` 二进制文件路径。找到它并更新 `SKILL.md`：
```bash
# 查找您的 agy 二进制文件
which agy || find ~/.local/bin /usr/local/bin /opt/homebrew/bin -name "agy" 2>/dev/null
```
打开 `SKILL.md` 并用上述输出替换 `## 二进制文件位置` 下的路径。
### 验证
启动新的 Claude 代码会话并尝试：
```
> 研究 Flask 3.x 的最新安全建议
```
Claude 应该会自动将此委托给反重力 CLI。您将在其工具调用中看到它运行 `agy -p "..."`。
## 工作原理
### 自动发现
Claude 代码在启动时读取所有 `~/.claude/skills/*/SKILL.md` 文件。YAML 前言告诉 Claude **何时** 激活该技能：
```yaml
name: antigravity-cli
description: >
将繁重、多步骤或专业任务委托给谷歌的反重力 CLI 代理。
在任务需要：深度代码库分析、具有谷歌搜索基础的网络研究、图像生成、来自第二个 AI 视角的代码审查、
专业科学数据库查询或长时间重构等情况下使用。
```
### 委托决策
Claude 使用简单的启发式算法：
```
我自己做 Token 成本 > 提示 + 解析输出的 Token 成本？
↓ 是 → 委托给 agy
↓ 否 → 自己做
```
技能中内置的经验法则：
| 需要的工具调用 | 操作 |
|-------------------|--------|
| < 5 | Claude 直接执行 |
| 5–15 | Claude 考虑委托 |
| > 15 | Claude 委托 |
| 谷歌搜索 / 图片 / 科学数据库 | 始终委托（独家功能） |
### 命令模式
```bash
/path/to/agy -p "您的提示" --print-timeout 3m0s 2>&1
```
| 标志 | 用途 |
|------|---------|
| `-p` | 非交互模式：运行、打印、退出 |
| `--print-timeout` | 最大等待时间（默认为 5m） |
| `--dangerously-skip-permissions` | 自动批准工具调用（需要文件写入） |
| `--add-dir /path` | 添加工作区目录 |
| `-c` / `--continue` | 继续最近的对话 |
## 技能文件
| 文件 | 描述 |
|------|-------------|
| [`SKILL.md`](SKILL.md) | 核心技能 — 触发器、命令参考、8 个集成模式、错误处理 |
| [`templates.md`](templates.md) | 12 个可立即使用的提示模板，适用于常见场景 |
| [`patterns.md`](patterns.md) | 8 个高级编排模式，附反模式 |
| [`reference.md`](reference.md) | Claude 代码与反重力之间的功能比较矩阵 |
## Claude 代码 + agy：真实用例和示例提示
| 您对 Claude 代码说 | 为什么 agy 处理它 |
|------------------------|---------------------|
| *"React 19 中的重大更改是什么？"* | `google_web_search` 基础 — 比 DuckDuckGo 更权威、更实时 |
| *"检查我们的依赖项以获取已知 CVEs"* | 谷歌搜索基础提供当前建议；Claude 的训练有知识截止日期 |
| *"比较 Prisma vs Drizzle vs TypeORM 以适用于此堆栈"* | 谷歌搜索基础用于当前基准、GitHub 脉动和社区情绪 |
| *"生成一个暗色主题仪表板 UI 模拟"* | 通过 `generate_image` 进行图像生成 — Claude 代码无法生成图像 |
| *"映射整个代码库：架构、依赖项、入口点"* | `codebase_investigator` 在一次遍历中执行此操作；Claude 需要多次读取 |
| *"将所有 30 个 API 路由重构为 async/await"* | >15 个文件编辑 — 委托保留 Claude 的上下文窗口 |
| *"审查此身份验证模块是否存在安全漏洞"* | 不同的模型，不同的盲点 — 捕获 Claude 可能规范的问题 |
| *"在 gnomAD 中查找 rs1234567 的等位频率"* | 需要 `gnomad-database` 技能，这是 agy 独有的 40 多个科学数据库之一 |
| *"获取 UniProt P12345 的 AlphaFold 结构"* | 需要 `alphafold-database` + `uniprot-database` 技能（agy 独有） |
| *"为什么此页面的 Lighthouse 分数为 43？"* | Chrome DevTools 协议访问 — Claude 代码无浏览器集成 |
## 高级模式
该技能包含 8 个编排模式。以下是亮点：
### 并行委托
```bash
# 同时运行多个分析
agy -p "分析身份验证模块" > /tmp/auth.txt &
agy -p "分析数据库模块" > /tmp/db.txt &
wait
```
### 会话深度
```bash
# 多步骤分析，保留上下文
agy -p "分析数据库架构"
agy -c -p "现在建议对最慢查询进行索引优化"
agy -c -p "生成 Alembic 迁移文件"
```
### 研究 → 决策 → 执行
```bash
# 反重力研究，Claude 决策，然后执行
RESEARCH=$(agy -p "比较 SQLAlchemy vs SQLModel vs Tortoise-ORM 以适用于 async FastAPI")
# Claude 读取输出，做出决定并实施
```
参见 [`patterns.md`](patterns.md) 以获取所有 8 个模式的完整示例。
## 自定义
### 添加项目上下文
在项目根目录中创建 `.gemini/GEMINI.md` 以为反重力提供持久上下文：
```markdown
# 我的项目
Flask 3.x 后端，带 PostgreSQL。Docker Compose 部署。
主要入口：app/__init__.py
测试：tests/ 中的 pytest
```
### 调整委托阈值
编辑 `SKILL.md` 中的“成本效益决策框架”部分，以调整 Claude 委托或自己处理任务的阈值。
## 兼容性
| 组件 | 最低版本 |
|-----------|----------------|
| Claude 代码 | 2.1+（技能支持） |
| 反重力 CLI (`agy`) | 0.2.x+ |
| macOS / Linux | 在 macOS 上测试，应适用于 Linux |
## 贡献
欢迎 PR！改进思路：
- [ ] 为特定框架（Django、Next.js、Flutter）添加更多提示模板
- [ ] 添加 Windows 支持和路径检测
- [ ] 创建 `/delegate` 自定义命令以显式调用
- [ ] 添加输出解析助手以进行结构化数据提取
- [ ] 用于通过反重力创建 MCP 服务器的模板
## 许可证
[MIT](LICENSE) — 随意使用。
---
<p align="center">
<b>使用 🧠 Claude 代码 + 🚀 反重力 CLI 构建</b><br>
<sub>两个 AI 代理总比一个好。</sub>
</p>
MCP 市场