gstack Superpowers 使用手册两份 AI 工程方法论一个完整开发工作流适用平台Claude Code / Codex CLI / Cursor / Gemini CLI / OpenCode目录Part 1gstack — 虚拟工程团队Part 2Superpowers — AI 工程方法论Part 3gstack Superpowers 协同使用附录 A官方仓库与文档附录 B网络教程与文章Part 1gstack — 虚拟工程团队1.1 概述gstack是 Y Combinator CEO Garry Tan 创建的开源MITClaude Code 技能集合。它将 Claude Code 从一个通用 AI 助手转变为一支由 23 专家角色和 8 个强力工具组成的虚拟工程团队。仓库地址https://github.com/garrytan/gstack创建者Garry Tan (YC President CEO)当前版本1.40.0.0许可证MIT核心理念思考 → 规划 → 构建 → 审查 → 测试 → 交付 → 反思 (Think → Plan → Build → Review → Test → Ship → Reflect)每个环节的输出是下一个环节的输入确保上下文不丢失不遗漏任何细节。Garry Tan 报告使用此工作流每天可产出10,000–20,000 行可用代码其中约 35% 是测试代码。1.2 安装前提条件Claude Code或其他支持的 AI 编程代理GitBun v1.0Node.jsWindows 平台需要全局安装Claude Codegitclone https://github.com/garrytan/gstack.git ~/.claude/skills/gstackcd~/.claude/skills/gstack./setup多代理安装# OpenAI Codex CLIgitclone https://github.com/garrytan/gstack.git ~/.codex/skills/gstackcd~/.codex/skills/gstack./setup--hostcodex# 自动检测所有已安装代理gitclone https://github.com/garrytan/gstack.git ~/gstackcd~/gstack./setup--hostauto升级 gstackcd~/.claude/skills/gstackgitfetch origingitreset--hardorigin/mainbash./setup或使用内置命令/gstack-upgrade1.3 全部技能参考规划与策略Pre-Development命令角色功能说明/office-hoursYC 合伙人6 个强制问题重构产品想法生成设计文档/plan-ceo-reviewCEO/创始人四种模式扩展/选择性扩展/维持范围/缩减找到 10 星产品/plan-eng-review工程经理锁定架构、数据流图、状态机、边界情况、测试矩阵、错误路径/plan-design-review高级设计师0-10 分评估每个设计维度AI 痕迹检测/plan-devex-reviewDX 负责人探索开发者角色、基准 TTHW、设计魔法时刻/plan-tune调优专家自调问题敏感度从不询问/始终询问/有条件询问/autoplan自动审查自动运行 CEO→设计→工程→DX 审查流水线/design-consultation设计合伙人从零构建完整设计系统实现与审查Implementation Review命令角色功能说明/review高级工程师预合并 PR 审查找出 CI 通过但生产会暴露的 Bug自动修复/codex第二意见通过 OpenAI Codex CLI 进行跨模型代码审查通过/不通过/对抗/咨询/investigate调试专家系统化根因调试遵循不调查不修复铁律/design-review设计师80 项现场视觉审计 修复循环/design-shotgun设计师生成 4-6 个 AI 设计变体对比面板反馈迭代/design-html前端开发生成生产级 HTML/CSS30KB 零依赖/devex-reviewDX 审计实测入职流程、TTHW 计时、错误截图测试与 QATesting QA命令角色功能说明/qaQA 负责人真实 Chromium 浏览器测试发现并修复 Bug生成回归测试/qa-onlyQA 报告者同上但只生成 Bug 报告不修改代码/browse浏览器自动化无头 Chromium 浏览器Playwright 驱动~100ms/命令/setup-browser-cookies会话管理从 Chrome/Arc/Brave/Edge 导入 cookies 进行认证测试/benchmark性能工程师性能回归检测页面加载时间、Core Web Vitals、资源大小安全Security命令角色功能说明/cso首席安全官OWASP Top 10 STRIDE 威胁建模每日8/10 置信度或全量模式交付与部署Ship Deploy命令角色功能说明/ship发布工程师同步主分支、运行测试、审计覆盖率、推送、创建 PR/land-and-deploy部署工程师合并 PR、等待 CI、部署、验证生产健康状态/canarySRE部署后监控循环控制台错误、性能回归、页面故障/setup-deploy部署配置一次性部署配置检测Fly.io, Render, Vercel 等/document-release技术文档更新所有项目文档以匹配发布内容/document-generate文档生成从代码生成遗失的 Diataxis 文档数据采集Scraping命令角色功能说明/scrape数据采集从网页提取数据首次用 browse 原型后续用固化脚本~200ms/skillify脚本固化将最近成功的/scrape固化到永久浏览器技能运维与记忆Operational Memory命令角色功能说明/learn知识管理管理跨会话记忆审查、搜索、修剪、导出项目模式/retro回顾周工程回顾按人分解、交付记录、测试健康趋势/health代码健康代码质量仪表盘类型检查、Linter、测试、死代码/context-save上下文保存保存工作上下文供后续恢复/context-restore上下文恢复从保存的上下文恢复/setup-gbrainGBrain 设置设置 gbrain 持久记忆/sync-gbrainGBrain 同步将 gbrain 与仓库保持同步安全防护Safety命令功能说明/careful破坏性命令前警告rm -rf, DROP TABLE, force-push/freeze锁定编辑到一个目录硬性阻止/guard同时启动/careful/freeze/unfreeze移除/freeze限制工具类命令功能说明/browse无头 Chromium 浏览器导航、点击、填表、截图、验证/open-gstack-browser启动 GStack 浏览器侧边栏、反机器人隐身、自动模型路由/pair-agent配对远程 AI 代理与浏览器/benchmark-models跨模型基准测试Claude vs GPT vs Gemini/make-pdfMarkdown 转出版质量 PDF/gstack-upgrade自升级到最新版本1.4 浏览器命令速查browse浏览器基于 Playwright/Chromium提供 80 命令类别命令导航goto,back,forward,reload,url读取html,text,data,links,forms,media,accessibility,snapshot交互click,fill,select,type,press,hover,scroll,upload,wait视觉screenshot,prettyscreenshot,responsive,diff,pdf检查attrs,css,js,eval,console,network,perf,cookies,storage,cdp标签页tabs,newtab,closetab,tab,tab-each服务器connect,disconnect,handoff,resume,restart,stop,status,state,focus元命令chain,skill,domain-skill,inbox,frame,watch提取archive,download,scrape1.5 典型工作流示例# 1. 头脑风暴/office-hours我想做一个日历每日简报应用Claude 重新定义你实际上在做个人首席 AI 助手→ 生成设计文档# 2. CEO 审查/plan-ceo-review 挑战范围找到明天就能交付的最小可行方案# 3. 工程规划/plan-eng-review ASCII 架构图、数据流、错误路径、测试矩阵# 4. 实现[Claude 在约8分钟内编写2,400行代码跨越11个文件]# 5. 代码审查/review 自动修复2个问题标记1个竞态条件# 6. QA 测试/qa https://staging.myapp.com 打开真实浏览器点击完整流程发现并修复 Bug# 7. 交付/ship 所有测试通过覆盖率已审计PR 已创建1.6 并行工作Conductor 模式gstack 的核心突破功能可以同时运行10–15 个并行 Sprint— 不同功能、不同分支、不同 Claude Code 会话 — 全部在独立工作空间中相互隔离。这是实现 10K LOC/天生产力的关键。1.7 使用原则不要跳过角色价值在于结构化思考而非仅代码输出顺序串联角色每个角色的输出是下一个角色的上下文自定义 Markdown 文件团队应调整命令以适应自身规范测试一切/ship会在缺少测试框架时自动引导构建版本管理你的技能把技能文件视为代码Part 2Superpowers — AI 工程方法论2.1 概述Superpowers是 Jesse Vincent (obra) 创建的 AI 代理技能框架和软件开发方法论。它是一套基础技能集合教授 Claude Code及其他 AI 代理如何遵循严谨的工程规范。仓库地址https://github.com/obra/superpowers创建者Jesse Vincent (jessefsck.com)许可证MIT核心理念测试驱动开发— 始终先写测试系统性而非临时性— 过程优于猜测降低复杂度— 简洁为首要目标证据优于声明— 在声明成功之前先验证2.2 安装通过官方市场安装推荐/plugin install superpowersclaude-plugins-official通过 Superpowers 市场安装/plugin marketplace add obra/superpowers-marketplace /plugin install superpowerssuperpowers-marketplace2.3 全部 14 项技能元技能Meta-Skill技能功能说明using-superpowers入口技能— 在任何操作前检查是否有适用的技能。核心规则即使只有 1% 的概率适用也必须先调用技能核心工作流7 阶段阶段技能功能说明1brainstorming苏格拉底式设计细化 — 写代码前厘清需求和设计2using-git-worktrees创建独立工作空间Git Worktree提供干净的测试基线3writing-plans将工作分解为可逐项完成的 TDD 任务每个 2–5 分钟4subagent-driven-development/executing-plans每个任务派遣新的子代理配合两阶段审查5test-driven-development严格的 RED-GREEN-REFACTOR — 没有失败测试前不写任何生产代码6requesting-code-review/receiving-code-review任务间对照计划进行审查7finishing-a-development-branch验证后合并/创建 PR/保留/丢弃分支辅助技能技能功能说明systematic-debugging4 阶段根因排查流程verification-before-completion证据优于声明 — 完成前验证所有内容dispatching-parallel-agents并发分析任务writing-skills创建你自己的技能2.4 技能调用优先级用户消息 → 是否有技能可能适用即使 1% 概率 是 → 是 → 调用 Skill 工具 → 宣布 Using [skill] to [purpose] → 有检查清单→ 创建 TodoWrite 项目 → 严格遵循技能执行 → 否 → 正常回复指令优先级用户明确指令CLAUDE.md, 直接请求— 最高优先级Superpowers 技能— 在与默认行为冲突时覆盖默认系统提示— 最低优先级技能类型刚性技能TDD、调试严格遵循不得为适应上下文而偏离灵活技能模式类将原则适配到上下文中2.5 你应该警惕的信号Red Flags以下想法表明你在回避使用技能想法纠正“这只是个简单问题”问题就是任务检查是否有技能“我需要先了解更多上下文”技能检查在澄清问题之前“让我先探索代码库”技能会告诉你如何探索先检查“这不需要正式的技能”如果存在相关技能就使用它“我记得这个技能”技能会进化读取当前版本2.6 跨平台适配Superpowers 支持多种 AI 编程代理平台技能调用方式Claude Code使用Skill工具Copilot CLI使用skill工具Gemini CLI使用activate_skill工具Codex技能原生加载2.7 其他相关仓库仓库说明obra/superpowers-developing-for-claude-code包含 42 份关于构建插件、技能、MCP 服务器的文档obra/superpowers-lab实验性技能查找重复函数、MCP CLI、tmux 交互命令Part 3gstack Superpowers 协同使用3.1 两者的关系Superpowers方法论层 ↓ 定义 如何 工作 ┌─────────────────────────────┐ │ TDD → SysDebug → Plan │ │ Code Review → Verify │ └─────────────────────────────┘ gstack执行层 ↓ 定义 谁 来执行 ┌─────────────────────────────┐ │ CEO → EngMgr → QA │ │ Designer → Security │ └─────────────────────────────┘ 协同工作 Superpowers 的流程规范 gstack 的角色体系Superpowers定义了方法论如何做 TDD、如何调试、如何写计划、如何审查代码gstack定义了角色CEO 审查范围、工程经理锁定架构、QA 进行浏览器测试、安全官执行审计两者互补可以同时使用。3.2 协同工作流示例# 1. Superpowers: 先创建隔离工作空间/using-git-worktrees# 2. Superpowers: 头脑风暴 gstack: 产品规划/brainstorming# Superpowers 苏格拉底式设计细化/office-hours# gstack YC 式产品询问# 3. gstack: 工程规划 Superpowers: 写实施计划/plan-eng-review# gstack 架构审查/writing-plans# Superpowers 分解任务# 4. 实现/executing-plans# Superpowers 逐个执行任务/test-driven-development# Superpowers RED-GREEN-REFACTOR# 5. gstack: 审查 Superpowers: 代码审查流程/review# gstack 预合并审查/requesting-code-review# Superpowers 对照计划审查# 6. gstack: QA Superpowers: 验证/qa staging.app.com# gstack 浏览器测试/verification-before-completion# Superpowers 证据收集# 7. Superpowers: 完成分支/finishing-a-development-branch# 清理并合并# 8. gstack: 交付/ship# gstack 创建 PR、测试、部署3.3 使用建议场景推荐新功能开发Superpowersbrainstorming gstack/office-hours→ gstack/plan-eng-review→ Superpowers TDD 实现 → gstack/review/qa→ gstack/shipBug 修复Superpowerssystematic-debugging gstack/investigate→ Superpowers TDD 修复 → gstack/review代码审查Superpowersreceiving-code-review接收 → gstack/review审查安全审计gstack/csoOWASP STRIDE设计工作gstack/design-shotgun多方案→/design-review审计修复学习固化gstack/learn保存项目经验附录 A官方仓库与文档gstack 官方资源资源URLGitHub 仓库https://github.com/garrytan/gstack架构文档ARCHITECTURE.mdhttps://github.com/garrytan/gstack/blob/master/ARCHITECTURE.md贡献指南CONTRIBUTING.mdhttps://github.com/garrytan/gstack/blob/master/CONTRIBUTING.md浏览器命令参考BROWSER.mdhttps://github.com/garrytan/gstack/blob/master/BROWSER.md版本日志CHANGELOG.mdhttps://github.com/garrytan/gstack/blob/master/CHANGELOG.mdGBrain 集成指南https://github.com/garrytan/gstack/blob/master/USING_GBRAIN_WITH_GSTACK.md设计系统https://github.com/garrytan/gstack/blob/master/DESIGN.mdOpenClaw 集成https://github.com/garrytan/gstack/blob/master/docs/OPENCLAW.md技能详解https://github.com/garrytan/gstack/blob/master/docs/skills.md远程浏览器访问https://github.com/garrytan/gstack/blob/master/docs/REMOTE_BROWSER_ACCESS.mdSuperpowers 官方资源资源URLGitHub 仓库https://github.com/obra/superpowersClaude Code 开发辅助https://github.com/obra/superpowers-developing-for-claude-code实验技能实验室https://github.com/obra/superpowers-labSuperpowers 市场https://github.com/obra/superpowers-marketplace附录 B网络教程与文章gstack 教程与文章标题URL说明GStack Tutorial: Garry Tan’s Claude Code Workflow (SitePoint)https://www.sitepoint.com/gstack-garry-tan-claude-code/完整入门教程Installing Garry Tan’s Claude Code Setup in One Click (SitePoint)https://www.sitepoint.com/gstack-claude-code-setup/安装指南GStack: Turn Claude Code Into a Full Engineering Team (dev.to)https://dev.to/max_quimby/gstack-turn-claude-code-into-a-full-engineering-team-1c7e概述及使用What Is gstack? This Will Change How You Code Forever (Apidog)https://apidog.com/blog/gstack/介绍与教程用 gstack 把 AI 编程变成一支工程团队 (CSDN)https://blog.csdn.net/liuzhupeng/article/details/160989410中文教程我用 gstack skill 把 Claude Code 变成了专属后端助手 (腾讯云)https://cloud.tencent.com.cn/developer/article/2649498中文实践教程YC CEO Garry Tan 带你一人抵一个团队 (dtzed)https://dtzed.com/institute/2026/04/18066/中文深度教程AI coding 效率暴增 10 倍 (什么值得买)https://post.smzdm.com/p/aggnl29d/中文实践分享gstack Skill on SkillsMPhttps://skillsmp.com/skills/garrytan-gstack-learn-skill-md技能索引gstack on explainx.aihttps://explainx.ai/skills/garrytan/gstack/gstack技能解析Superpowers 教程与文章标题URL说明Superpowers Skill 全面技术教程 (知乎)https://zhuanlan.zhihu.com/p/2030628504719639855中文完整技术教程相关工具与资源标题URL说明opengstack (npm)https://www.npmjs.com/package/opengstackgstack 无遥测分支Superskillshttps://github.com/ariadoss/superskillsgstack 33 社区技能合集Awesome Claude Code Workflowshttps://github.com/ithiria894/awesome-claude-code-workflows工作流精选合集Claude Code Skills Marketplacehttps://skillsmp.com/第三方技能市场