反重力的双子座超能力

一个针对 Google 反重力 的系统化工作流框架，通过结构化的规划、测试驱动开发以及可选的并行执行，帮助你构建更优质的代码。

你可以把它看作是“AI 编码的护栏”——它会阻止你直接开始写代码，而是引导你完成头脑风暴 → 规划 → 构建 → 审查的流程。

灵感来源: Claude 超能力
适配对象: Google 反重力，结合原生工作流与技能

---

🎯 这能做什么

与其采用这种混乱的工作流程：

你: “给我做一个命令行工具”
AI: *立刻开始写代码*
你: *写到一半才发现这不是你想要的*

不如使用这种结构化的方法：

你: “给我做一个命令行工具”
→ 头脑风暴：AI 提出澄清性问题
→ 规划：AI 撰写带有验证步骤的详细计划
→ 你批准该计划
→ 执行：AI 按照计划逐步构建，并编写测试
→ 审查：AI 检查潜在问题
→ 完成：所有内容都已记录且运行正常

额外好处： 如果你的计划包含相互独立的步骤（比如“添加三个独立功能”），AI 可以 并行 处理这些步骤，从而节省时间！

---

✨ 包含的内容

工作流（斜杠命令）

这些是你在反重力中输入的命令：

• /superpowers-brainstorm - 在规划之前探索想法并提问
• /superpowers-write-plan - 创建详细的计划（尚未编写代码！）
• /superpowers-execute-plan - 按步骤逐步构建代码
• /superpowers-execute-plan-parallel - 并行构建独立步骤（更快！）
• /superpowers-review - 检查代码质量
• /superpowers-debug - 系统化调试
• /superpowers-finish - 最终总结与文档化

技能（构建模块）

这些技能教会 AI 如何工作：

• TDD - 测试驱动开发（先写测试）
• Debug - 系统化的问题解决
• Review - 代码质量检查
• REST/Python 自动化 - 针对特定任务的最佳实践

规则（护栏）

自动执行的良好实践：

• ✅ 必须先写计划再编码
• ✅ 必须获得批准后才能实施
• ✅ 必须验证每一步是否正常工作
• ✅ 必须将输出保存到磁盘（而不仅仅是聊天记录）

---

🚀 开始使用（分步指南）

第一步：检查已安装的工具

在开始之前，请确保你已经安装了以下工具：

✅ 必需（必须具备）：

Google 反重力

• 如何检查：打开反重力（如果能打开，就说明你有它！）
• 如果没有？安装反重力

Python 3.10 或更高版本

• 如何检查：

  python --version
  

• 应显示：Python 3.10.x 或更高版本
• 如果没有？下载 Python

🎨 可选（仅用于并行执行）：

Gemini CLI（使操作更快，但非必需）

• 如何检查：

  gemini --version
  

• 如果提示“命令未找到”，则表示你尚未安装

• 如何安装：

  npm install -g @google/gemini-cli
  

  Windows 用户： 安装完成后，请验证其是否正常工作：

  gemini --version
  

  如果看到版本号，则一切正常！如果没有，请参阅下方的 [故障排除]。

---

第二步：在你的项目中设置此框架

你有两种选择：

选项 A：从新项目开始（建议首次使用者）

1. 为你的项目创建一个新文件夹：

   Windows (PowerShell):

   mkdir my-awesome-project
   cd my-awesome-project
   

   Mac/Linux:

   mkdir my-awesome-project
   cd my-awesome-project
   

2. 将此仓库中的 .agent 文件夹复制到你的项目中：

   Windows (PowerShell):

   # 替换路径为你下载此仓库的位置
   Copy-Item -Recurse C:\path\to\gemini-superpowers-antigravity\.agent .
   

   Mac/Linux:

   # 替换路径为你克隆此仓库的位置
   cp -r /path/to/gemini-superpowers-antigravity/.agent .
   

3. 初始化 git（框架运行所必需）：

   git init
   git add .agent
   git commit -m "添加超能力框架"
   

4. 在此文件夹中打开反重力：

   从终端：

   # 确保你在 my-awesome-project 文件夹内
   # 然后按照你平常的方式打开反重力
   

   或者： 打开反重力 → 文件 → 打开文件夹 → 选择 my-awesome-project

