Superpowers + gstack 应用实践指南

发布时间:2026/6/30 4:02:56

Superpowers + gstack 应用实践指南 概述1.1 什么是 SuperpowersSuperpowers是一套 Claude Code 插件技能集专注于软件工程方法论的系统化。它将 TDD测试驱动开发、代码审查、系统调试等工程实践编码为可复用的 AI 工作流确保 AI 编码助手遵循严格的工程纪律。核心理念用规则约束 AI 行为防止快速但低质量的代码输出。1.2 什么是 gstackgstack是一套全生命周期项目管理技能集覆盖从产品构思到部署监控的完整开发流程。它提供 QA 测试、代码审查、设计审查、部署验证等自动化工作流。核心理念Boil the Ocean把海水煮沸— 既然 AI 边际成本趋近于零就把每件事做到极致完整。1.3 为什么要结合使用维度Superpowers 贡献gstack 贡献规划设计文档 实施计划模板CEO/工程/设计多维审查实现TDD 子代理驱动开发自动化测试 浏览器 QA审查代码审查协议多维审查军团 安全扫描部署完成分支管理Ship 部署 金丝雀监控质量验证即完成设计审查 可访问性审计2. 安装与配置2.1 前置条件检查项要求Node.js 18Git 2.34Claude Code CLI已安装GitHub CLI (gh)已安装并认证操作系统macOS / Linux / Windows (WSL)2.2 安装 SuperpowersSuperpowers 作为 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.md2.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.mdgstack 安装后的目录结构~/.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 users 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 - 撰写规格文档 → /spec2.5 配置流程图3. Superpowers 技能详解3.1 技能总览3.2 各技能详细说明3.2.1 brainstorming头脑风暴属性说明用途在任何创意性工作之前进行需求探索和设计触发新功能、新组件、行为变更硬性规则设计批准前禁止任何实现代码工作流探索项目上下文 → 逐一提问单选题优先→ 提出2-3个方案 → 分段展示设计 → 用户逐段批准 → 写入设计文档 → 过渡到 writing-plans使用示例用户: 我想给系统加一个通知中心 AI: [调用 brainstorming] 让我先了解一下需求... 1. 通知中心主要服务哪些用户 A) 内部运营 B) 终端用户 C) 两者都有3.2.2 writing-plans编写计划属性说明用途将需求/设计文档转化为可执行的实施计划触发有了 spec 或需求准备开始编码之前硬性规则禁止占位符TBD、类似任务N等计划文件结构# 实施计划: [功能名称] ## Header - Goal: [目标] - Architecture: [架构描述] - Tech Stack: [技术栈] - Global Constraints: [全局约束] ## Task 1: [任务名] ### Step 1.1: Write failing test - File: src/tests/feature.test.ts - Expected: RED (test fails) - Command: npm test -- --grep feature - Expected output: 1 failing ### Step 1.2: Implement minimal code - File: src/feature.ts - Expected: GREEN (test passes) ...保存位置docs/superpowers/plans/YYYY-MM-DD-feature-name.md3.2.3 test-driven-development测试驱动开发属性说明用途所有新功能、Bug 修复、重构的实现方法触发任何代码变更铁律没有失败测试不写生产代码Red-Green-Refactor 循环关键规则先写测试 → 运行确认失败必须看到红色写最小代码 → 运行确认通过必须看到绿色重构 → 保持测试通过在测试之前写的代码 删除重来3.2.4 systematic-debugging系统化调试属性说明用途任何 Bug、测试失败、异常行为的调查触发报错、异常、为什么不工作铁律不找到根因不修复四阶段流程三振出局规则3次修复尝试失败 → 停止并质疑架构3.2.5 subagent-driven-development子代理驱动开发属性说明用途将计划中的任务分派给独立子代理执行触发有计划、任务相对独立、需要并行关键每个任务一个代理 任务审查 全分支审查执行模式3.2.6 verification-before-completion完成前验证属性说明用途任何完成声明之前的强制验证触发准备说Done、Fixed、Passing铁律没有新鲜的验证证据不声明完成门控函数识别证明命令 → 运行完整命令 → 读取完整输出 → 验证输出支持声明 → 才能声明3.2.7 其他技能速查技能一句话说明何时使用using-superpowers技能调度总控确保正确技能被调用每次对话开始dispatching-parallel-agents将独立任务并行分派给多个代理3 独立故障executing-plans在当前会话中逐步执行计划无子代理时finishing-a-development-branch分支完成后的合并/PR/清理实现完毕requesting-code-review派遣审查子代理做代码审查每个任务完成后receiving-code-review处理审查反馈的协议收到审查意见using-git-worktrees创建隔离工作空间开始新功能writing-skills用 TDD 方法编写新技能创建/编辑技能4. gstack 技能详解4.1 技能总览4.2 核心技能详细说明4.2.1 /office-hours产品构思属性说明用途YC 式产品办公时间探索产品方向触发我有个想法、这个值得做吗、帮我想想输出设计文档非代码两种模式Startup Mode六大逼问需求真实性、现状、紧迫性、最窄切入点...Builder Mode生成式、鼓励性探索使用示例用户: /office-hours 我想做一个 AI 驱动的客服机器人 AI: [启动 Startup Mode] 让我问第一个问题 谁正在急迫地为这个问题付费或忍受痛苦 能否描述一个具体的用户和他们今天是怎么应对的4.2.2 /spec规格文档属性说明用途将模糊意图变为精确、可执行的规格触发写个 ticket、提个 issue、规格化输出GitHub Issue五阶段流程4.2.3 /qaQA 测试属性说明用途系统化 QA 测试 Web 应用并修复 Bug触发测试一下、QA、有没有 bug三层深度Quick / Standard / Exhaustive工作流初始化 → 认证 → 定向 → 逐页探索 → 截图取证 → 健康评分 → 分诊 → 修复循环定位→修复→提交→回测→ 最终 QA → 报告关键特性使用无头浏览器不看源码以用户视角测试每个修复一个原子提交回归时自动 revert每个 Issue 必须有截图证据硬限 50 个修复4.2.4 /investigateBug 调查属性说明用途系统化根因调查触发为什么坏了、debug、根因分析铁律不找到根因不修复与 Superpowers 的 systematic-debugging 完全互补Superpowers 提供方法论框架gstack/investigate提供工具支持浏览器、代码搜索、学习记录等4.2.5 /ship发布属性说明用途自动化发布流程触发发布、创建 PR、ship it特点全自动极少打断21 步流水线4.2.6 /review代码审查属性说明用途着陆前代码审查触发审查代码、看看我的改动、code review特色多维并行审查军团审查维度SQL 安全性LLM 信任边界竞态条件Shell 注入枚举完整性测试覆盖可维护性性能API 契约4.2.7 /land-and-deploy着陆部署属性说明用途合并 PR 等待部署 验证生产触发merge、deploy、land it后续自动触发 /canary预检 → CI 检查 → 等待 CI → 预合并门控 → 合并 → 部署策略检测 → 等待部署 → 金丝雀验证 → 异常回滚 → 部署报告4.2.8 /canary金丝雀监控属性说明用途部署后持续监控触发监控部署、post-deploy check默认时长10 分钟监控内容控制台错误性能回归2x 基线 回归页面加载失败截图对比4.2.9 /context-save /context-restore上下文管理/context-save: 保存当前 git 状态 决策 剩余工作 → 检查点文件 /context-restore: 加载最近检查点 → 恢复工作上下文使用场景切换分支、会话超时、跨天工作5. 两者结合使用5.1 职责分工图5.2 对应关系表开发阶段Superpowers 技能gstack 技能结合方式构思/brainstorming/office-hoursgstack 提供产品框架Superpowers 确保设计先行规划/writing-plans/autoplanSuperpowers 写计划gstack 多维审查隔离/using-git-worktrees—Superpowers 管理 worktree 生命周期实现/TDD /subagent-driven—严格 Red-Green-Refactor调试/systematic-debugging/investigate方法论 工具链双重保障审查/requesting/receiving-review/reviewSuperpowers 定协议gstack 跑军团测试/verification-before-completion/qa先 QA 黑盒测试再白盒验证发布/finishing-a-branch/shipSuperpowers 管分支gstack 管流水线部署—/land-and-deploy /canarygstack 全权负责上下文—/context-save/restoregstack 跨会话保存5.3 典型结合场景场景 1新功能开发1. /office-hours ← gstack 产品探索 2. /brainstorming ← Superpowers 设计先行 3. /writing-plans ← Superpowers 编写计划 4. /autoplan ← gstack 全维度审查 5. /using-git-worktrees ← Superpowers 创建隔离环境 6. /TDD (Red-Green-Refactor) ← Superpowers 驱动实现 7. /requesting-code-review ← Superpowers 派遣审查代理 8. /review ← gstack 审查军团 9. /verification ← Superpowers 验证证据 10. /ship ← gstack 发布 11. /land-and-deploy ← gstack 部署 12. /canary ← gstack 监控场景 2Bug 修复1. /investigate ← gstack 工具辅助调查 2. /systematic-debugging ← Superpowers 方法论约束 3. /TDD (先写失败测试) ← Superpowers 确保质量 4. /verification ← Superpowers 验证修复 5. /ship ← gstack 发布场景 3代码审查1. /requesting-code-review ← Superpowers 生成审查请求 2. /review ← gstack 执行多维审查 3. /receiving-code-review ← Superpowers 处理反馈协议

相关新闻