gstack 极简使用手册（Claude Code 虚拟工程团队）

gstack 是将 Claude Code 转化为虚拟工程团队的开源工具集，内置 23 个专家角色、8 个效率工具，支持多 AI 编程助手，全程通过斜杠命令执行。

一、环境依赖

• Claude Code
• Git
• Bun ≥1.0
• Windows 额外需：Node.js

二、一键安装（30 秒）

1. 标准安装（推荐）

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

2. 团队模式（自动更新，共享仓库）

cd ~/.claude/skills/gstack
./setup --team

# 项目初始化
cd <你的项目目录>
~/.claude/skills/gstack/bin/gstack-team-init required
git add .claude/ CLAUDE.md
git commit -m "feat: require gstack for AI-assisted work"

3. 贡献模式（完整 Git 历史）

git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack
cd ~/.claude/skills/gstack
./setup

4. 适配其他 AI 助手

git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack
./setup --host <codex/opencode/cursor/factory/slate/kiro>

三、CLAUDE.md 必须配置

在项目 CLAUDE.md 中添加以下内容，确保 Claude 识别技能：

## gstack
Use /browse from gstack for all web browsing. Never use mcp__claude-in-chrome__* tools.
Available skills: /office-hours, /plan-ceo-review, /plan-eng-review, /plan-design-review, /design-consultation, /design-shotgun, /design-html, /review, /ship, /land-and-deploy, /canary, /benchmark, /browse, /open-gstack-browser, /qa, /qa-only, /design-review, /setup-browser-cookies, /setup-deploy, /retro, /investigate, /document-release, /codex, /cso, /autoplan, /pair-agent, /careful, /freeze, /guard, /unfreeze, /gstack-upgrade, /learn.

四、核心技能速查（按研发流程）

1. 思考 → 规划

技能	角色	作用
/office-hours	产品顾问	6 个问题重构产品方向，输出设计文档
/plan-ceo-review	CEO	4 种模式校验产品范围
/plan-eng-review	工程经理	架构、数据流、边界用例
/plan-design-review	资深设计师	设计维度评分，AI 劣质代码检测
/plan-devex-review	DX 负责人	开发者体验评审
/autoplan	自动评审流水线	一键执行 CEO→设计→工程→DX 全流程评审

2. 构建 → 设计

技能	角色	作用
/design-consultation	设计伙伴	从零搭建设计系统
/design-shotgun	设计探索者	生成 4-6 种设计稿，浏览器对比
/design-html	设计工程师	高保真转生产级 HTML/CSS，无依赖、自适应

3. 评审 → 测试

技能	角色	作用
/review	资深工程师	代码审查，自动修复明显问题
/design-review	编码设计师	设计审计并自动修复
/devex-review	DX 测试	实测开发者体验，对比规划
/investigate	调试专家	根因排查，无调查不修复
/qa	QA 负责人	打开真实浏览器测试，自动修复并生成回归用例
/qa-only	QA 报告员	仅输出 Bug 报告，不修改代码
/cso	安全官	OWASP+STRIDE 威胁建模，安全审计
/benchmark	性能工程师	基准性能、Core Web Vitals 对比

4. 发布 → 复盘

技能	角色	作用
/ship	发布工程师	同步主干、运行测试、推送并提 PR
/land-and-deploy	部署工程师	合并 PR、等待 CI、验证生产
/canary	SRE	发布后监控，错误与性能巡检
/document-release	技术文档	自动更新项目文档
/retro	工程经理	周度工程复盘，支持全局统计
/learn	记忆管理	管理项目偏好与模式，跨会话积累

5. 浏览器与协作

技能	作用
/browse	真实 Chromium 浏览、点击、截图
/open-gstack-browser	启动专属 AI 浏览器，反爬虫 stealth
/setup-browser-cookies	导入本地浏览器 Cookie，测试登录态
/pair-agent	跨 AI 助手共享浏览器，标签隔离

6. 安全与效率工具

技能	作用
/careful	危险操作前告警
/freeze	锁定编辑目录，防止越权修改
/guard	/careful + /freeze 组合防护
/unfreeze	解除编辑锁定
/gstack-upgrade	一键升级到最新版
/codex	OpenAI Codex 交叉代码评审
/setup-deploy	一键配置部署环境

五、标准研发流程（8 步闭环）

1. /office-hours：明确产品需求
2. /plan-ceo-review：战略评审
3. /autoplan：自动全维度规划
4. 实现功能
5. /review：代码审查
6. /qa <测试地址>：浏览器自动化测试
7. /ship：提交并推送
8. /land-and-deploy：合并部署

六、卸载方式

1. 脚本卸载

~/.claude/skills/gstack/bin/gstack-uninstall

2. 手动卸载

pkill -f "gstack.*browse" 2>/dev/null
find ~/.claude/skills -maxdepth 1 -type l -delete 2>/dev/null
rm -rf ~/.claude/skills/gstack ~/.gstack
rm -rf ~/.codex/~/.factory/~/.kiro/~/.openclaw/skills/gstack*
rm -f /tmp/gstack-*

最后删除项目 CLAUDE.md 中 gstack 相关段落。

七、常见问题

• 技能不显示：cd ~/.claude/skills/gstack && ./setup
• /browse 失败：bun install && bun run build
• 命令前缀切换：./setup --prefix（/gstack-qa）/--no-prefix（/qa）