选项 B：直接使用此仓库（用于测试演示）

1. 克隆此仓库：

   git clone <your-repo-url>
   cd gemini-superpowers-antigravity
   

2. 安装 Python 依赖项（仅限演示）：

   Windows (PowerShell):

   python -m venv .venv
   .\.venv\Scripts\Activate.ps1
   pip install -U pip
   pip install fastapi uvicorn httpx pytest
   

   Mac/Linux:

   python -m venv .venv
   source .venv/bin/activate
   pip install -U pip
   pip install fastapi uvicorn httpx pytest
   

3. 运行演示测试（可选，但很酷）：

   pytest -q
   

   你应该会看到：6 passed ✅

4. 在此文件夹中打开反重力

---

第三步：验证是否正常工作

1. 在反重力中输入：

   /superpowers-reload
   

2. 你应该会看到如下输出：

   我已重新加载超能力框架：
   
   规则：superpowers.md
   工作流：已加载 8 个（头脑风暴、调试、执行计划、执行计划并行、完成、重新加载、审查、撰写计划）
   技能：已加载 9 个（头脑风暴、调试、完成、规划、Python 自动化、REST 自动化、审查、TDD、工作流）
   
   在本次会话的剩余时间里，我将遵循这些指示。
   

3. 如果出现上述内容，你就准备好了！ 🎉

4. 如果出现“命令未找到”的提示：

   • 确保反重力是在包含 .agent/ 文件夹的目录下打开的
   • 尝试关闭并重新打开反重力，确保在正确的文件夹中

---

📖 使用方法（你的第一个任务）

让我们构建一个简单的东西来体验它的运作方式。

示例：构建一个简单的计算器命令行工具

第 1 步：头脑风暴（可选但有帮助）

在 Antigravity 中输入：

/superpowers-brainstorm

我想用 Python 构建一个简单的计算器命令行工具，能够对两个数字进行加、减、乘、除运算。

会发生什么：

• AI 会提出一些澄清问题，例如：
  • “是否支持小数？”
  • “使用命令行参数还是交互式模式？”
  • “需要处理除零错误吗？”
• 回答这些问题以完善你的想法。
• AI 会将头脑风暴总结写入 artifacts/superpowers/brainstorm.md。

你需要做的是： 回答这些问题，帮助 AI 理解你的需求。

---

第 2 步：编写计划

在 Antigravity 中输入：

/superpowers-write-plan

用 Python 构建一个包含加、减、乘、除功能的命令行计算器。使用 argparse 处理命令行参数，并为每个函数编写测试。

会发生什么：

• AI 会读取你当前的项目文件（如果有）。
• 创建一个分步计划，包括：
  • 每个小步骤耗时约 2–10 分钟。
  • 计划创建或修改的文件。
  • 如何验证每一步是否成功。
• 将计划写入 artifacts/superpowers/plan.md。
• 提示：“是否批准此计划？如果没问题，请回复 APPROVED。”

你需要做的是：

1. 阅读 artifacts/superpowers/plan.md 文件中的计划（或直接在聊天中查看）。
2. 检查计划是否合理。
3. 如果满意，输入：APPROVED。
4. 如果不满意，可以请求修改。

可能看到的计划示例：

## 计划

步骤 1：创建计算器模块
文件：calculator.py
修改内容：添加加、减、乘、除函数。
验证方法：python -c "from calculator import add; print(add(2, 3))"
  
步骤 2：添加测试
文件：test_calculator.py
修改内容：为所有函数添加 pytest 测试。
验证方法：pytest test_calculator.py
  
步骤 3：创建命令行接口
文件：cli.py
修改内容：使用 argparse 创建命令行界面。
验证方法：python cli.py add 2 3

---

第 3 步：执行计划

当你批准后，AI 会提示：

计划已批准。运行 /superpowers-execute-plan 开始实现。

现在输入：

/superpowers-execute-plan

会发生什么：

• AI 会从 artifacts/superpowers/plan.md 中读取计划。
• 按照计划逐步实现每个步骤。
• 每完成一步：
  • 运行验证命令。
  • 将执行内容写入 artifacts/superpowers/execution.md。
  • 向你展示结果。
