第一章 认识 gstack

1.1 什么是 gstack

gstack 是 Garry Tan（YC CEO）开发的开源项目，本质上是一套 Claude Code 的 AI 技能包集合。它把 Claude Code 从一个空白的 AI 编码助手，变成拥有 30+ 专业技能的虚拟工程团队。

你可以把 gstack 想象成 Claude Code 的「操作系统」——安装后，Claude Code 就拥有了产品经理、技术负责人、QA 工程师、SRE、安全审计员等不同角色的能力。

1.2 能干什么

1.3 核心优势

• YC 方法论：skill 本身就是对顶尖公司工程流程的封装
• 非侵入式：不修改 Claude Code 本身，只是加载 skill 文件
• 极低安装成本：一行命令 30 秒安装完成
• 团队协作：支持团队模式，统一 AI 工作规范

第二章 快速上手（5分钟）

2.1 一行命令安装

在 Claude Code 的终端中，直接粘贴以下命令：

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

安装脚本会自动完成：Bun 依赖安装、技能文件注册、以及 Playwright 浏览器二进制下载（用于 /browse 技能）。

2.2 运行第一个技能

安装完成后，在项目目录中启动 Claude Code，然后输入：

/office-hours "帮我梳理当前产品的核心思路"

gstack 会自动分析你的项目结构，生成一份专业的 README 文档。

2.3 三个必做检查

# 检查 1：技能列表是否加载
/skills

#检查 2：查看 gstack 版本
cd ~/.claude/skills/gstack && git log --oneline -1

#检查 3：尝试一个简单的规划技能
/office-hours "我想做一个待办事项管理工具"

💡 提示：如果 /skills 没有显示 gstack 的技能列表，请确认你在 gstack 的根目录下启动的 Claude Code，或者检查 ~/.claude/skills/gstack/ 目录是否存在。

第三章 安装 Claude Code + Bun

3.1 安装 Claude Code

gstack 的所有技能都运行在 Claude Code 之上。如果你还没有安装 Claude Code：

# 使用 npm 全局安装
npm install -g @anthropic-ai/claude-code

#验证安装
claude --version

#首次启动需要登录
claude

首次启动 Claude Code 时，会要求你通过 Anthropic Console 登录授权。登录完成后即可正常使用。

3.2 安装 Git

macOS：预装，不需要额外操作。

Linux (Ubuntu/Debian)：

sudo apt update && sudo apt install git -y

Windows：推荐通过 Git for Windows 安装，或使用 WSL2。

3.3 验证环境

# 验证所有依赖
git --version
node --version
npm --version

⚠️ Bun 需要提前手动安装，./setup 不会自动安装

第四章 gstack 安装与配置

4.1 标准安装

标准安装命令：

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

4.2 团队模式

如果你是一个团队的管理者，想统一团队成员的 AI 工作流程：

# 在项目仓库内执行
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"

团队模式下，所有成员在项目中启动 Claude Code 时都会自动加载 gstack 技能。

4.3 支持其他 AI Agent

gstack 不仅支持 Claude Code，还支持 10 种不同的 AI 编码 Agent：

# 示例：为 Codex CLI 安装 gstack
./setup --host codex

4.4 项目 CLAUDE.md 配置

为了让 gstack 在特定项目中生效，需要在项目根目录的 CLAUDE.md（或 CLAUDE.md）中添加：

# AI 工作流
请始终在 ~/.claude/skills/gstack 目录下使用 gstack 工具集。
使用 /browse skill 进行所有网页浏览。

4.5 升级 gstack

# 在 Claude Code 中执行
/gstack-upgrade

这个命令会自动检测全局和本地安装，同步更新到最新版本。

第五章 核心技能详解

5.1 规划类技能（Think + Plan）

/office-hours — YC 风格的产品讨论

这是 Garry Tan 亲自设计的 6 个强迫性问题，帮助你重新思考产品方向：

/office-hours "我想做一个给独立开发者用的部署工具"

