概述

1.1 什么是 Superpowers？

Superpowers 是一套 Claude Code 插件技能集，专注于软件工程方法论的系统化。它将 TDD（测试驱动开发）、代码审查、系统调试等工程实践编码为可复用的 AI 工作流，确保 AI 编码助手遵循严格的工程纪律。

核心理念： 用规则约束 AI 行为，防止"快速但低质量"的代码输出。

1.2 什么是 gstack？

gstack 是一套全生命周期项目管理技能集，覆盖从产品构思到部署监控的完整开发流程。它提供 QA 测试、代码审查、设计审查、部署验证等自动化工作流。

核心理念： "Boil the Ocean"（把海水煮沸）— 既然 AI 边际成本趋近于零，就把每件事做到极致完整。

1.3 为什么要结合使用？

维度	Superpowers 贡献	gstack 贡献
规划	设计文档 + 实施计划模板	CEO/工程/设计多维审查
实现	TDD + 子代理驱动开发	自动化测试 + 浏览器 QA
审查	代码审查协议	多维审查军团 + 安全扫描
部署	完成分支管理	Ship + 部署 + 金丝雀监控
质量	验证即完成	设计审查 + 可访问性审计

---

2. 安装与配置

2.1 前置条件

检查项	要求
Node.js	>= 18
Git	>= 2.34
Claude Code CLI	已安装
GitHub CLI (gh)	已安装并认证
操作系统	macOS / Linux / Windows (WSL)

2.2 安装 Superpowers

Superpowers 作为 Claude Code 插件安装：

# 方法一：通过 Claude Code 插件市场安装（推荐）
claude plugins:install superpowers

# 方法二：手动安装
cd ~/.claude/plugins
git clone https://github.com/anthropics/superpowers.git

# 验证安装
claude skills:list | grep superpowers

安装完成后，技能文件位于：

~/.claude/plugins/cache/superpowers/superpowers/<version>/skills/
├── brainstorming/SKILL.md
├── dispatching-parallel-agents/SKILL.md
├── executing-plans/SKILL.md
├── finishing-a-development-branch/SKILL.md
├── receiving-code-review/SKILL.md
├── requesting-code-review/SKILL.md
├── subagent-driven-development/SKILL.md
├── systematic-debugging/SKILL.md
├── test-driven-development/SKILL.md
├── using-git-worktrees/SKILL.md
├── using-superpowers/SKILL.md
├── verification-before-completion/SKILL.md
├── writing-plans/SKILL.md
└── writing-skills/SKILL.md

2.3 安装 gstack

# 方法一：通过 setup 脚本安装（推荐）
cd ~/.claude/skills
git clone https://github.com/garryslist/gstack.git
cd gstack && ./setup

# 方法二：如果已有 Claude Code 环境，直接运行
cd ~/.claude/skills/gstack && ./setup --team

# 验证安装
ls ~/.claude/skills/gstack/SKILL.md

gstack 安装后的目录结构：

~/.claude/skills/gstack/
├── SKILL.md              # 主入口技能
├── bin/                  # CLI 工具集
├── browse/              # 无头浏览器引擎
├── sections/            # 各子流程详细步骤
└── ...

~/.claude/skills/         # gstack 子技能（独立目录）
├── spec/
├── ship/
├── qa/
├── investigate/
├── review/
├── design-review/
├── context-save/
├── context-restore/
├── autoplan/
├── office-hours/
├── land-and-deploy/
├── canary/
├── dev-workflow/
└── ...

2.4 配置 CLAUDE.md 路由规则

安装完成后，在项目根目录的 CLAUDE.md 中添加技能路由：

## Skill routing

When the user's request matches an available skill, invoke it via the Skill tool.

Key routing rules:
- 产品创意/头脑风暴     → /office-hours
- 策略/范围    → /plan-ceo-review
- 架构      → /plan-eng-review
- 设计系统/计划审查     → /design-consultation 或 /plan-design-review
- 全流程审查      → /autoplan
- Bug/错误     → /investigate
- QA/测试行为     → /qa 或 /qa-only
- 代码审查/diff 检查    → /review
- 视觉优化     → /design-review
- 发布/部署/PR    → /ship 或 /land-and-deploy
- 保存进度     → /context-save
- 恢复上下文      → /context-restore
- 撰写规格文档    → /spec

2.5 配置流程图

---

3. Superpowers 技能详解

3.1 技能总览

3.2 各技能详细说明

3.2.1 brainstorming（头脑风暴）