SuperAPI AI 工具集

gstack-workflow-assistant

编程与开发

查看项目

更新于 10-15 10:34

技能介绍

用途

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)。
  • 资料未提供收费、价格、平台支持范围、效果保证等信息。
  • 资料未提供除上述命令与配置外的其他功能细节。