[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-anthonylee991--gemini-superpowers-antigravity":3,"tool-anthonylee991--gemini-superpowers-antigravity":62},[4,18,26,36,46,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",160015,2,"2026-04-18T11:30:52",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":78,"owner_email":76,"owner_twitter":76,"owner_website":76,"owner_url":79,"languages":80,"stars":85,"forks":86,"last_commit_at":87,"license":88,"difficulty_score":32,"env_os":89,"env_gpu":90,"env_ram":90,"env_deps":91,"category_tags":100,"github_topics":76,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":101,"updated_at":102,"faqs":103,"releases":109},9256,"anthonylee991\u002Fgemini-superpowers-antigravity","gemini-superpowers-antigravity","Superpowers for Gemini's Antigravity (like Claude Superpowers)","gemini-superpowers-antigravity 是专为 Google Antigravity 设计的一套系统化工作流框架，旨在为 AI 编程过程添加“护栏”。它解决了开发者在使用 AI 辅助编码时常见的痛点：避免 AI 未经思考直接生成代码，导致结果偏离需求或难以维护。通过强制推行“头脑风暴→制定计划→用户审批→分步执行→代码审查”的结构化流程，该工具确保每一步都经过规划与验证，从而显著提升代码质量与项目可控性。\n\n这款工具特别适合希望规范 AI 协作流程的软件开发者及工程团队。其核心亮点在于引入了测试驱动开发（TDD）理念，要求先写测试再写代码，并支持将独立任务并行处理以大幅缩短开发时间。此外，它提供了一系列直观的斜杠命令（如 `\u002Fsuperpowers-plan`、`\u002Fsuperpowers-execute`），引导 AI 从单纯的代码生成器转变为具备规划与自检能力的智能伙伴，同时强制要求将产出保存至本地磁盘，确保工作成果可追溯、可交付。","# Gemini Superpowers for Antigravity\n\nA systematic workflow framework for **Google Antigravity** that helps you build better code through structured planning, test-driven development, and optional parallel execution.\n\nThink of it as \"guardrails for AI coding\" - it prevents you from diving straight into code and instead guides you through brainstorming → planning → building → reviewing.\n\n> **Inspired by:** [Claude Superpowers](https:\u002F\u002Fgithub.com\u002Fobra\u002Fsuperpowers)\n> **Adapted for:** Google Antigravity with native workflows and skills\n\n---\n\n## 🎯 What This Does\n\nInstead of this chaotic workflow:\n```\nYou: \"Build me a CLI tool\"\nAI: *immediately starts writing code*\nYou: *realizes halfway through it's not what you wanted*\n```\n\nYou get this structured approach:\n```\nYou: \"Build me a CLI tool\"\n→ Brainstorm: AI asks clarifying questions\n→ Plan: AI writes a step-by-step plan with verification\n→ You approve the plan\n→ Execute: AI builds it step-by-step with tests\n→ Review: AI checks for issues\n→ Finish: Everything documented and working\n```\n\n**Bonus:** If your plan has independent steps (like \"add 3 separate features\"), the AI can work on them **in parallel** to save time!\n\n---\n\n## ✨ What's Included\n\n### Workflows (Slash Commands)\nThese are commands you type in Antigravity:\n\n- `\u002Fsuperpowers-brainstorm` - Explore ideas and ask questions before planning\n- `\u002Fsuperpowers-write-plan` - Create a detailed plan (no code yet!)\n- `\u002Fsuperpowers-execute-plan` - Build the code step-by-step\n- `\u002Fsuperpowers-execute-plan-parallel` - Build independent steps in parallel (faster!)\n- `\u002Fsuperpowers-review` - Check code quality\n- `\u002Fsuperpowers-debug` - Systematic debugging\n- `\u002Fsuperpowers-finish` - Final summary and documentation\n\n### Skills (Building Blocks)\nThese teach the AI how to work:\n\n- **TDD** - Test-driven development (write tests first)\n- **Debug** - Systematic problem solving\n- **Review** - Code quality checks\n- **REST\u002FPython Automation** - Best practices for specific tasks\n\n### Rules (Guardrails)\nAutomatic enforcement of good practices:\n\n- ✅ Must write a plan before coding\n- ✅ Must get approval before implementing\n- ✅ Must verify each step works\n- ✅ Must save outputs to disk (not just chat)\n\n---\n\n## 🚀 Getting Started (Step-by-Step)\n\n### Step 1: Check What You Have Installed\n\nBefore starting, make sure you have these tools:\n\n#### ✅ Required (You must have these):\n\n**Google Antigravity**\n- How to check: Open Antigravity (if it opens, you have it!)\n- Don't have it? [Install Antigravity](https:\u002F\u002Fantigravity.google)\n\n**Python 3.10 or newer**\n- How to check:\n  ```bash\n  python --version\n  ```\n- Should show: `Python 3.10.x` or higher\n- Don't have it? [Download Python](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)\n\n#### 🎨 Optional (Only needed for parallel execution):\n\n**Gemini CLI** (makes things faster but not required)\n- How to check:\n  ```bash\n  gemini --version\n  ```\n- If it says \"command not found\", you don't have it\n- To install:\n  ```bash\n  npm install -g @google\u002Fgemini-cli\n  ```\n\n  **Windows users:** After installing, verify it works:\n  ```powershell\n  gemini --version\n  ```\n  If you see a version number, you're good! If not, see [Troubleshooting](#troubleshooting) below.\n\n---\n\n### Step 2: Set Up This Framework in Your Project\n\nYou have two options:\n\n#### Option A: Start a New Project (Recommended for First-Time Users)\n\n1. **Create a new folder for your project:**\n\n   **Windows (PowerShell):**\n   ```powershell\n   mkdir my-awesome-project\n   cd my-awesome-project\n   ```\n\n   **Mac\u002FLinux:**\n   ```bash\n   mkdir my-awesome-project\n   cd my-awesome-project\n   ```\n\n2. **Copy the `.agent` folder from this repo into your project:**\n\n   **Windows (PowerShell):**\n   ```powershell\n   # Replace the path with where you downloaded this repo\n   Copy-Item -Recurse C:\\path\\to\\gemini-superpowers-antigravity\\.agent .\n   ```\n\n   **Mac\u002FLinux:**\n   ```bash\n   # Replace the path with where you cloned this repo\n   cp -r \u002Fpath\u002Fto\u002Fgemini-superpowers-antigravity\u002F.agent .\n   ```\n\n3. **Initialize git (required for the framework to work):**\n   ```bash\n   git init\n   git add .agent\n   git commit -m \"Add Superpowers framework\"\n   ```\n\n4. **Open Antigravity in this folder:**\n\n   **From your terminal:**\n   ```bash\n   # Make sure you're in my-awesome-project folder\n   # Then open Antigravity (however you normally do it)\n   ```\n\n   **Or:** Open Antigravity → File → Open Folder → Select `my-awesome-project`\n\n#### Option B: Use This Repo Directly (For Testing the Demo)\n\n1. **Clone this repo:**\n   ```bash\n   git clone \u003Cyour-repo-url>\n   cd gemini-superpowers-antigravity\n   ```\n\n2. **Install Python dependencies (for the demo only):**\n\n   **Windows (PowerShell):**\n   ```powershell\n   python -m venv .venv\n   .\\.venv\\Scripts\\Activate.ps1\n   pip install -U pip\n   pip install fastapi uvicorn httpx pytest\n   ```\n\n   **Mac\u002FLinux:**\n   ```bash\n   python -m venv .venv\n   source .venv\u002Fbin\u002Factivate\n   pip install -U pip\n   pip install fastapi uvicorn httpx pytest\n   ```\n\n3. **Run the demo tests (optional but cool to see it work):**\n   ```bash\n   pytest -q\n   ```\n\n   You should see: `6 passed` ✅\n\n4. **Open Antigravity in this folder**\n\n---\n\n### Step 3: Verify It's Working\n\n1. **In Antigravity, type:**\n   ```\n   \u002Fsuperpowers-reload\n   ```\n\n2. **You should see output like:**\n   ```\n   I've reloaded the Superpowers framework:\n\n   Rules: superpowers.md\n   Workflows: 8 loaded (brainstorm, debug, execute-plan, execute-plan-parallel, finish, reload, review, write-plan)\n   Skills: 9 loaded (brainstorm, debug, finish, plan, python-automation, rest-automation, review, tdd, workflow)\n\n   I will follow these instructions for the rest of this session.\n   ```\n\n3. **If you see this, you're ready!** 🎉\n\n4. **If you see \"command not found\":**\n   - Make sure Antigravity is opened in the folder that contains `.agent\u002F`\n   - Try closing and reopening Antigravity in the correct folder\n\n---\n\n## 📖 How to Use It (Your First Task)\n\nLet's build something simple to see how it works.\n\n### Example: Build a Simple Calculator CLI\n\n#### Step 1: Brainstorm (Optional but Helpful)\n\nIn Antigravity, type:\n```\n\u002Fsuperpowers-brainstorm\n\nI want to build a simple calculator CLI tool in Python that can add, subtract, multiply, and divide two numbers.\n```\n\n**What happens:**\n- The AI will ask clarifying questions like:\n  - \"Should it support decimal numbers?\"\n  - \"Command-line arguments or interactive mode?\"\n  - \"Need error handling for division by zero?\"\n- Answer them to refine your idea\n- The AI writes a brainstorm summary to `artifacts\u002Fsuperpowers\u002Fbrainstorm.md`\n\n**What you do:** Answer the questions to help the AI understand what you want.\n\n---\n\n#### Step 2: Write a Plan\n\nIn Antigravity, type:\n```\n\u002Fsuperpowers-write-plan\n\nBuild a Python calculator CLI with add, subtract, multiply, divide functions. Use argparse for command-line args. Include tests for each function.\n```\n\n**What happens:**\n- The AI reads your project (if any files exist)\n- Creates a step-by-step plan with:\n  - Small steps (2-10 minutes each)\n  - Files it will create\u002Fmodify\n  - How to verify each step works\n- Writes the plan to `artifacts\u002Fsuperpowers\u002Fplan.md`\n- Asks: **\"Approve this plan? Reply APPROVED if it looks good.\"**\n\n**What you do:**\n1. Read the plan in `artifacts\u002Fsuperpowers\u002Fplan.md` (or in the chat)\n2. Check if it makes sense\n3. If you like it, type: `APPROVED`\n4. If not, ask for changes\n\n**Example plan you might see:**\n```\n## Plan\n\nStep 1: Create calculator module\nFiles: calculator.py\nChange: Add functions for add, subtract, multiply, divide\nVerify: python -c \"from calculator import add; print(add(2, 3))\"\n\nStep 2: Add tests\nFiles: test_calculator.py\nChange: Add pytest tests for all functions\nVerify: pytest test_calculator.py\n\nStep 3: Create CLI\nFiles: cli.py\nChange: Use argparse to create command-line interface\nVerify: python cli.py add 2 3\n```\n\n---\n\n#### Step 3: Execute the Plan\n\nAfter you approve, the AI will say:\n```\nPlan approved. Run `\u002Fsuperpowers-execute-plan` to begin implementation.\n```\n\nNow type:\n```\n\u002Fsuperpowers-execute-plan\n```\n\n**What happens:**\n- The AI reads the plan from `artifacts\u002Fsuperpowers\u002Fplan.md`\n- Implements **one step at a time**\n- After each step:\n  - Runs the verification command\n  - Writes what it did to `artifacts\u002Fsuperpowers\u002Fexecution.md`\n  - Shows you the results\n- If verification fails, it stops and debugs\n- At the end, writes a summary to `artifacts\u002Fsuperpowers\u002Ffinish.md`\n\n**What you see:**\n```\nImplementing Step 1: Create calculator module\n[AI writes calculator.py]\nRunning verification: python -c \"from calculator import add; print(add(2, 3))\"\n✅ Output: 5\nStep 1 complete!\n\nImplementing Step 2: Add tests\n[AI writes test_calculator.py]\nRunning verification: pytest test_calculator.py\n✅ 4 passed\nStep 2 complete!\n\n... (continues for each step)\n\nAll steps complete! 🎉\n```\n\n**What you do:** Just watch! The AI does the work. If it asks questions, answer them.\n\n---\n\n#### Step 4: Check the Results\n\n1. **Look at the code:**\n   ```bash\n   ls\n   ```\n   You should see new files: `calculator.py`, `test_calculator.py`, `cli.py`\n\n2. **Try running it:**\n   ```bash\n   python cli.py add 5 3\n   ```\n   Should show: `8`\n\n3. **Check the artifacts:**\n   ```bash\n   # Windows\n   ls artifacts\\superpowers\\\n\n   # Mac\u002FLinux\n   ls artifacts\u002Fsuperpowers\u002F\n   ```\n\n   You should see:\n   - `plan.md` - The plan you approved\n   - `execution.md` - Step-by-step log of what happened\n   - `finish.md` - Final summary\n\n---\n\n## ⚡ Using Parallel Execution (Optional - Makes Things Faster!)\n\nIf your plan has **independent steps** (steps that don't depend on each other), you can run them in parallel to save time!\n\n### When to Use Parallel Mode\n\n**Good for parallel:**\n- ✅ Adding 3 separate features to different files\n- ✅ Creating 3 independent modules\n- ✅ Writing tests for 3 different functions\n\n**Not good for parallel:**\n- ❌ Steps that build on each other (Step 2 needs Step 1's output)\n- ❌ All steps modify the same file\n- ❌ Only 1-2 steps total (not worth the overhead)\n\n### How to Use It\n\n**Option 1: Let the AI suggest it**\n\nWhen you run `\u002Fsuperpowers-execute-plan`, if the AI detects independent steps, it will ask:\n```\nI notice steps 1, 2, 3 are independent and could run in parallel.\nWould you like to use `\u002Fsuperpowers-execute-plan-parallel` for faster execution?\nOr continue with sequential execution? (Reply: PARALLEL or SEQUENTIAL)\n```\n\nReply: `PARALLEL`\n\n**Option 2: Use it directly**\n\nAfter approving your plan, type:\n```\n\u002Fsuperpowers-execute-plan-parallel\n```\n\n### What's Different in Parallel Mode?\n\n**Sequential execution:**\n```\nStep 1 (5 min) → Step 2 (5 min) → Step 3 (5 min) = 15 minutes total\n```\n\n**Parallel execution:**\n```\nStep 1 (5 min) ┐\nStep 2 (5 min) ├─ All run at the same time\nStep 3 (5 min) ┘\nTotal: ~5 minutes (60% faster!)\n```\n\n**What you'll see:**\n```\nAnalyzing plan for parallel execution...\n\nBatch 1 (PARALLEL - 3 steps):\n- Step 1: Add feature X\n- Step 2: Add feature Y\n- Step 3: Add feature Z\n\n🤖 Spawning 3 subagents...\nSubagent 1: Working on Step 1...\nSubagent 2: Working on Step 2...\nSubagent 3: Working on Step 3...\n\n✅ Batch 1 completed in 5.2s\nTime saved: 10 minutes vs sequential!\n```\n\n**Where are the logs?**\n\nCheck `artifacts\u002Fsuperpowers\u002Fsubagents\u002F` - you'll see one log file per subagent showing exactly what each one did.\n\n---\n\n## 🛠️ Troubleshooting\n\n### \"Command not found: \u002Fsuperpowers-...\"\n\n**Problem:** Antigravity doesn't see the workflows.\n\n**Solution:**\n1. Make sure you're in the folder that contains `.agent\u002F`\n2. Try running:\n   ```\n   \u002Fsuperpowers-reload\n   ```\n3. If that doesn't work, close Antigravity and reopen it in the correct folder\n\n---\n\n### Parallel execution fails with \"gemini not found\"\n\n**Problem:** You don't have Gemini CLI installed, or it's not in your system PATH.\n\n**Solution for Windows:**\n\n1. **Install Gemini CLI:**\n   ```powershell\n   npm install -g @google\u002Fgemini-cli\n   ```\n\n2. **Verify it installed:**\n   ```powershell\n   gemini --version\n   ```\n\n   Should show: `@google\u002Fgemini-cli version X.X.X`\n\n3. **If it still says \"not found\":**\n   - Restart PowerShell (npm might have updated your PATH)\n   - Check if npm's global bin directory is in your PATH:\n     ```powershell\n     npm config get prefix\n     ```\n   - The output should be something like `C:\\Users\\YourName\\AppData\\Roaming\\npm`\n   - Add that path to your system PATH environment variable\n\n4. **Alternative:** Just use sequential execution instead:\n   ```\n   \u002Fsuperpowers-execute-plan\n   ```\n   (It's a bit slower but works without Gemini CLI)\n\n**Solution for Mac\u002FLinux:**\n\n1. **Install Gemini CLI:**\n   ```bash\n   npm install -g @google\u002Fgemini-cli\n   ```\n\n2. **Verify:**\n   ```bash\n   which gemini\n   ```\n   Should show a path like: `\u002Fusr\u002Flocal\u002Fbin\u002Fgemini`\n\n3. **If not found:**\n   - Make sure npm's bin directory is in PATH\n   - Try: `echo $PATH` and look for npm's bin folder\n\n---\n\n### The AI starts coding immediately without planning\n\n**Problem:** The AI isn't following the Superpowers rules.\n\n**Solution:**\n1. Make sure `.agent\u002Frules\u002Fsuperpowers.md` exists\n2. Try running:\n   ```\n   \u002Fsuperpowers-reload\n   ```\n3. Start a new Antigravity conversation\n4. Explicitly use the workflows:\n   ```\n   \u002Fsuperpowers-write-plan \u003Cyour task>\n   ```\n\n---\n\n### Artifacts aren't being created\n\n**Problem:** Files aren't being written to `artifacts\u002Fsuperpowers\u002F`.\n\n**Solution:**\n1. Check if the folder was created:\n   ```bash\n   ls artifacts\u002Fsuperpowers\u002F\n   ```\n2. If it's empty, the AI might not be following the workflow\n3. Try explicitly saying:\n   ```\n   Please follow the superpowers-execute-plan workflow and write artifacts to disk.\n   ```\n\n---\n\n### I edited a workflow but nothing changed\n\n**Problem:** Antigravity cached the old version.\n\n**Solution:**\n```\n\u002Fsuperpowers-reload\n```\n\nThis forces Antigravity to re-read all `.agent\u002F` files.\n\n---\n\n## 📂 Where Everything Lives\n\n```\nyour-project\u002F\n├── .agent\u002F                          ← The Superpowers framework (copy this!)\n│   ├── rules\u002F\n│   │   └── superpowers.md          ← Rules the AI must follow\n│   ├── workflows\u002F\n│   │   ├── superpowers-write-plan.md\n│   │   ├── superpowers-execute-plan.md\n│   │   └── ...                      ← Slash commands\n│   └── skills\u002F\n│       ├── superpowers-tdd\u002F\n│       ├── superpowers-debug\u002F\n│       └── ...                      ← Building blocks for the AI\n│\n├── artifacts\u002F                       ← Generated outputs (git-ignored)\n│   └── superpowers\u002F\n│       ├── plan.md                  ← Your approved plan\n│       ├── execution.md             ← Step-by-step execution log\n│       ├── finish.md                ← Final summary\n│       └── subagents\u002F               ← Parallel execution logs\n│\n├── your-code-here.py               ← Your actual project files\n├── tests\u002F                          ← Tests the AI creates\n└── README.md                       ← Your project docs\n```\n\n---\n\n## 🎓 Learning by Example\n\n### Example 1: Simple Python Script\n\n**Task:** \"Create a script that counts words in a text file\"\n\n**Commands you'd use:**\n```\n\u002Fsuperpowers-write-plan Create a Python script that counts words in a text file\n→ Review plan\nAPPROVED\n→ AI creates plan\n\n\u002Fsuperpowers-execute-plan\n→ AI builds: word_counter.py, test_word_counter.py\n→ AI verifies it works\n→ Done!\n```\n\n**Result:** Working script with tests in ~5 minutes\n\n---\n\n### Example 2: REST API Client\n\n**Task:** \"Build a GitHub API client that lists user repos\"\n\n**Commands:**\n```\n\u002Fsuperpowers-brainstorm I want to build a GitHub API client\n→ AI asks: Authentication? Rate limiting? Which endpoints?\n→ You answer\n\n\u002Fsuperpowers-write-plan Build a GitHub API client with authentication, rate limiting, and repo listing\n→ AI creates detailed plan\nAPPROVED\n\n\u002Fsuperpowers-execute-plan\n→ AI implements step-by-step\n→ Each step verified\n→ Done!\n```\n\n**Result:** Production-ready API client with error handling and tests\n\n---\n\n### Example 3: Three Independent Features (Parallel!)\n\n**Task:** \"Add logging, config file support, and --verbose flag to my CLI\"\n\n**Commands:**\n```\n\u002Fsuperpowers-write-plan\n\nAdd three features to my CLI:\n1. Logging to a file\n2. Load settings from a config file\n3. --verbose flag for detailed output\n\nEach feature should be independent.\n\n→ AI creates plan with 3 independent steps\nAPPROVED\n\n\u002Fsuperpowers-execute-plan-parallel\n→ AI spawns 3 subagents\n→ All 3 features built simultaneously\n→ 60% faster than sequential!\n```\n\n**Result:** All three features done in ~5 minutes instead of ~15 minutes\n\n---\n\n## 🎯 Quick Reference\n\n### Most Common Workflow\n\n```\n1. \u002Fsuperpowers-write-plan \u003Cdescribe what you want>\n2. Read the plan, type: APPROVED\n3. \u002Fsuperpowers-execute-plan\n4. Done! Check your code and artifacts\u002Fsuperpowers\u002Ffinish.md\n```\n\n### All Available Commands\n\n| Command | What It Does | When to Use |\n|---------|-------------|-------------|\n| `\u002Fsuperpowers-brainstorm` | Explore ideas with Q&A | When you're not sure exactly what you want |\n| `\u002Fsuperpowers-write-plan` | Create a detailed plan | Start of every task |\n| `\u002Fsuperpowers-execute-plan` | Build code step-by-step | After approving plan |\n| `\u002Fsuperpowers-execute-plan-parallel` | Build independent steps in parallel | When plan has 3+ independent steps |\n| `\u002Fsuperpowers-review` | Check code quality | Before finishing, or when debugging |\n| `\u002Fsuperpowers-debug` | Systematic debugging | When something's broken |\n| `\u002Fsuperpowers-finish` | Create final summary | After everything works |\n| `\u002Fsuperpowers-reload` | Reload all workflows\u002Frules | After editing .agent\u002F files |\n\n---\n\n## 🤝 Contributing\n\nWant to improve this framework? PRs welcome!\n\n**Good ideas for contributions:**\n- More language-specific skills (Node\u002FTS, Go, Rust, etc.)\n- Additional workflows (git worktree management, branch cleanup, etc.)\n- Better parallel execution (smarter dependency detection)\n- More E2E demos showing real-world usage\n- Better error messages and troubleshooting\n\n---\n\n## 📄 License\n\nMIT License - See LICENSE file\n\n---\n\n## 🙏 Credits\n\n- **Inspired by:** [obra\u002Fsuperpowers](https:\u002F\u002Fgithub.com\u002Fobra\u002Fsuperpowers) (Claude Superpowers)\n- **Adapted for:** Google Antigravity\n- **Parallel execution concept:** Based on community discussions about multi-agent workflows\n\n---\n\n## 💡 Tips for Success\n\n1. **Start small:** Try the calculator example first before tackling big projects\n2. **Read the plans:** Don't just blindly approve - actually review what the AI suggests\n3. **Use parallel mode wisely:** It's faster but harder to debug if something goes wrong\n4. **Check artifacts:** The `artifacts\u002Fsuperpowers\u002F` folder tells you exactly what happened\n5. **Reload often:** If you edit workflows, always run `\u002Fsuperpowers-reload`\n6. **Ask questions:** If the plan doesn't make sense, ask the AI to clarify before approving\n\nHappy coding! 🚀\n","# 反重力的双子座超能力\n\n一个针对 **Google 反重力** 的系统化工作流框架，通过结构化的规划、测试驱动开发以及可选的并行执行，帮助你构建更优质的代码。\n\n你可以把它看作是“AI 编码的护栏”——它会阻止你直接开始写代码，而是引导你完成头脑风暴 → 规划 → 构建 → 审查的流程。\n\n> **灵感来源:** [Claude 超能力](https:\u002F\u002Fgithub.com\u002Fobra\u002Fsuperpowers)  \n> **适配对象:** Google 反重力，结合原生工作流与技能\n\n---\n\n## 🎯 这能做什么\n\n与其采用这种混乱的工作流程：\n```\n你: “给我做一个命令行工具”\nAI: *立刻开始写代码*\n你: *写到一半才发现这不是你想要的*\n```\n\n不如使用这种结构化的方法：\n```\n你: “给我做一个命令行工具”\n→ 头脑风暴：AI 提出澄清性问题\n→ 规划：AI 撰写带有验证步骤的详细计划\n→ 你批准该计划\n→ 执行：AI 按照计划逐步构建，并编写测试\n→ 审查：AI 检查潜在问题\n→ 完成：所有内容都已记录且运行正常\n```\n\n**额外好处：** 如果你的计划包含相互独立的步骤（比如“添加三个独立功能”），AI 可以 **并行** 处理这些步骤，从而节省时间！\n\n---\n\n## ✨ 包含的内容\n\n### 工作流（斜杠命令）\n这些是你在反重力中输入的命令：\n\n- `\u002Fsuperpowers-brainstorm` - 在规划之前探索想法并提问\n- `\u002Fsuperpowers-write-plan` - 创建详细的计划（尚未编写代码！）\n- `\u002Fsuperpowers-execute-plan` - 按步骤逐步构建代码\n- `\u002Fsuperpowers-execute-plan-parallel` - 并行构建独立步骤（更快！）\n- `\u002Fsuperpowers-review` - 检查代码质量\n- `\u002Fsuperpowers-debug` - 系统化调试\n- `\u002Fsuperpowers-finish` - 最终总结与文档化\n\n### 技能（构建模块）\n这些技能教会 AI 如何工作：\n\n- **TDD** - 测试驱动开发（先写测试）\n- **Debug** - 系统化的问题解决\n- **Review** - 代码质量检查\n- **REST\u002FPython 自动化** - 针对特定任务的最佳实践\n\n### 规则（护栏）\n自动执行的良好实践：\n\n- ✅ 必须先写计划再编码\n- ✅ 必须获得批准后才能实施\n- ✅ 必须验证每一步是否正常工作\n- ✅ 必须将输出保存到磁盘（而不仅仅是聊天记录）\n\n---\n\n## 🚀 开始使用（分步指南）\n\n### 第一步：检查已安装的工具\n\n在开始之前，请确保你已经安装了以下工具：\n\n#### ✅ 必需（必须具备）：\n\n**Google 反重力**\n- 如何检查：打开反重力（如果能打开，就说明你有它！）\n- 如果没有？[安装反重力](https:\u002F\u002Fantigravity.google)\n\n**Python 3.10 或更高版本**\n- 如何检查：\n  ```bash\n  python --version\n  ```\n- 应显示：`Python 3.10.x` 或更高版本\n- 如果没有？[下载 Python](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)\n\n#### 🎨 可选（仅用于并行执行）：\n\n**Gemini CLI**（使操作更快，但非必需）\n- 如何检查：\n  ```bash\n  gemini --version\n  ```\n- 如果提示“命令未找到”，则表示你尚未安装\n- 如何安装：\n  ```bash\n  npm install -g @google\u002Fgemini-cli\n  ```\n\n  **Windows 用户：** 安装完成后，请验证其是否正常工作：\n  ```powershell\n  gemini --version\n  ```\n  如果看到版本号，则一切正常！如果没有，请参阅下方的 [故障排除]。\n\n---\n\n### 第二步：在你的项目中设置此框架\n\n你有两种选择：\n\n#### 选项 A：从新项目开始（建议首次使用者）\n\n1. **为你的项目创建一个新文件夹：**\n\n   **Windows (PowerShell):**\n   ```powershell\n   mkdir my-awesome-project\n   cd my-awesome-project\n   ```\n\n   **Mac\u002FLinux:**\n   ```bash\n   mkdir my-awesome-project\n   cd my-awesome-project\n   ```\n\n2. **将此仓库中的 `.agent` 文件夹复制到你的项目中：**\n\n   **Windows (PowerShell):**\n   ```powershell\n   # 替换路径为你下载此仓库的位置\n   Copy-Item -Recurse C:\\path\\to\\gemini-superpowers-antigravity\\.agent .\n   ```\n\n   **Mac\u002FLinux:**\n   ```bash\n   # 替换路径为你克隆此仓库的位置\n   cp -r \u002Fpath\u002Fto\u002Fgemini-superpowers-antigravity\u002F.agent .\n   ```\n\n3. **初始化 git（框架运行所必需）：**\n   ```bash\n   git init\n   git add .agent\n   git commit -m \"添加超能力框架\"\n   ```\n\n4. **在此文件夹中打开反重力：**\n\n   **从终端：**\n   ```bash\n   # 确保你在 my-awesome-project 文件夹内\n   # 然后按照你平常的方式打开反重力\n   ```\n\n   **或者：** 打开反重力 → 文件 → 打开文件夹 → 选择 `my-awesome-project`\n\n#### 选项 B：直接使用此仓库（用于测试演示）\n\n1. **克隆此仓库：**\n   ```bash\n   git clone \u003Cyour-repo-url>\n   cd gemini-superpowers-antigravity\n   ```\n\n2. **安装 Python 依赖项（仅限演示）：**\n\n   **Windows (PowerShell):**\n   ```powershell\n   python -m venv .venv\n   .\\.venv\\Scripts\\Activate.ps1\n   pip install -U pip\n   pip install fastapi uvicorn httpx pytest\n   ```\n\n   **Mac\u002FLinux:**\n   ```bash\n   python -m venv .venv\n   source .venv\u002Fbin\u002Factivate\n   pip install -U pip\n   pip install fastapi uvicorn httpx pytest\n   ```\n\n3. **运行演示测试（可选，但很酷）：**\n   ```bash\n   pytest -q\n   ```\n\n   你应该会看到：`6 passed` ✅\n\n4. **在此文件夹中打开反重力**\n\n---\n\n### 第三步：验证是否正常工作\n\n1. **在反重力中输入：**\n   ```\n   \u002Fsuperpowers-reload\n   ```\n\n2. **你应该会看到如下输出：**\n   ```\n   我已重新加载超能力框架：\n\n   规则：superpowers.md\n   工作流：已加载 8 个（头脑风暴、调试、执行计划、执行计划并行、完成、重新加载、审查、撰写计划）\n   技能：已加载 9 个（头脑风暴、调试、完成、规划、Python 自动化、REST 自动化、审查、TDD、工作流）\n\n   在本次会话的剩余时间里，我将遵循这些指示。\n   ```\n\n3. **如果出现上述内容，你就准备好了！** 🎉\n\n4. **如果出现“命令未找到”的提示：**\n   - 确保反重力是在包含 `.agent\u002F` 文件夹的目录下打开的\n   - 尝试关闭并重新打开反重力，确保在正确的文件夹中\n\n---\n\n## 📖 使用方法（你的第一个任务）\n\n让我们构建一个简单的东西来体验它的运作方式。\n\n### 示例：构建一个简单的计算器命令行工具\n\n#### 第 1 步：头脑风暴（可选但有帮助）\n\n在 Antigravity 中输入：\n```\n\u002Fsuperpowers-brainstorm\n\n我想用 Python 构建一个简单的计算器命令行工具，能够对两个数字进行加、减、乘、除运算。\n```\n\n**会发生什么：**\n- AI 会提出一些澄清问题，例如：\n  - “是否支持小数？”\n  - “使用命令行参数还是交互式模式？”\n  - “需要处理除零错误吗？”\n- 回答这些问题以完善你的想法。\n- AI 会将头脑风暴总结写入 `artifacts\u002Fsuperpowers\u002Fbrainstorm.md`。\n\n**你需要做的是：** 回答这些问题，帮助 AI 理解你的需求。\n\n---\n\n#### 第 2 步：编写计划\n\n在 Antigravity 中输入：\n```\n\u002Fsuperpowers-write-plan\n\n用 Python 构建一个包含加、减、乘、除功能的命令行计算器。使用 argparse 处理命令行参数，并为每个函数编写测试。\n```\n\n**会发生什么：**\n- AI 会读取你当前的项目文件（如果有）。\n- 创建一个分步计划，包括：\n  - 每个小步骤耗时约 2–10 分钟。\n  - 计划创建或修改的文件。\n  - 如何验证每一步是否成功。\n- 将计划写入 `artifacts\u002Fsuperpowers\u002Fplan.md`。\n- 提示：**“是否批准此计划？如果没问题，请回复 APPROVED。”**\n\n**你需要做的是：**\n1. 阅读 `artifacts\u002Fsuperpowers\u002Fplan.md` 文件中的计划（或直接在聊天中查看）。\n2. 检查计划是否合理。\n3. 如果满意，输入：`APPROVED`。\n4. 如果不满意，可以请求修改。\n\n**可能看到的计划示例：**\n```\n## 计划\n\n步骤 1：创建计算器模块\n文件：calculator.py\n修改内容：添加加、减、乘、除函数。\n验证方法：python -c \"from calculator import add; print(add(2, 3))\"\n  \n步骤 2：添加测试\n文件：test_calculator.py\n修改内容：为所有函数添加 pytest 测试。\n验证方法：pytest test_calculator.py\n  \n步骤 3：创建命令行接口\n文件：cli.py\n修改内容：使用 argparse 创建命令行界面。\n验证方法：python cli.py add 2 3\n```\n\n---\n\n#### 第 3 步：执行计划\n\n当你批准后，AI 会提示：\n```\n计划已批准。运行 \u002Fsuperpowers-execute-plan 开始实现。\n```\n\n现在输入：\n```\n\u002Fsuperpowers-execute-plan\n```\n\n**会发生什么：**\n- AI 会从 `artifacts\u002Fsuperpowers\u002Fplan.md` 中读取计划。\n- 按照计划逐步实现每个步骤。\n- 每完成一步：\n  - 运行验证命令。\n  - 将执行内容写入 `artifacts\u002Fsuperpowers\u002Fexecution.md`。\n  - 向你展示结果。\n- 如果验证失败，AI 会停止并调试。\n- 最后，AI 会将总结写入 `artifacts\u002Fsuperpowers\u002Ffinish.md`。\n\n**你会看到的内容：**\n```\n正在执行步骤 1：创建计算器模块\n[AI 写入 calculator.py]\n运行验证：python -c \"from calculator import add; print(add(2, 3))\"\n✅ 输出：5\n步骤 1 完成！\n\n正在执行步骤 2：添加测试\n[AI 写入 test_calculator.py]\n运行验证：pytest test_calculator.py\n✅ 4 个测试通过\n步骤 2 完成！\n\n...（继续执行每一步）\n\n所有步骤已完成！🎉\n```\n\n**你需要做的是：** 只需观看即可！AI 会完成所有工作。如果 AI 提出问题，回答即可。\n\n---\n\n#### 第 4 步：检查结果\n\n1. **查看代码：**\n   ```bash\n   ls\n   ```\n   你应该看到新文件：`calculator.py`、`test_calculator.py`、`cli.py`。\n\n2. **尝试运行程序：**\n   ```bash\n   python cli.py add 5 3\n   ```\n   应该显示：`8`。\n\n3. **检查生成的文件：**\n   ```bash\n   # Windows\n   ls artifacts\\superpowers\\\n\n   # Mac\u002FLinux\n   ls artifacts\u002Fsuperpowers\u002F\n   ```\n\n   你应该看到：\n   - `plan.md` - 你批准的计划。\n   - `execution.md` - 每一步的执行记录。\n   - `finish.md` - 最终总结。\n\n---\n\n## ⚡ 使用并行执行（可选——更快的方式！）\n\n如果你的计划中有**相互独立的步骤**（即不依赖彼此的步骤），你可以通过并行执行来节省时间！\n\n### 何时使用并行模式\n\n**适合并行的情况：**\n- ✅ 向不同文件添加 3 个独立功能。\n- ✅ 创建 3 个独立模块。\n- ✅ 为 3 个不同的函数编写测试。\n\n**不适合并行的情况：**\n- ❌ 步骤之间存在依赖关系（例如，步骤 2 需要步骤 1 的输出）。\n- ❌ 所有步骤都修改同一个文件。\n- ❌ 总共只有 1–2 个步骤（开销太大，不值得）。\n\n### 如何使用\n\n**选项 1：让 AI 建议**\n\n当你运行 `\u002Fsuperpowers-execute-plan` 时，如果 AI 检测到独立步骤，它会询问：\n```\n我注意到步骤 1、2、3 是独立的，可以并行执行。\n您想使用 \u002Fsuperpowers-execute-plan-parallel 来加快执行速度吗？\n或者继续按顺序执行？（回复：PARALLEL 或 SEQUENTIAL）\n```\n\n回复：`PARALLEL`\n\n**选项 2：直接使用**\n\n批准计划后，输入：\n```\n\u002Fsuperpowers-execute-plan-parallel\n```\n\n### 并行模式有什么不同？\n\n**顺序执行：**\n```\n步骤 1（5 分钟）→ 步骤 2（5 分钟）→ 步骤 3（5 分钟）= 共 15 分钟\n```\n\n**并行执行：**\n```\n步骤 1（5 分钟）┐\n步骤 2（5 分钟）├─ 同时运行\n步骤 3（5 分钟）┘\n总计：约 5 分钟（快了 60%！）\n```\n\n**你会看到的内容：**\n```\n正在分析计划以进行并行执行...\n\n批次 1（并行执行 - 3 个步骤）：\n- 步骤 1：添加功能 X\n- 步骤 2：添加功能 Y\n- 步骤 3：添加功能 Z\n\n🤖 启动 3 个子代理...\n子代理 1：正在执行步骤 1...\n子代理 2：正在执行步骤 2...\n子代理 3：正在执行步骤 3...\n\n✅ 批次 1 已完成，耗时 5.2 秒\n相比顺序执行节省了 10 分钟！\n```\n\n**日志在哪里？**\n\n检查 `artifacts\u002Fsuperpowers\u002Fsubagents\u002F` 目录——你会看到每个子代理的日志文件，详细记录了各自的工作内容。\n\n---\n\n## 🛠️ 故障排除\n\n### “命令未找到：\u002Fsuperpowers-…”\n\n**问题：** Antigravity 无法识别这些工作流。\n\n**解决方案：**\n1. 确保你位于包含 `.agent\u002F` 文件夹的目录下。\n2. 尝试运行：\n   ```\n   \u002Fsuperpowers-reload\n   ```\n3. 如果仍然无效，请关闭 Antigravity，然后在正确的文件夹中重新打开。\n\n---\n\n### 并行执行失败，提示“gemini 未找到”\n\n**问题：** 你没有安装 Gemini CLI，或者它不在系统的 PATH 中。\n\n**Windows 解决方案：**\n\n1. **安装 Gemini CLI：**\n   ```powershell\n   npm install -g @google\u002Fgemini-cli\n   ```\n\n2. **验证是否安装成功：**\n   ```powershell\n   gemini --version\n   ```\n   应该显示：`@google\u002Fgemini-cli 版本 X.X.X`。\n\n3. **如果仍然提示“未找到”：**\n   - 重启 PowerShell（npm 可能更新了你的 PATH）。\n   - 检查 npm 的全局 bin 目录是否在 PATH 中：\n     ```powershell\n     npm config get prefix\n     ```\n   - 输出应该类似于 `C:\\Users\\YourName\\AppData\\Roaming\\npm`。\n   - 将该路径添加到系统 PATH 环境变量中。\n\n4. **替代方案：** 直接使用顺序执行：\n   ```\n   \u002Fsuperpowers-execute-plan\n   ```\n   （虽然稍慢，但无需 Gemini CLI 即可运行）\n\n**Mac\u002FLinux 解决方案：**\n\n1. **安装 Gemini CLI：**\n   ```bash\n   npm install -g @google\u002Fgemini-cli\n   ```\n\n2. **验证：**\n   ```bash\n   which gemini\n   ```\n   应该显示类似 `\u002Fusr\u002Flocal\u002Fbin\u002Fgemini` 的路径。\n\n3. **如果未找到：**\n   - 确保 npm 的 bin 目录在 PATH 中。\n   - 运行 `echo $PATH`，查找 npm 的 bin 文件夹。\n\n---\n\n### AI 直接开始编码，没有先制定计划\n\n**问题：** AI 没有遵循 Superpowers 规则。\n\n**解决方案：**\n1. 确保 `.agent\u002Frules\u002Fsuperpowers.md` 文件存在。\n2. 尝试运行：\n   ```\n   \u002Fsuperpowers-reload\n   ```\n3. 开始一个新的 Antigravity 对话。\n4. 显式使用以下工作流：\n   ```\n   \u002Fsuperpowers-write-plan \u003C你的任务 >\n   ```\n\n---\n\n### 生成的工件文件没有被创建\n\n**问题：** 文件没有写入 `artifacts\u002Fsuperpowers\u002F` 目录。\n\n**解决方案：**\n1. 检查该目录是否已创建：\n   ```bash\n   ls artifacts\u002Fsuperpowers\u002F\n   ```\n2. 如果该目录为空，可能是 AI 没有按照工作流执行。\n3. 尝试明确告知：\n   ```\n   请遵循 superpowers-execute-plan 工作流，并将工件写入磁盘。\n   ```\n\n---\n\n### 我编辑了工作流但没有任何变化\n\n**问题：** Antigravity 缓存了旧版本。\n\n**解决方案：**\n```\n\u002Fsuperpowers-reload\n```\n\n这会强制 Antigravity 重新读取所有 `.agent\u002F` 文件。\n\n---\n\n## 📂 所有内容的位置\n\n```\nyour-project\u002F\n├── .agent\u002F                          ← Superpowers 框架（请复制此文件夹！）\n│   ├── rules\u002F\n│   │   └── superpowers.md          ← AI 必须遵守的规则\n│   ├── workflows\u002F\n│   │   ├── superpowers-write-plan.md\n│   │   ├── superpowers-execute-plan.md\n│   │   └── ...                      ← 斜杠命令\n│   └── skills\u002F\n│       ├── superpowers-tdd\u002F\n│       ├── superpowers-debug\u002F\n│       └── ...                      ← AI 的构建模块\n│\n├── artifacts\u002F                       ← 生成的输出文件（已忽略在 Git 中）\n│   └── superpowers\u002F\n│       ├── plan.md                  ← 你批准的计划\n│       ├── execution.md             ← 分步执行日志\n│       ├── finish.md                ← 最终总结\n│       └── subagents\u002F               ← 并行执行的日志\n│\n├── your-code-here.py               ← 你的实际项目文件\n├── tests\u002F                          ← AI 创建的测试文件\n└── README.md                       ← 你的项目文档\n```\n\n---\n\n## 🎓 通过示例学习\n\n### 示例 1：简单的 Python 脚本\n\n**任务：** “创建一个统计文本文件中单词数量的脚本”\n\n**你会使用的命令：**\n```\n\u002Fsuperpowers-write-plan 创建一个统计文本文件中单词数量的 Python 脚本\n→ 审核计划\nAPPROVED\n→ AI 创建计划\n\n\u002Fsuperpowers-execute-plan\n→ AI 构建：word_counter.py, test_word_counter.py\n→ AI 验证其功能\n→ 完成！\n```\n\n**结果：** 在约 5 分钟内完成带有测试的可运行脚本。\n\n---\n\n### 示例 2：REST API 客户端\n\n**任务：** “构建一个列出用户仓库的 GitHub API 客户端”\n\n**命令：**\n```\n\u002Fsuperpowers-brainstorm 我想构建一个 GitHub API 客户端\n→ AI 提问：需要认证吗？是否有速率限制？要调用哪些接口？\n→ 你回答\n\n\u002Fsuperpowers-write-plan 构建一个带有认证、速率限制和仓库列表功能的 GitHub API 客户端\n→ AI 创建详细计划\nAPPROVED\n\n\u002Fsuperpowers-execute-plan\n→ AI 按步骤实现\n→ 每一步都经过验证\n→ 完成！\n```\n\n**结果：** 具备错误处理和测试的生产级 API 客户端。\n\n---\n\n### 示例 3：三个独立功能（并行！）\n\n**任务：** “为我的 CLI 添加日志记录、配置文件支持和 --verbose 标志”\n\n**命令：**\n```\n\u002Fsuperpowers-write-plan\n\n为我的 CLI 添加三个功能：\n1. 日志记录到文件\n2. 从配置文件加载设置\n3. 用于详细输出的 --verbose 标志\n\n每个功能应相互独立。\n\n→ AI 创建包含 3 个独立步骤的计划\nAPPROVED\n\n\u002Fsuperpowers-execute-plan-parallel\n→ AI 启动 3 个子代理\n→ 所有 3 个功能同时构建\n→ 比顺序执行快 60%！\n```\n\n**结果：** 三个功能在约 5 分钟内完成，而按顺序执行则需约 15 分钟。\n\n---\n\n## 🎯 快速参考\n\n### 最常用的工作流\n\n```\n1. \u002Fsuperpowers-write-plan \u003C描述你想要的内容>\n2. 阅读计划，输入：APPROVED\n3. \u002Fsuperpowers-execute-plan\n4. 完成！检查你的代码和 artifacts\u002Fsuperpowers\u002Ffinish.md\n```\n\n### 所有可用命令\n\n| 命令 | 功能 | 使用场景 |\n|------|------|----------|\n| `\u002Fsuperpowers-brainstorm` | 通过问答探索想法 | 当你不确定具体需求时 |\n| `\u002Fsuperpowers-write-plan` | 创建详细计划 | 每项任务的开始 |\n| `\u002Fsuperpowers-execute-plan` | 按步骤构建代码 | 批准计划后 |\n| `\u002Fsuperpowers-execute-plan-parallel` | 并行构建独立步骤 | 当计划中有 3 个或更多独立步骤时 |\n| `\u002Fsuperpowers-review` | 检查代码质量 | 在完成前或调试时 |\n| `\u002Fsuperpowers-debug` | 系统性调试 | 当出现问题时 |\n| `\u002Fsuperpowers-finish` | 创建最终总结 | 一切正常后 |\n| `\u002Fsuperpowers-reload` | 重新加载所有工作流\u002F规则 | 编辑 .agent\u002F 文件后 |\n\n---\n\n## 🤝 贡献\n\n想改进这个框架吗？欢迎提交 PR！\n\n**好的贡献想法：**\n- 更多语言特定技能（Node\u002FTS、Go、Rust 等）\n- 更多工作流（git worktree 管理、分支清理等）\n- 更好的并行执行（更智能的依赖检测）\n- 更多展示实际应用的端到端演示\n- 更好的错误信息和故障排除方法\n\n---\n\n## 📄 许可证\n\nMIT 许可证 - 请参阅 LICENSE 文件\n\n---\n\n## 🙏 致谢\n\n- **灵感来源：** [obra\u002Fsuperpowers](https:\u002F\u002Fgithub.com\u002Fobra\u002Fsuperpowers)（Claude Superpowers）\n- **适配于：** Google Antigravity\n- **并行执行概念：** 基于社区关于多智能体工作流的讨论\n\n---\n\n## 💡 成功提示\n\n1. **从小处着手：** 在处理大型项目之前，先尝试计算器示例。\n2. **阅读计划：** 不要盲目批准，务必仔细审查 AI 的建议。\n3. **明智使用并行模式：** 虽然速度快，但如果出错则更难调试。\n4. **检查工件：** `artifacts\u002Fsuperpowers\u002F` 文件夹会清楚地告诉你发生了什么。\n5. **经常重新加载：** 如果你编辑了工作流，务必运行 `\u002Fsuperpowers-reload`。\n6. **提出问题：** 如果计划不合理，请在批准前要求 AI 进行澄清。\n\n祝编码愉快！🚀","# Gemini Superpowers for Antigravity 快速上手指南\n\n本指南帮助你在 **Google Antigravity** 中构建结构化、高质量的代码工作流。它通过“头脑风暴 → 规划 → 执行 → 审查”的流程，防止 AI 直接生成代码，确保每一步都经过验证。\n\n## 🛠️ 环境准备\n\n在开始之前，请确保你的系统满足以下要求：\n\n### 1. 核心依赖（必须）\n*   **Google Antigravity**: 确保已安装并能正常启动。\n    *   下载地址：[Antigravity 官网](https:\u002F\u002Fantigravity.google)\n*   **Python 3.10+**:\n    *   检查版本：`python --version`\n    *   若未安装或版本过低，请访问 [Python 官网](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F) 下载。\n    *   *国内用户提示*：若下载速度慢，可使用清华大学镜像源安装第三方库（后续步骤会用到）。\n\n### 2. 可选依赖（仅用于并行加速）\n*   **Gemini CLI**: 用于启用多任务并行执行，大幅缩短等待时间。\n    *   检查命令：`gemini --version`\n    *   安装命令：\n        ```bash\n        npm install -g @google\u002Fgemini-cli\n        ```\n    *   *注意*：Windows 用户安装后若提示命令不存在，请重启终端或检查环境变量。\n\n---\n\n## 📥 安装步骤\n\n你可以选择在新项目中初始化框架，或直接克隆仓库体验。推荐**选项 A**。\n\n### 选项 A：在新项目中初始化（推荐）\n\n1.  **创建并进入项目目录**\n    ```bash\n    mkdir my-awesome-project\n    cd my-awesome-project\n    ```\n\n2.  **复制框架文件**\n    将下载的 `gemini-superpowers-antigravity` 仓库中的 `.agent` 文件夹复制到当前项目根目录。\n    \n    *   **Mac\u002FLinux**:\n        ```bash\n        cp -r \u002Fpath\u002Fto\u002Fgemini-superpowers-antigravity\u002F.agent .\n        ```\n    *   **Windows (PowerShell)**:\n        ```powershell\n        Copy-Item -Recurse C:\\path\\to\\gemini-superpowers-antigravity\\.agent .\n        ```\n\n3.  **初始化 Git（必需）**\n    该框架依赖 Git 追踪状态。\n    ```bash\n    git init\n    git add .agent\n    git commit -m \"Add Superpowers framework\"\n    ```\n\n4.  **启动 Antigravity**\n    在当前目录下打开 Antigravity：\n    ```bash\n    # 确保终端位于项目目录内，然后启动 Antigravity\n    antigravity . \n    # 或者通过 GUI: File -> Open Folder -> 选择 my-awesome-project\n    ```\n\n### 选项 B：直接运行演示（仅测试）\n\n如果你想直接体验内置的 Demo：\n\n1.  **克隆仓库**\n    ```bash\n    git clone \u003Cyour-repo-url>\n    cd gemini-superpowers-antigravity\n    ```\n\n2.  **安装 Python 依赖**\n    ```bash\n    python -m venv .venv\n    \n    # Windows 激活\n    .\\.venv\\Scripts\\Activate.ps1\n    # Mac\u002FLinux 激活\n    source .venv\u002Fbin\u002Factivate\n    \n    # 安装依赖 (国内用户推荐使用清华源加速)\n    pip install -U pip -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n    pip install fastapi uvicorn httpx pytest -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n    ```\n\n3.  **验证测试**\n    ```bash\n    pytest -q\n    # 应显示：6 passed\n    ```\n\n4.  **启动 Antigravity**\n    在当前目录打开 Antigravity。\n\n---\n\n## 🚀 基本使用\n\n### 1. 验证安装\n在 Antigravity 聊天框中输入以下命令加载框架：\n```\n\u002Fsuperpowers-reload\n```\n若看到类似 `Workflows: 8 loaded` 和 `Rules: superpowers.md` 的成功提示，即表示安装成功。\n\n### 2. 实战示例：构建一个计算器 CLI\n\n我们将通过标准的四步流程来构建一个简单的 Python 计算器。\n\n#### 第一步：头脑风暴 (Brainstorm)\n输入命令明确需求，让 AI 提问以澄清细节。\n```\n\u002Fsuperpowers-brainstorm\n\n我想用 Python 写一个命令行计算器，支持加减乘除。\n```\n*   **AI 行为**：询问是否支持小数、交互模式还是参数模式、错误处理等。\n*   **你的操作**：回答这些问题。结果将保存至 `artifacts\u002Fsuperpowers\u002Fbrainstorm.md`。\n\n#### 第二步：制定计划 (Plan)\n基于确认的需求，生成详细执行计划。\n```\n\u002Fsuperpowers-write-plan\n\n创建一个包含加减乘除函数的 Python 计算器。使用 argparse 处理命令行参数，并为每个函数编写测试。\n```\n*   **AI 行为**：生成分步计划（包含文件修改、验证命令），保存至 `artifacts\u002Fsuperpowers\u002Fplan.md`。\n*   **你的操作**：阅读计划。如果满意，回复 **`APPROVED`**；如果不满意，提出修改意见。\n\n#### 第三步：执行计划 (Execute)\n计划批准后，开始逐步编码。\n```\n\u002Fsuperpowers-execute-plan\n```\n*   **AI 行为**：\n    1.  按步骤逐个实现功能。\n    2.  每步完成后自动运行验证命令（如 `pytest` 或 `python -c ...`）。\n    3.  若验证失败则自动调试。\n    4.  记录日志至 `artifacts\u002Fsuperpowers\u002Fexecution.md`。\n*   **你的操作**：观察进度，如有需要回答 AI 的临时提问。\n\n*(可选) **并行加速**：如果计划中的步骤相互独立（例如同时开发三个不相关的模块），AI 可能会建议使用 `\u002Fsuperpowers-execute-plan-parallel` 以节省时间。*\n\n#### 第四步：检查结果\n执行完成后，验证成果：\n1.  **查看文件**：确认生成了 `calculator.py`, `test_calculator.py`, `cli.py` 等。\n2.  **运行测试**：\n    ```bash\n    python cli.py add 5 3\n    # 输出应为：8\n    ```\n3.  **查看文档**：检查 `artifacts\u002Fsuperpowers\u002Ffinish.md` 获取最终总结。\n\n---\n\n### 常用指令速查\n\n| 指令 | 功能描述 |\n| :--- | :--- |\n| `\u002Fsuperpowers-brainstorm` | 探索想法，澄清需求 |\n| `\u002Fsuperpowers-write-plan` | 生成详细实施计划（不含代码） |\n| `\u002Fsuperpowers-execute-plan` | 按顺序执行计划并验证 |\n| `\u002Fsuperpowers-execute-plan-parallel` | 并行执行独立步骤（需安装 Gemini CLI） |\n| `\u002Fsuperpowers-review` | 代码质量审查 |\n| `\u002Fsuperpowers-debug` | 系统性调试 |\n| `\u002Fsuperpowers-finish` | 生成最终总结和文档 |","一位全栈开发者需要在两天内为内部团队构建一个具备数据清洗、格式转换和自动报告生成三大功能的 Python CLI 工具。\n\n### 没有 gemini-superpowers-antigravity 时\n- AI 往往在未明确需求细节时就急于生成代码，导致最终产出的功能与预期偏差较大，需要反复返工。\n- 开发过程缺乏系统性规划，三个功能模块串行编写，一旦中间出现逻辑错误，调试耗时且容易遗漏边界情况。\n- 缺少强制的测试驱动流程，代码写完才发现核心算法存在漏洞，修复成本高昂。\n- 最终交付物缺乏统一文档，且部分中间结果仅停留在对话窗口中，未保存至本地磁盘，难以直接集成到项目仓库。\n\n### 使用 gemini-superpowers-antigravity 后\n- 通过 `\u002Fsuperpowers-brainstorm` 指令，AI 先主动澄清数据格式和报告样式等关键需求，确保方向正确后再进入规划阶段。\n- 利用 `\u002Fsuperpowers-execute-plan-parallel` 指令，AI 将三个独立功能模块并行开发与测试，显著缩短了整体构建时间。\n- 内置的 TDD（测试驱动开发）技能强制要求“先写测试后写代码”，每一步执行前都经过验证，从源头杜绝了重大逻辑缺陷。\n- 遵循严格的规则护栏，所有代码、测试结果及最终文档均自动保存至本地磁盘，并通过 `\u002Fsuperpowers-finish` 生成完整的项目总结。\n\ngemini-superpowers-antigravity 通过将混乱的即兴编码转化为“构思 - 规划 - 并行执行 - 审查”的结构化工作流，让 AI 编程从“碰运气”变成了可控的高效工程实践。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fanthonylee991_gemini-superpowers-antigravity_1f196248.png","anthonylee991","CARDUME ESBELTO UNIP. LDA","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fanthonylee991_b53bbae8.png",null,"CARDUME ESBELTO UNIP. LDA, Dba A.I. Plus Automation","Lisbon, Portugal","https:\u002F\u002Fgithub.com\u002Fanthonylee991",[81],{"name":82,"color":83,"percentage":84},"Python","#3572A5",100,727,91,"2026-04-17T01:37:29","MIT","Linux, macOS, Windows","未说明",{"notes":92,"python":93,"dependencies":94},"必须安装 Google Antigravity；并行执行功能可选安装 Gemini CLI；项目需初始化 git 仓库；核心配置位于 .agent 文件夹中。","3.10+",[95,96,97,98,99],"fastapi","uvicorn","httpx","pytest","@google\u002Fgemini-cli",[35,13,45],"2026-03-27T02:49:30.150509","2026-04-19T03:05:03.720251",[104],{"id":105,"question_zh":106,"answer_zh":107,"source_url":108},41551,"如果我的项目已经存在，该如何使用此框架？","目前该问题尚未在 Issue 中获得具体的官方解答或操作步骤。建议用户手动将 `.agent` 文件夹复制到现有项目的根目录中，并根据项目需求进行初始化配置。如有进一步集成需求，可参考 ALPHA 等脚手架工具的集成方式（自动复制并初始化 git）。","https:\u002F\u002Fgithub.com\u002Fanthonylee991\u002Fgemini-superpowers-antigravity\u002Fissues\u002F7",[]]