用途
gstack Workflow Assistant 是一套面向 Claude Code 的专业化 AI 工作流技能集合。它的目标是把 Claude Code 从通用助手转变为可按需召唤的专家团队,通过八个有明确立场的工作流技能,分别扮演 CEO、工程经理、发布经理和 QA 工程师角色,覆盖规划、评审、发布和测试等环节。
主要能力
- CEO 评审:重新思考问题,找出请求背后隐藏的“10 星产品”机会。
- 工程规划:锁定架构、数据流和边界情况。
- 代码评审:偏执的资深工程师级别审查,捕捉生产环境缺陷。
- 发布管理:一条命令完成发布,包含测试与 PR 创建。
- QA 测试:带截图和系统化覆盖的自动化浏览器测试。
- 浏览器自动化:让 AI 拥有“眼睛”,点击浏览应用并发现故障。
- 会话管理:导入真实浏览器 Cookie,用于需登录的测试。
- 团队回顾:工程经理风格的复盘,包含逐人洞察。
使用方式
安装要求
- Claude Code
- Git
- Bun v1.0+
- 浏览器自动化需 macOS 或 Linux(x64/arm64)
全局安装
git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack
cd ~/.claude/skills/gstack
./setup
项目安装
cp -Rf ~/.claude/skills/gstack .claude/skills/gstack
rm -rf .claude/skills/gstack/.git
cd .claude/skills/gstack
./setup
在 CLAUDE.md 中注册
## gstack
Use /browse skill from gstack for all web browsing. Never use mcp__claude-in-chrome__* tools.
Available skills:
- /plan-ceo-review - Product strategy review
- /plan-eng-review - Technical architecture planning
- /review - Thorough code review
- /ship - One-command branch shipping
- /browse - Browser automation and testing
- /qa - Systematic QA testing
- /setup-browser-cookies - Session management
- /retro - Engineering retrospectives
核心命令
规划工作流
- CEO 产品评审:先给出功能描述,再执行
/plan-ceo-review,AI 以 CEO 身份挑战假设、寻找更大机会(例如把“照片上传”扩展为“基于照片的 AI 列表创建”)。 - 工程架构评审:执行
/plan-eng-review,AI 以技术负责人身份输出架构图、状态机、异步任务边界、失败模式和测试矩阵。
代码质量工作流
- 彻底代码评审:执行
/review,进行偏执的资深工程师审查,关注竞态条件、信任边界、缺失的错误处理和生产故障模式。 - 一条命令发布:执行
/ship,自动完成同步主分支、运行测试套件、解决评审意见、推送分支、打开拉取请求。
QA 与测试工作流
- 浏览器自动化:执行
/browse https://myapp.com,AI 导航应用、截图、点击工作流、识别故障并测试响应式设计。 - 系统化 QA 测试:执行
/qa,进行分支感知测试,分析 git diff、识别受影响页面、测试 localhost:3000,支持完整探索模式和回归测试;也可执行/qa https://staging.myapp.com --quick进行 30 秒 5 页的快速冒烟测试。 - 会话管理:执行
/setup-browser-cookies staging.myapp.com,从真实浏览器(Chrome、Arc、Brave、Edge)导入 Cookie,无需手动登录即可测试需认证页面。
团队工作流
- 工程回顾:执行
/retro,进行工程经理风格复盘,分析 git 历史、逐人贡献、成长机会和团队动态,结果保存到.context/retros/。
配置
gstack 在 .gstack/ 目录中创建隔离的浏览器实例,自动配置包括 userDataDir: '.gstack/browser-data'、headless: false(用于调试)、viewport: { width: 1280, height: 720 }、timeout: 30000。
项目结构
your-project/
├── .claude/
│ └── skills/
│ └── gstack/
│ ├── skills/ # Workflow prompts
│ ├── browse/ # Browser automation
│ └── package.json
├── .gstack/ # Browser data (gitignored)
│ ├── browser-data/
│ └── screenshots/
└── .context/
└── retros/ # Retrospective history
集成模式
- 多会话工作流:可配合 Conductor 进行并行会话,例如会话 1 做功能开发(
/plan-ceo-review、/plan-eng-review),会话 2 做代码评审(/review),会话 3 做 QA 测试(/qa --full),会话 4 做发布(/ship)。 - CI/CD 集成:提供
.github/workflows/gstack-qa.yml示例,在 pull_request 时运行 QA。 - 团队上手:建议的开发工作流为
/plan-ceo-review→/plan-eng-review→ 实现功能 →/review→/qa→/ship→/qa staging.app.com。
高级用法
- 自定义 QA 场景:
/qa --focus=checkout-flow、/qa --mobile-only、/qa --accessibility;也可在/browse后要求运行 lighthouse 审计。 - 跨浏览器测试:
/setup-browser-cookies app.com后分别用--browser=chrome和--browser=firefox测试。 - 回归测试:先
/qa --baseline,改动后/qa --compare-baseline,AI 识别视觉或功能回归。
故障排查
- 二进制问题:删除
browse/dist后重新运行./setup。 - 权限错误:
chmod +x setup browse/dist/browse。 - 依赖缺失:删除
node_modules后运行bun install。 - 浏览器自动化失败:使用
/browse --debug以非无头模式运行,或删除.gstack/browser-data。 - 技能注册问题:重新运行
./setup,并用/plan-ceo-review --help验证。
适用场景
适用于使用 Claude Code 进行软件开发的团队或个人,希望在规划、架构评审、代码审查、发布、QA 测试和团队回顾等环节获得专业化、有立场的 AI 辅助,尤其适合需要浏览器自动化测试和需登录页面测试的场景。
限制
- 需要 Claude Code、Git、Bun v1.0+;浏览器自动化仅支持 macOS 或 Linux(x64/arm64)。
- 资料未提供收费、价格、平台支持范围、效果保证等信息。
- 资料未提供除上述命令与配置外的其他功能细节。