• 如果验证失败，AI 会停止并调试。
• 最后，AI 会将总结写入 artifacts/superpowers/finish.md。

你会看到的内容：

正在执行步骤 1：创建计算器模块
[AI 写入 calculator.py]
运行验证：python -c "from calculator import add; print(add(2, 3))"
✅ 输出：5
步骤 1 完成！

正在执行步骤 2：添加测试
[AI 写入 test_calculator.py]
运行验证：pytest test_calculator.py
✅ 4 个测试通过
步骤 2 完成！

...（继续执行每一步）

所有步骤已完成！🎉

你需要做的是： 只需观看即可！AI 会完成所有工作。如果 AI 提出问题，回答即可。

---

第 4 步：检查结果

1. 查看代码：

   ls
   

   你应该看到新文件：calculator.py、test_calculator.py、cli.py。

2. 尝试运行程序：

   python cli.py add 5 3
   

   应该显示：8。

3. 检查生成的文件：

   # Windows
   ls artifacts\superpowers\
   
   # Mac/Linux
   ls artifacts/superpowers/
   

   你应该看到：

   • plan.md - 你批准的计划。
   • execution.md - 每一步的执行记录。
   • finish.md - 最终总结。

---

⚡ 使用并行执行（可选——更快的方式！）

如果你的计划中有相互独立的步骤（即不依赖彼此的步骤），你可以通过并行执行来节省时间！

何时使用并行模式

适合并行的情况：

• ✅ 向不同文件添加 3 个独立功能。
• ✅ 创建 3 个独立模块。
• ✅ 为 3 个不同的函数编写测试。

不适合并行的情况：

• ❌ 步骤之间存在依赖关系（例如，步骤 2 需要步骤 1 的输出）。
• ❌ 所有步骤都修改同一个文件。
• ❌ 总共只有 1–2 个步骤（开销太大，不值得）。

如何使用

选项 1：让 AI 建议

当你运行 /superpowers-execute-plan 时，如果 AI 检测到独立步骤，它会询问：

我注意到步骤 1、2、3 是独立的，可以并行执行。
您想使用 /superpowers-execute-plan-parallel 来加快执行速度吗？
或者继续按顺序执行？（回复：PARALLEL 或 SEQUENTIAL）

回复：PARALLEL

选项 2：直接使用

批准计划后，输入：

/superpowers-execute-plan-parallel

并行模式有什么不同？

顺序执行：

步骤 1（5 分钟）→ 步骤 2（5 分钟）→ 步骤 3（5 分钟）= 共 15 分钟

并行执行：

步骤 1（5 分钟）┐
步骤 2（5 分钟）├─ 同时运行
步骤 3（5 分钟）┘
总计：约 5 分钟（快了 60%！）

你会看到的内容：

正在分析计划以进行并行执行...

批次 1（并行执行 - 3 个步骤）：
- 步骤 1：添加功能 X
- 步骤 2：添加功能 Y
- 步骤 3：添加功能 Z

🤖 启动 3 个子代理...
子代理 1：正在执行步骤 1...
子代理 2：正在执行步骤 2...
子代理 3：正在执行步骤 3...

✅ 批次 1 已完成，耗时 5.2 秒
相比顺序执行节省了 10 分钟！

日志在哪里？

检查 artifacts/superpowers/subagents/ 目录——你会看到每个子代理的日志文件，详细记录了各自的工作内容。

---

🛠️ 故障排除

“命令未找到：/superpowers-…”

问题： Antigravity 无法识别这些工作流。

解决方案：

1. 确保你位于包含 .agent/ 文件夹的目录下。
2. 尝试运行：

   /superpowers-reload
   

3. 如果仍然无效，请关闭 Antigravity，然后在正确的文件夹中重新打开。

---

并行执行失败，提示“gemini 未找到”

问题： 你没有安装 Gemini CLI，或者它不在系统的 PATH 中。

Windows 解决方案：

1. 安装 Gemini CLI：

   npm install -g @google/gemini-cli
   