它会从 6 个维度挑战你的假设，帮你找到「10 星产品」藏在需求里的关键。

/autoplan — 一键全流程规划

自动执行 CEO→设计→工程→DX 四轮评审，一次性生成完整的产品规划文档：

/autoplan "从零开始构建一个待办事项应用"

/plan-ceo-review — CEO 评审

四种模式（扩展/选择性扩展/保持/缩减），帮助判断这个功能值不值得做。

/plan-eng-review — 技术负责人评审

锁定架构、数据流、图表、边界情况、测试计划。

/plan-design-review — 设计评审

给每个设计维度打分 0-10，说明 10 分是什么样子，交互式提问。

/plan-devex-review — 开发者体验评审

TTHW（初次上手时间）、神奇时刻、摩擦点、Persona 追踪。

/design-consultation — 设计咨询

从零建立完整设计系统，研究市场趋势，给出创意风险建议。

5.2 实现+评审类（Build + Review）

/review — Staff Engineer 评审

找到能通过 CI 但在生产环境会出问题的 bug，自动修复简单问题：

# 审查当前分支的所有改动
/review

/codex — 第二意见

通过 OpenAI Codex 做独立评审，有审查、挑战、咨询三种模式：

/codex "审查 auth.ts 文件的安全性"

/investigate — 系统化调试

根因分析，铁律：不调查就不能修。

/design-review — 现场视觉审计+修复

80 项检查清单，原子提交，前后对比截图。

/design-shotgun — 设计探索

生成 4-6 个 AI 设计变体，浏览器中对比迭代。

/design-html — 设计工程

将设计转成生产级 HTML，30KB，零依赖。

/scrape — 网页数据提取

首次调用原型化，后续调用约 200ms 完成。

5.3 发布+部署类（Release + Deploy）

/ship — 发布工程师

运行测试、评审、推送、开 PR，一行命令搞定：

/ship

/land-and-deploy — 合并+部署

合并 PR、等待 CI、部署、验证生产环境健康。

/canary — SRE 金丝雀监控

部署后监控循环，检查控制台错误、性能退化、页面失败。

/landing-report — Ship 队列仪表盘

只读展示版本队列状态。

5.4 浏览器+Agent 集成

/browse — 无头浏览器

真正的 Chromium、真正的点击、约 100ms/命令：

/browse "打开 https://example.com，截图主页"

/open-gstack-browser — 可见浏览器窗口

带侧边栏、反机器人隐身、自动模型路由。

/pair-agent — 远程 Agent 桥接

将 OpenClaw/Codex/Cursor 等 Agent 与浏览器配对。

5.5 安全+记忆类

/careful — 安全保护

对 rm -rf/DROP TABLE/force-push 等破坏性操作发出警告。

/freeze — 编辑锁定

限制文件编辑到单个目录。

/guard — 全保护

/careful + /freeze 合并。

/learn — 跨会话记忆管理

查看、搜索、修剪、导出学到的模式。

/retro — 周回顾

按人统计、Shipping 连续记录、测试健康趋势。

/context-save / context-restore — 上下文管理

保存 git 状态、决策、待办事项，支持跨工作空间恢复。

第六章 实战流程

6.1 产品构思阶段

/office-hours "我想做一个 AI 驱动的代码审查工具"

经过 6 个强迫性问题的讨论后，你会获得一份清晰的产品定位文档。

6.2 完整规划

/autoplan "用 Next.js + Tailwind 实现待办事项应用"

自动生成：CEO 评审稿、技术架构方案、设计稿、DX 评审。你可以逐一审核每个步骤。

6.3 实现

按照 /autoplan 生成的计划，让 Claude Code 逐步实现。每完成一个功能，用 /review 检查：

/review

6.4 质量保障

# QA 测试
/qa

#纯 QA 报告（不改代码）
/qa-only

#安全审计
/cso

6.5 发布上线

# 一站式发布
/ship

