gstack - AI 虚拟工程团队

YC CEO Garry Tan 开源的 Claude Code 工作流工具包，20+ 个专家角色覆盖从构思到发布的全流程，支持 10+ AI 编码工具。

项目地址：https://github.com/garrytan/gstack ｜ MIT 开源协议 ｜ ⭐ 103K+ Stars

这是什么

gstack 是 Y Combinator CEO Garry Tan 开源的 Claude Code 工作流工具包。它把 Claude Code 变成一支虚拟工程团队——CEO、设计师、工程经理、Release Engineer、文档工程师、QA、安全官，全部通过斜杠命令调用。

Garry Tan 用这套工具在 60 天内发布了 3 个生产服务、40+ 功能，同时全职管理 YC。他的 2026 年代码产出速度是 2013 年的 810 倍（按逻辑代码行计）。

"AI wrote most of it. The point isn't who typed it, it's what shipped." — Garry Tan

核心理念

整个工作流遵循一个 Sprint 周期：

Think → Plan → Build → Review → Test → Ship → Reflect

每个技能自动衔接下一个：

  • /office-hours 输出设计文档 → /plan-ceo-review 读取并挑战
  • /plan-eng-review 输出测试计划 → /qa 拾取执行
  • /review 发现的 bug → /ship 验证是否修复

没有什么会遗漏，因为每一步都知道前面发生了什么。

适用人群

  • 创始人和技术 CEO —— 想要继续出货的技术领导者
  • Claude Code 新手 —— 需要结构化角色引导而非空白提示框
  • Tech Lead 和 Staff Engineer —— 每个 PR 都需要严格 Review、QA 和发布自动化

命令速查：选哪条？

20+ 条命令乍看很多，但你的项目只需要其中几条。按你要做的事情选：

你在做什么规划阶段（写代码前）上线后审计
面向用户的产品（UI、Web App、移动端）/plan-design-review/design-review
面向开发者（API、CLI、SDK、文档）/plan-devex-review/devex-review
架构类（数据流、性能、测试）/plan-eng-review/review
以上都要/autoplan（自动跑 CEO → 设计 → 工程，智能检测适用哪些）—
安全审计—/cso
从零探索想法/office-hours—
iOS 应用测试—/ios-qa

不确定？跑 /office-hours，它会帮你理清楚该走哪条路线。

安装（30 秒）

前置条件

一键安装

在 Claude Code 中粘贴以下命令：

git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup

Claude 会自动完成配置，并在 CLAUDE.md 中添加 gstack 技能列表。

团队模式（推荐共享仓库）

让团队成员在打开仓库时自动获得 gstack：

(cd ~/.claude/skills/gstack && ./setup --team) && \
  ~/.claude/skills/gstack/bin/gstack-team-init required && \
  git add .claude/ CLAUDE.md && \
  git commit -m "require gstack for AI-assisted work"

required 改为 optional 则只是建议而非强制。

多 AI 工具支持

gstack 不只支持 Claude Code，兼容 10+ AI 编码工具：

./setup --host codex      # OpenAI Codex CLI
./setup --host cursor     # Cursor
./setup --host opencode   # OpenCode
./setup --host kiro       # Kiro
./setup --host hermes     # Hermes
./setup --host factory    # Factory Droid
./setup --host slate      # Slate
./setup --host gbrain     # GBrain (mod)

OpenClaw 集成

OpenClaw 通过 ACP 启动 Claude Code session，gstack 技能自动可用。自然语言对话即可触发：

你说发生什么
"Fix the typo in README"简单任务，不需要 gstack
"Run a security audit"启动 Claude Code + /cso
"Build a notifications feature"/autoplan → 实现 → /ship
"Help me plan the v2 API redesign"/office-hours → /autoplan，保存计划

Windows 注意事项

gstack 在 Windows 11 上通过 Git Bash 或 WSL 工作。需要同时安装 bun 和 node。没有 Developer Mode 时，setup 会回退到文件复制（而非 symlink），每次 git pull 后需重新运行 ./setup。

全部命令一览

产品与规划（Think → Plan）