2. 验证是否安装成功：

   gemini --version
   

   应该显示：@google/gemini-cli 版本 X.X.X。

3. 如果仍然提示“未找到”：

   • 重启 PowerShell（npm 可能更新了你的 PATH）。
   • 检查 npm 的全局 bin 目录是否在 PATH 中：

     npm config get prefix
     

   • 输出应该类似于 C:\Users\YourName\AppData\Roaming\npm。
   • 将该路径添加到系统 PATH 环境变量中。

4. 替代方案： 直接使用顺序执行：

   /superpowers-execute-plan
   

   （虽然稍慢，但无需 Gemini CLI 即可运行）

Mac/Linux 解决方案：

1. 安装 Gemini CLI：

   npm install -g @google/gemini-cli
   

2. 验证：

   which gemini
   

   应该显示类似 /usr/local/bin/gemini 的路径。

3. 如果未找到：

   • 确保 npm 的 bin 目录在 PATH 中。
   • 运行 echo $PATH，查找 npm 的 bin 文件夹。

---

AI 直接开始编码，没有先制定计划

问题： AI 没有遵循 Superpowers 规则。

解决方案：

1. 确保 .agent/rules/superpowers.md 文件存在。
2. 尝试运行：

   /superpowers-reload
   

3. 开始一个新的 Antigravity 对话。
4. 显式使用以下工作流：

   /superpowers-write-plan <你的任务 >
   

---

生成的工件文件没有被创建

问题： 文件没有写入 artifacts/superpowers/ 目录。

解决方案：

1. 检查该目录是否已创建：

   ls artifacts/superpowers/
   

2. 如果该目录为空，可能是 AI 没有按照工作流执行。
3. 尝试明确告知：

   请遵循 superpowers-execute-plan 工作流，并将工件写入磁盘。
   

---

我编辑了工作流但没有任何变化

问题： Antigravity 缓存了旧版本。

解决方案：

/superpowers-reload

这会强制 Antigravity 重新读取所有 .agent/ 文件。

---

📂 所有内容的位置

your-project/
├── .agent/                          ← Superpowers 框架（请复制此文件夹！）
│   ├── rules/
│   │   └── superpowers.md          ← AI 必须遵守的规则
│   ├── workflows/
│   │   ├── superpowers-write-plan.md
│   │   ├── superpowers-execute-plan.md
│   │   └── ...                      ← 斜杠命令
│   └── skills/
│       ├── superpowers-tdd/
│       ├── superpowers-debug/
│       └── ...                      ← AI 的构建模块
│
├── artifacts/                       ← 生成的输出文件（已忽略在 Git 中）
│   └── superpowers/
│       ├── plan.md                  ← 你批准的计划
│       ├── execution.md             ← 分步执行日志
│       ├── finish.md                ← 最终总结
│       └── subagents/               ← 并行执行的日志
│
├── your-code-here.py               ← 你的实际项目文件
├── tests/                          ← AI 创建的测试文件
└── README.md                       ← 你的项目文档

---

🎓 通过示例学习

示例 1：简单的 Python 脚本

任务： “创建一个统计文本文件中单词数量的脚本”

你会使用的命令：

/superpowers-write-plan 创建一个统计文本文件中单词数量的 Python 脚本
→ 审核计划
APPROVED
→ AI 创建计划

/superpowers-execute-plan
→ AI 构建：word_counter.py, test_word_counter.py
→ AI 验证其功能
→ 完成！

结果： 在约 5 分钟内完成带有测试的可运行脚本。

---

示例 2：REST API 客户端

任务： “构建一个列出用户仓库的 GitHub API 客户端”

命令：

/superpowers-brainstorm 我想构建一个 GitHub API 客户端
→ AI 提问：需要认证吗？是否有速率限制？要调用哪些接口？
→ 你回答

/superpowers-write-plan 构建一个带有认证、速率限制和仓库列表功能的 GitHub API 客户端
→ AI 创建详细计划
APPROVED

/superpowers-execute-plan
→ AI 按步骤实现
→ 每一步都经过验证
→ 完成！

结果： 具备错误处理和测试的生产级 API 客户端。

---

示例 3：三个独立功能（并行！）