6.6 生产监控

# 部署后金丝雀监控
/canary "https://myapp.com"

第七章 OpenClaw 集成

7.1 什么是 OpenClaw

OpenClaw 是一个 orchestrator（编排器），通过 ACP 协议 spawn Claude Code 会话，管理消息、日历、记忆等。gstack 和 OpenClaw 是互补关系：OpenClaw 决定「谁去干活」，gstack 决定「怎么干活」。

7.2 原生 OpenClaw 技能

OpenClaw 通过 ClawHub 提供了 4 个原生 gstack 对话技能：

• /office-hours — YC 产品讨论
• /ceo-review — CEO 评审
• /investigate — 系统化调试
• /retro — 周回顾

7.3 Dispatch Routing

OpenClaw 可以根据任务复杂度自动选择 gstack 支持等级：

7.4 交叉使用优势

如果你同时安装了 OpenClaw 和 Claude Code 的 gstack，工作流可以这样打通：

• OpenClaw 管理多 Agent 会话和上下文
• gstack 为每个 Agent 提供专业的技能包
• /pair-agent 让不同 Agent 共享同一个浏览器实例
• 一个项目内，gstack 的 /context-save 和 /context-restore 可以在不同 Agent 间传递状态

第八章 常见问题与排错

8.1 安装失败

Q：./setup 报错「Bun not found」

A：说明系统没有安装 Bun。手动安装：

# macOS / Linux
curl -fsSL https://bun.sh/install | bash

然后重新运行 ./setup

Q：git clone 速度太慢或失败

A：使用 shallow clone 可以大幅加速：

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

8.2 技能加载问题

Q：安装成功后 /skills 看不到 gstack 技能

A：可能的原因：

1. 没有在 gstack 目录下启动 Claude Code — 需要 cd ~/.claude/skills/gstack
2. CLAUDE.md 没有配置 — 确认项目中有 CLAUDE.md
3. 技能目录权限问题 — 检查 ~/.claude/skills/gstack/ 目录的可读性

Q：/office-hours 或 /review 显示「not found」

A：确认 gstack 版本是最新的：

/gstack-upgrade

8.3 浏览器技能问题

Q：/browse 报错「Browser binary not found」

A：./setup 时 Playwright 浏览器下载失败。手动安装：

cd ~/.claude/skills/gstack
npx playwright install chromium

Q：/browse 打开页面显示空白

A：可能被网站的反爬机制拦截。尝试用 /open-gstack-browser（可见浏览器模式），它有反机器人隐身功能。

8.4 网络问题

Q：安装时无法下载 Bun（国内网络）

A：使用国内镜像：

# 使用国内 Bun 镜像
curl -fsSL https://bun.sh/install | bash -s -- -m https://bun-oss.oss-cn-hangzhou.aliyuncs.com

Q：/browse 访问某些网站超时

A：可以尝试配置代理环境变量：

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

8.5 权限问题

Q：/careful 总是阻止合法操作

A：使用 /unfreeze 解锁：

/unfreeze

Q：团队模式下 /freeze 限制太严格

A：在 CLAUDE.md 中配置白名单目录。

8.6 Windows 兼容性

Q：Windows 上 ./setup 报错

A：Windows 上仅支持 curated Windows-safe 子集，setup 需要使用 Git Bash 或 MSYS。原生 PowerShell 支持尚未完成。

# 推荐做法：用 WSL2
wsl --install -d Ubuntu
然后在 WSL2 中执行安装命令

8.7 OpenClaw 集成问题

Q：OpenClaw 中无法使用 gstack 技能

A：确认已经通过 ClawHub 安装了 Native OpenClaw Skills，并且 AGENTS.md 中正确配置了 gstack 路径。

8.8 升级问题

Q：/gstack-upgrade 报 git 冲突

A：手动解决冲突或重新克隆：

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

附录：技能速查表

规划类

实现+评审类

发布+部署类

浏览器类

安全+记忆类