命令角色说明
/office-hoursYC Office Hours六个逼问问题重新定义你的产品，输出设计文档喂给下游技能
/plan-ceo-reviewCEO / Founder用 CEO 视角挑战范围，四种模式：扩展、选择性扩展、保持、缩减
/plan-eng-review工程经理锁定架构，输出数据流图、状态机、错误路径、测试矩阵
/plan-design-review高级设计师给每个设计维度打 0-10 分，解释 10 分长什么样，交互式确认每个设计选择
/plan-devex-reviewDX 负责人探索开发者人设、对标竞品 TTHW、追踪摩擦点，20-45 个逼问问题
/design-consultation设计合作伙伴从零构建设计系统，研究行业现状，提出创意风险，生成视觉样稿
/autoplan自动规划流水线一条命令自动跑完 CEO → 设计 → 工程审查，只把品味决策暴露给你

构建（Build）

命令角色说明
/design-shotgun设计探索器生成 4-6 个 AI 模型变体，浏览器对比板选偏好。品味记忆（gstack-taste-update）会自动记录你的选择，下次生成时偏向你偏好的风格
/design-html设计工程师把设计稿变成可发布的 HTML/CSS，自动检测框架（React/Svelte/Vue），输出零依赖、可自适应布局
/spec规格说明把模糊意图变成精确可执行规格，五阶段流程，Codex 质量门控（低于 7/10 阻止写入）

审查（Review）

命令角色说明
/reviewStaff Engineer找到通过 CI 但在生产炸掉的 bug，自动修复明显问题
/design-review设计师同 /plan-design-review 的审计 + 自动修复，原子提交，保留前后截图
/devex-reviewDX 测试实际测试开发者体验：走文档、计时 TTHW、截图错误，对比计划评分
/codex第二意见调用 OpenAI Codex 做独立审查，三种模式：审查/对抗挑战/开放咨询
/cso首席安全官OWASP Top 10 + STRIDE 威胁建模，每个发现含具体漏洞利用场景

测试（Test）

命令角色说明
/qaQA 负责人打开真实 Chromium 浏览器测试应用，找到并修复 bug，自动生成回归测试
/qa-onlyQA 报告员同 /qa 方法论，但只报告不修改
/benchmark性能工程师基线页面加载、Core Web Vitals、资源大小，PR 前后对比
/investigate调试器系统化根因调试，铁律：没有调查就不修，3 次修复失败后停止

发布（Ship）

命令角色说明
/shipRelease Engineer同步 main → 跑测试 → 审计覆盖率 → 推送 → 开 PR。没有测试框架会自动搭建
/land-and-deploy发布工程师合并 PR → 等 CI → 部署 → 验证生产健康
/canarySRE部署后监控循环：控制台错误、性能退化、页面故障

文档与复盘（Reflect）

命令角色说明
/document-release技术文档工程师更新所有文档匹配刚发布的内容，构建 Diataxis 覆盖图
/document-generate文档作者从零生成缺失文档，使用 Diataxis 框架
/retro工程经理周报复盘，按人分拆。/retro global 跨所有项目和 AI 工具
/learn记忆管理跨 session 学到的模式、陷阱和偏好

浏览器与多代理

命令角色说明
/browseQA 工程师给 AI 一双眼睛——真实 Chromium、真实点击、真实截图，约 100ms/命令。这是基础能力
/open-gstack-browserGStack Browser/browse 的增强版：带侧边栏 AI 助手、反机器人隐身、自动模型路由（Sonnet 操作/Opus 分析）。日常用这个
/setup-browser-cookies会话管理器从 Chrome/Arc/Brave/Edge 导入 Cookie，测试需登录的页面
/pair-agent多代理协调器与任意 AI 代理共享浏览器，每个代理独立标签页，ngrok 自动建隧道

安全护栏

命令说明
/careful说"be careful"激活，破坏性命令前警告
/freeze限制编辑到一个目录，调试时防误改
/guard/careful + /freeze 同时激活，生产环境最高安全
/unfreeze解除 /freeze

iOS 开发

命令说明
/ios-qa通过 USB CoreDevice 驱动真实 iPhone 测试，支持 tailnet 远程代理
/ios-fixiOS bug 修复循环
/ios-design-reviewHIG 合规审计
/ios-clean调试桥清理
/ios-sync访问器重新同步