任务： “为我的 CLI 添加日志记录、配置文件支持和 --verbose 标志”

命令：

/superpowers-write-plan

为我的 CLI 添加三个功能：
1. 日志记录到文件
2. 从配置文件加载设置
3. 用于详细输出的 --verbose 标志

每个功能应相互独立。

→ AI 创建包含 3 个独立步骤的计划
APPROVED

/superpowers-execute-plan-parallel
→ AI 启动 3 个子代理
→ 所有 3 个功能同时构建
→ 比顺序执行快 60%！

结果： 三个功能在约 5 分钟内完成，而按顺序执行则需约 15 分钟。

---

🎯 快速参考

最常用的工作流

1. /superpowers-write-plan <描述你想要的内容>
2. 阅读计划，输入：APPROVED
3. /superpowers-execute-plan
4. 完成！检查你的代码和 artifacts/superpowers/finish.md

所有可用命令

命令	功能	使用场景
/superpowers-brainstorm	通过问答探索想法	当你不确定具体需求时
/superpowers-write-plan	创建详细计划	每项任务的开始
/superpowers-execute-plan	按步骤构建代码	批准计划后
/superpowers-execute-plan-parallel	并行构建独立步骤	当计划中有 3 个或更多独立步骤时
/superpowers-review	检查代码质量	在完成前或调试时
/superpowers-debug	系统性调试	当出现问题时
/superpowers-finish	创建最终总结	一切正常后
/superpowers-reload	重新加载所有工作流/规则	编辑 .agent/ 文件后

---

🤝 贡献

想改进这个框架吗？欢迎提交 PR！

好的贡献想法：

• 更多语言特定技能（Node/TS、Go、Rust 等）
• 更多工作流（git worktree 管理、分支清理等）
• 更好的并行执行（更智能的依赖检测）
• 更多展示实际应用的端到端演示
• 更好的错误信息和故障排除方法

---

📄 许可证

MIT 许可证 - 请参阅 LICENSE 文件

---

🙏 致谢

• 灵感来源： obra/superpowers（Claude Superpowers）
• 适配于： Google Antigravity
• 并行执行概念： 基于社区关于多智能体工作流的讨论

---

💡 成功提示

1. 从小处着手： 在处理大型项目之前，先尝试计算器示例。
2. 阅读计划： 不要盲目批准，务必仔细审查 AI 的建议。
3. 明智使用并行模式： 虽然速度快，但如果出错则更难调试。
4. 检查工件： artifacts/superpowers/ 文件夹会清楚地告诉你发生了什么。
5. 经常重新加载： 如果你编辑了工作流，务必运行 /superpowers-reload。
6. 提出问题： 如果计划不合理，请在批准前要求 AI 进行澄清。

祝编码愉快！🚀

Gemini Superpowers for Antigravity 快速上手指南

本指南帮助你在 Google Antigravity 中构建结构化、高质量的代码工作流。它通过“头脑风暴 → 规划 → 执行 → 审查”的流程，防止 AI 直接生成代码，确保每一步都经过验证。

🛠️ 环境准备

在开始之前，请确保你的系统满足以下要求：

1. 核心依赖（必须）

• Google Antigravity: 确保已安装并能正常启动。
  • 下载地址：Antigravity 官网
• Python 3.10+:
  • 检查版本：python --version
  • 若未安装或版本过低，请访问 Python 官网 下载。
  • 国内用户提示：若下载速度慢，可使用清华大学镜像源安装第三方库（后续步骤会用到）。

2. 可选依赖（仅用于并行加速）

• Gemini CLI: 用于启用多任务并行执行，大幅缩短等待时间。
  • 检查命令：gemini --version
  • 安装命令：

    npm install -g @google/gemini-cli
    

  • 注意：Windows 用户安装后若提示命令不存在，请重启终端或检查环境变量。

---

📥 安装步骤

你可以选择在新项目中初始化框架，或直接克隆仓库体验。推荐选项 A。

选项 A：在新项目中初始化（推荐）

1. 创建并进入项目目录

   mkdir my-awesome-project
   cd my-awesome-project
   

