把 Claude
Code 包装成一支
工程团队

gstack
是什么

gstack 是 Garry Tan(YC 总裁兼 CEO)开源的一套 Claude Code 增强技能集合, 本质是把 Claude Code 包装成一个虚拟工程团队 —— 七个角色各管一摊,全部通过斜杠命令调用。

七个虚拟角色

快速
安装

前置依赖

30 秒安装

在 Claude Code 里粘贴以下指令:

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

setup 会自动:

• 检测已安装的 AI 编码工具
• 编译 browse / design / make-pdf 等模块
• 在 CLAUDE.md 添加 gstack 区域,告诉 Claude 使用 /browse 而非 mcp__claude-in-chrome__* 工具

团队模式(推荐)

如果是仓库协作者,建议启用 team mode —— 全员自动更新,无需手动升级:

(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:强制要求协作者使用 gstack
• optional:仅提示,不阻塞

其他 AI 编码工具

setup 自动检测已安装的工具。如需手动指定主机:

./setup --host codex      # OpenAI Codex CLI   → ~/.codex/skills/gstack-*/
./setup --host opencode   # OpenCode           → ~/.config/opencode/skills/gstack-*/
./setup --host cursor     # Cursor             → ~/.cursor/skills/gstack-*/
./setup --host factory    # Factory Droid      → ~/.factory/skills/gstack-*/
./setup --host slate      # Slate              → ~/.slate/skills/gstack-*/
./setup --host kiro       # Kiro               → ~/.kiro/skills/gstack-*/
./setup --host hermes     # Hermes             → ~/.hermes/skills/gstack-*/
./setup --host gbrain     # GBrain mod         → ~/.gbrain/skills/gstack-*/

新增主机支持:见 docs/ADDING_A_HOST.md,只需一个 TypeScript 配置文件即可。

5 分钟
上手流程

从模糊想法到生产环境,完整链条:

6 步入门(README 推荐路径)

1. /office-hours — 描述你在做什么
2. /plan-ceo-review — 给任何功能想法跑一遍
3. /review — 给任何有改动的分支跑一遍
4. /qa — 给 staging URL 跑一遍
5. 停在这里 — 你就知道这工具适不适合你

技能全表

按职能分组,标注触发场景。共 30+ 个技能。

规划与产品

设计与前端

工程与质量

多人协作 / 远程

安全与合规

发布与运维

文档

记忆与学习

iOS 开发

端到端走查见 docs/howto-ios-testing-with-gstack.md。

安全与防御

上下文与工具

知识库

元工具

/browse
浏览器命令

/browse 是 gstack 的核心基础设施,所有需要"眼睛"的功能(/qa、/design-review、/canary、/benchmark)都基于它。每个命令响应时间 ~100ms。

常用命令

完整列表 76 个,见 browse/SKILL.md。

OpenClaw
多 Agent 集成

gstack 通过 OpenClaw 派发 Claude Code 会话时所有 gstack 技能都直接生效。给 OpenClaw agent 粘贴:

Install gstack: run `git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup` to install gstack for Claude Code. Then add a "Coding Tasks" section to AGENTS.md that says: when spawning Claude Code sessions for coding work, tell the session to use gstack skills. Include these examples:
- security audit: "Load gstack. Run /cso"
- code review: "Load gstack. Run /review"
- QA test a URL: "Load gstack. Run /qa https://..."
- build a feature end-to-end: "Load gstack. Run /autoplan, implement the plan, then run /ship"
- plan before building: "Load gstack. Run /office-hours then /autoplan. Save the plan, don't implement."

派发表

4 个原生 OpenClaw 技能

无需 Claude Code 会话,直接聊。从 ClawHub 安装:

clawhub install gstack-openclaw-office-hours gstack-openclaw-ceo-review \
              gstack-openclaw-investigate gstack-openclaw-retro

详细路由见 docs/OPENCLAW.md。

配置与状态

主要配置

# 启用自动升级
~/.claude/skills/gstack/bin/gstack-config set auto_upgrade true

# 禁用升级检查
~/.claude/skills/gstack/bin/gstack-config set update_check false

# 启用团队模式
~/.claude/skills/gstack/bin/gstack-config set team_mode true

# 读当前值
~/.claude/skills/gstack/bin/gstack-config get auto_upgrade

状态目录

• ~/.gstack/ — gstack 全局状态(配置、缓存、升级标记)
• ~/.gstack/just-upgraded-from — 上次升级前版本
• ~/.gstack/update-snoozed — 升级提醒的暂停状态(24h → 48h → 1 周渐进)
• ~/.gstack/projects/<repo>/ — 项目级记忆、CEO plans、specs 等

升级提醒机制

每次会话开始检查更新(节流到 1 次/小时,网络失败静默):

1. 检测到 UPGRADE_AVAILABLE <old> <new> → 弹 4 选 1:Yes, upgrade now / Always keep me up to date / Not now / Never ask again
2. Not now 用渐进退避:第一次 24h,第二次 48h,第三次及以上 1 周
3. Always keep me up to date 设置 auto_upgrade: true,后续自动升级
4. Never ask again 设置 update_check: false,彻底关停

安装类型检测

/gstack-upgrade 自动识别:

team mode 开启时,本地 vendored 副本会被移除,使用全局安装作为唯一信源。

升级

# 命令方式
/gstack-upgrade

# 手动
cd ~/.claude/skills/gstack
git fetch origin
git reset --hard origin/main
./setup

升级后自动运行 gstack-upgrade/migrations/ 下的版本迁移脚本(命名 v{VERSION}.sh), 只在新版本比旧版本新时执行。迁移是幂等的,失败也不阻塞升级。

升级完成会写 ~/.gstack/just-upgraded-from,清除升级检查缓存,展示"What's New"摘要(基于 CHANGELOG.md)。

工作流速查

新功能从 0 到生产

/office-hours → /plan-ceo-review → /plan-eng-review → /plan-design-review → /autoplan → [写代码] → /review → /qa → /ship → /land-and-deploy → /canary

Bug 修复

/investigate(根因分析,不修只查)→ [修代码] → /qa → /ship

设计改进

/plan-devex-review(DX 视角)→ /design-shotgun(多方案)→ /design-html(实现)→ /design-review(验证)

安全审计

/cso(OWASP + STRIDE)→ [修漏洞] → /ship

文档更新

/document-release(检过期)→ /document-generate(补缺)→ /ship

跨会话恢复工作

/context-save → [新会话] → /context-restore

让 Claude 学会你的项目

/setup-gbrain(装脑)→ /sync-gbrain(索引代码)→ /learn(管理知识)→ /retro(周回顾)

最佳实践

1. 先 /office-hours 再写代码 — 重新框定问题比写代码重要
2. /plan-* 三件套都跑一遍 — CEO、Eng、Design 各管一摊,组合起来最稳
3. /review 在 /ship 前必跑 — CI 抓不到的东西它能抓
4. /qa 跑 staging URL,不要跑生产 — 数据安全和稳定性
5. /canary 部署后挂着 — 第一时间发现线上问题
6. iOS 工作用 /ios-qa --tailnet — 远程 agent 不碰硬件也能测
7. 大改动前 /freeze 或 /guard — 防止误改范围外
8. 危险命令前说"be careful"激活 /careful — 多一道确认
9. 每周跑 /retro — 看团队和个人趋势
10. 升级用 /gstack-upgrade 或自动升级 — 跟踪 token 优化、新技能、新测试

故障排查

详细排错见各技能的 SKILL.md 和 docs/ 目录下的 22 篇文档(Diataxis 框架分类)。

资源与社区

版本说明

• 当前安装:v1.56.0.0(2026-06-03)
• 从 v1.55.1.0 升级
• v1.56.0.0 重大变化:
  • 5 个重型技能(/plan-ceo-review、/office-hours、/plan-eng-review、/plan-design-review、/plan-devex-review)改为按需加载 skeleton + sections,token 占用降低 25-49%
  • 共享 AskUserQuestion 前导瘦身,跨所有交互技能减重
  • 新增 4 个 paranoid 测试套件,保证对话引导质量不退化
  • 外部主机(Codex/Factory/Kiro/OpenCode)仍收完整内联技能,无行为变化