配置与维护

命令说明
/setup-deploy/land-and-deploy 的一次性部署配置
/setup-gbrain5 分钟从零运行 GBrain（持久化知识库），支持 PGLite/Supabase/远程 MCP
/sync-gbrain重新索引当前仓库到 GBrain
/gstack-upgrade自更新到最新版本
/context-restore从 WIP 检查点提交中恢复 session 状态（配合持续检查点模式使用）
/connect-chrome连接到真实 Chrome 实例进行浏览操作

独立 CLI 工具

gstack 还附带独立命令行工具：

命令用途
gstack-model-benchmark跨模型基准测试（Claude / GPT / Gemini），对比延迟、token、成本和质量评分
gstack-taste-update设计品味学习，将 /design-shotgun 的选择写入持久化品味档案（~/.gstack/），自动衰减 5%/周
gstack-ios-qa-daemoniOS QA 守护进程，通过 USB CoreDevice 驱动真实 iPhone
gstack-ios-qa-mintiOS 允许列表管理器（grant/revoke/list）

典型工作流

你：/office-hours
Claude：[6 个逼问问题，发现你描述的不是"日报 app"而是"AI 幕僚长"，输出设计文档]

你：/autoplan
Claude：[自动跑完 CEO → 设计 → 工程审查，输出完整计划]

你：批准计划，开始实现
Claude：[写 2,400 行代码，11 个文件，约 8 分钟]

你：/review
Claude：[自动修复 2 个问题，标记 1 个竞态条件需要确认]

你：/qa https://staging.myapp.com
Claude：[打开真实浏览器测试，找到并修复 1 个 bug]

你：/ship
Claude：[测试 42→51（+9），PR 已创建]

并行 Sprint

gstack 一个 sprint 就很强。10 个并行跑才是真正的飞跃。

通过 Conductor 同时运行多个 Claude Code session：

  • Session A：/office-hours 探索新想法
  • Session B：/review 审查 PR
  • Session C：实现功能
  • Session D：/qa 测试 staging
  • 其他 Session：其他分支

为什么能并行？ 因为有流程。没有流程的 10 个代理是 10 个混乱源。有了 Think → Plan → Build → Review → Test → Ship → Reflect，每个代理都知道该做什么、什么时候停。你像 CEO 一样管理它们：盯住重要决策，其余让它跑。

持续检查点模式（可选）

开启后，gstack 会自动把工作进度以 WIP: 前缀提交到 Git，每次提交附带结构化的上下文信息（决策、剩余工作、失败的尝试）。session 崩溃或中断后：

# 开启持续检查点
gstack-config set checkpoint_mode continuous

# session 恢复时，从检查点重建状态
/context-restore

# /ship 会自动压缩 WIP 提交，保持 git 历史干净

推送是可选的（checkpoint_push=true），默认只本地保存，不会触发 CI。

GBrain —— 代理的持久记忆

GBrain 是 AI 代理的持久化知识库——相当于代理在 session 之间真正保留的记忆。详细设置和每个标志的说明见 USING_GBRAIN_WITH_GSTACK.md。

常用配置

gstack-config set telemetry off          # 关闭遥测
gstack-config set auto_upgrade: true     # 自动更新
gstack-config set checkpoint_mode continuous  # 持续检查点（见上文）

# 去掉 /gstack- 前缀（从 /gstack-qa 变成 /qa）
cd ~/.claude/skills/gstack && ./setup --no-prefix

常见问题

问题解决
技能没有出现cd ~/.claude/skills/gstack && ./setup
/browse 失败cd ~/.claude/skills/gstack && bun install && bun run build
版本过旧运行 /gstack-upgrade
Claude 说看不到技能确认 CLAUDE.md 中有 gstack 配置段
Codex 报错 "invalid SKILL.md"cd ~/.codex/skills/gstack && git pull && ./setup --host codex

卸载

# 方式一：运行卸载脚本
~/.claude/skills/gstack/bin/gstack-uninstall

# 保留配置和分析数据
~/.claude/skills/gstack/bin/gstack-uninstall --keep-state

卸载后记得手动清理每个项目 CLAUDE.md 中的 ## gstack 段。

参考资源