2. 复制框架文件 将下载的 gemini-superpowers-antigravity 仓库中的 .agent 文件夹复制到当前项目根目录。

   • Mac/Linux:

     cp -r /path/to/gemini-superpowers-antigravity/.agent .
     

   • Windows (PowerShell):

     Copy-Item -Recurse C:\path\to\gemini-superpowers-antigravity\.agent .
     

3. 初始化 Git（必需） 该框架依赖 Git 追踪状态。

   git init
   git add .agent
   git commit -m "Add Superpowers framework"
   

4. 启动 Antigravity 在当前目录下打开 Antigravity：

   # 确保终端位于项目目录内，然后启动 Antigravity
   antigravity . 
   # 或者通过 GUI: File -> Open Folder -> 选择 my-awesome-project
   

选项 B：直接运行演示（仅测试）

如果你想直接体验内置的 Demo：

1. 克隆仓库

   git clone <your-repo-url>
   cd gemini-superpowers-antigravity
   

2. 安装 Python 依赖

   python -m venv .venv
   
   # Windows 激活
   .\.venv\Scripts\Activate.ps1
   # Mac/Linux 激活
   source .venv/bin/activate
   
   # 安装依赖 (国内用户推荐使用清华源加速)
   pip install -U pip -i https://pypi.tuna.tsinghua.edu.cn/simple
   pip install fastapi uvicorn httpx pytest -i https://pypi.tuna.tsinghua.edu.cn/simple
   

3. 验证测试

   pytest -q
   # 应显示：6 passed
   

4. 启动 Antigravity 在当前目录打开 Antigravity。

---

🚀 基本使用

1. 验证安装

在 Antigravity 聊天框中输入以下命令加载框架：

/superpowers-reload

若看到类似 Workflows: 8 loaded 和 Rules: superpowers.md 的成功提示，即表示安装成功。

2. 实战示例：构建一个计算器 CLI

我们将通过标准的四步流程来构建一个简单的 Python 计算器。

第一步：头脑风暴 (Brainstorm)

输入命令明确需求，让 AI 提问以澄清细节。

/superpowers-brainstorm

我想用 Python 写一个命令行计算器，支持加减乘除。

• AI 行为：询问是否支持小数、交互模式还是参数模式、错误处理等。
• 你的操作：回答这些问题。结果将保存至 artifacts/superpowers/brainstorm.md。

第二步：制定计划 (Plan)

基于确认的需求，生成详细执行计划。

/superpowers-write-plan

创建一个包含加减乘除函数的 Python 计算器。使用 argparse 处理命令行参数，并为每个函数编写测试。

• AI 行为：生成分步计划（包含文件修改、验证命令），保存至 artifacts/superpowers/plan.md。
• 你的操作：阅读计划。如果满意，回复 APPROVED；如果不满意，提出修改意见。

第三步：执行计划 (Execute)

计划批准后，开始逐步编码。

/superpowers-execute-plan

• AI 行为：
  1. 按步骤逐个实现功能。
  2. 每步完成后自动运行验证命令（如 pytest 或 python -c ...）。
  3. 若验证失败则自动调试。
  4. 记录日志至 artifacts/superpowers/execution.md。
• 你的操作：观察进度，如有需要回答 AI 的临时提问。

(可选) 并行加速：如果计划中的步骤相互独立（例如同时开发三个不相关的模块），AI 可能会建议使用 /superpowers-execute-plan-parallel 以节省时间。

第四步：检查结果

执行完成后，验证成果：

1. 查看文件：确认生成了 calculator.py, test_calculator.py, cli.py 等。
2. 运行测试：

   python cli.py add 5 3
   # 输出应为：8
   

3. 查看文档：检查 artifacts/superpowers/finish.md 获取最终总结。

---

常用指令速查

指令	功能描述
/superpowers-brainstorm	探索想法，澄清需求
/superpowers-write-plan	生成详细实施计划（不含代码）
/superpowers-execute-plan	按顺序执行计划并验证
/superpowers-execute-plan-parallel	并行执行独立步骤（需安装 Gemini CLI）
/superpowers-review	代码质量审查
/superpowers-debug	系统性调试
/superpowers-finish	生成最终总结和文档