Back to Details

gstack-workflow-assistant

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

gstack Workflow Assistant

gstack 工作流助手

Skill by ara.so — Daily 2026 Skills collection
Transform Claude Code from a generic assistant into a team of specialists you can summon on demand. Eight opinionated workflow skills that act as CEO, Engineering Manager, Release Manager, and QA Engineer with slash commands for planning, review, shipping, and testing.
由ara.so开发的Skill —— 2026每日技能合集
将Claude Code从通用助手转变为可按需调用的专家团队。八个预设工作流Skill，可扮演CEO、工程经理、发布经理和QA工程师角色，通过斜杠命令实现规划、评审、发布和测试等操作。

What It Does

功能介绍

gstack provides specialized AI personas and workflows:
  • CEO Review: Rethink problems and find the 10-star product hiding in requests
  • Engineering Planning: Lock in architecture, data flow, and edge cases
  • Code Review: Paranoid staff engineer-level review that catches production bugs
  • Release Management: One-command shipping with tests and PR creation
  • QA Testing: Automated browser testing with screenshots and systematic coverage
  • Browser Automation: Give AI eyes to click through your app and catch breakage
  • Session Management: Import real browser cookies for authenticated testing
  • Team Retrospectives: Engineering manager-style retros with per-person insights
gstack提供专业的AI角色与工作流：
  • CEO评审：重新审视问题，挖掘需求中隐藏的优质产品机会
  • 工程规划：确定架构、数据流与边缘场景
  • 代码评审：资深工程师级别的严谨评审，捕捉生产环境潜在Bug
  • 发布管理：一键式发布，包含测试与PR创建
  • QA测试：带截图的自动化浏览器测试，覆盖全面场景
  • 浏览器自动化：赋予AI可视化能力，遍历应用并捕捉问题
  • 会话管理：导入真实浏览器Cookie，实现认证场景测试
  • 团队回顾：工程经理风格的回顾，包含个人贡献分析

Installation

安装步骤

Requirements

环境要求

  • Claude Code
  • Git
  • Bun v1.0+
  • macOS或Linux（x64/arm64）系统（用于浏览器自动化）

Global Installation

全局安装

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

Project Installation

项目级安装

bash
cp -Rf ~/.claude/skills/gstack .claude/skills/gstack
rm -rf .claude/skills/gstack/.git
cd .claude/skills/gstack
./setup
Add to your 
CLAUDE.md
:
markdown
undefined
bash
cp -Rf ~/.claude/skills/gstack .claude/skills/gstack
rm -rf .claude/skills/gstack/.git
cd .claude/skills/gstack
./setup
将以下内容添加至你的
CLAUDE.md
：
markdown
undefined

gstack

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
undefined
所有网页浏览操作请使用gstack的/browse skill，不要使用mcp__claude-in-chrome__*工具。
可用技能：
  • /plan-ceo-review - 产品策略评审
  • /plan-eng-review - 技术架构规划
  • /review - 全面代码评审
  • /ship - 一键分支发布
  • /browse - 浏览器自动化与测试
  • /qa - 系统化QA测试
  • /setup-browser-cookies - 会话管理
  • /retro - 工程团队回顾
undefined

Core Commands

核心命令

Planning Workflows

规划工作流

CEO Product Review

CEO产品评审

typescript
// Start with feature description, then review strategy
You: I want to add seller photo upload to the listing app

You: /plan-ceo-review
// AI responds as CEO: challenges assumptions, finds bigger opportunity
// "Photo upload" → "AI-powered listing creation from photos"
typescript
// 先输入功能描述，再触发评审策略
你：我想在列表应用中添加卖家照片上传功能

你：/plan-ceo-review
// AI以CEO身份响应：挑战既有假设，挖掘更大机会
// "照片上传" → "基于照片的AI驱动列表创建"

Engineering Architecture Review

工程架构评审

typescript
You: /plan-eng-review
// AI responds as tech lead:
// - Architecture diagrams
// - State machines
// - Async job boundaries  
// - Failure modes
// - Test matrices
typescript
你：/plan-eng-review
// AI以技术负责人身份响应：
// - 架构图
// - 状态机
// - 异步任务边界  
// - 故障模式
// - 测试矩阵

Code Quality Workflows

代码质量工作流

Thorough Code Review

全面代码评审

typescript
You: /review
// Paranoid staff engineer review:
// - Race conditions
// - Trust boundaries
// - Missing error handling
// - Production failure modes
typescript
你：/review
// 资深工程师级别的严谨评审：
// - 竞态条件
// - 信任边界
// - 缺失的错误处理
// - 生产环境故障模式

One-Command Shipping

一键式发布

typescript
You: /ship
// Automated release process:
// 1. Sync main branch
// 2. Run test suite
// 3. Resolve review comments
// 4. Push branch
// 5. Open pull request
typescript
你：/ship
// 自动化发布流程：
// 1. 同步主分支
// 2. 运行测试套件
// 3. 解决评审意见
// 4. 推送分支
// 5. 打开Pull Request

QA and Testing Workflows

QA与测试工作流

Browser Automation

浏览器自动化

typescript
You: /browse https://myapp.com
// AI navigates your app:
// - Takes screenshots
// - Clicks through workflows
// - Identifies breakage
// - Tests responsive design
typescript
你：/browse https://myapp.com
// AI遍历你的应用：
// - 截取屏幕截图
// - 遍历工作流
// - 识别问题
// - 测试响应式设计

Systematic QA Testing

系统化QA测试

typescript
You: /qa
// Branch-aware testing:
// - Analyzes git diff
// - Identifies affected pages
// - Tests localhost:3000
// - Full exploration mode
// - Regression testing

You: /qa https://staging.myapp.com --quick
// Quick smoke test: 5 pages in 30 seconds
typescript
你：/qa
// 分支感知测试：
// - 分析Git差异
// - 识别受影响页面
// - 测试localhost:3000
// - 全量探索模式
// - 回归测试

你：/qa https://staging.myapp.com --quick
// 快速冒烟测试：30秒内测试5个页面

Session Management

会话管理

typescript
You: /setup-browser-cookies staging.myapp.com
// Imports cookies from real browser (Chrome, Arc, Brave, Edge)
// Enables testing authenticated pages without manual login
typescript
你：/setup-browser-cookies staging.myapp.com
// 从真实浏览器（Chrome、Arc、Brave、Edge）导入Cookie
// 无需手动登录即可测试认证页面

Team Workflows

团队工作流

Engineering Retrospectives

工程团队回顾

typescript
You: /retro
// Engineering manager-style retro:
// - Analyzes git history
// - Per-person contributions
// - Growth opportunities
// - Team dynamics
// - Saves to .context/retros/
typescript
你：/retro
// 工程经理风格的回顾：
// - 分析Git历史
// - 个人贡献分析
// - 成长机会
// - 团队动态
// - 保存至.context/retros/

Configuration

配置说明

Browser Settings

浏览器设置

gstack creates isolated browser instances in 
.gstack/
directory:
typescript
// Automatic browser configuration
{
  userDataDir: '.gstack/browser-data',
  headless: false, // for debugging
  viewport: { width: 1280, height: 720 },
  timeout: 30000
}
gstack在
.gstack/
目录中创建独立浏览器实例：
typescript
// 自动浏览器配置
{
  userDataDir: '.gstack/browser-data',
  headless: false, // 用于调试
  viewport: { width: 1280, height: 720 },
  timeout: 30000
}

Project Structure

项目结构

your-project/
├── .claude/
│   └── skills/
│       └── gstack/
│           ├── skills/           # Workflow prompts
│           ├── browse/           # Browser automation
│           └── package.json
├── .gstack/                      # Browser data (gitignored)
│   ├── browser-data/
│   └── screenshots/
└── .context/
    └── retros/                   # Retrospective history
your-project/
├── .claude/
│   └── skills/
│       └── gstack/
│           ├── skills/           # 工作流提示词
│           ├── browse/           # 浏览器自动化
│           └── package.json
├── .gstack/                      # 浏览器数据（已加入Git忽略）
│   ├── browser-data/
│   └── screenshots/
└── .context/
    └── retros/                   # 回顾历史

Integration Patterns

集成模式

Multi-Session Workflow

多会话工作流

Use Conductor for parallel sessions:
typescript
// Session 1: Feature development
You: /plan-ceo-review
You: /plan-eng-review
// [implement feature]

// Session 2: Code review
You: /review
// [fix issues]

// Session 3: QA testing  
You: /qa --full

// Session 4: Release
You: /ship
使用Conductor实现并行会话：
typescript
// 会话1：功能开发
你：/plan-ceo-review
你：/plan-eng-review
// [开发功能]

// 会话2：代码评审
你：/review
// [修复问题]

// 会话3：QA测试  
你：/qa --full

// 会话4：发布
你：/ship

CI/CD Integration

CI/CD集成

yaml
undefined
yaml
undefined

.github/workflows/gstack-qa.yml

.github/workflows/gstack-qa.yml

name: gstack QA on: [pull_request] jobs: qa: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - run: cd .claude/skills/gstack && ./setup - run: echo "/qa --regression" | claude-code
undefined
name: gstack QA on: [pull_request] jobs: qa: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - run: cd .claude/skills/gstack && ./setup - run: echo "/qa --regression" | claude-code
undefined

Team Onboarding

团队入职指南

markdown
undefined
markdown
undefined

Add to team docs

添加至团队文档

Development Workflow

开发工作流

  1. /plan-ceo-review
    - Validate product direction
  2. /plan-eng-review
    - Lock architecture
  3. Implement feature
  4. /review
    - Paranoid code review
  5. /qa
    - Test branch thoroughly
  6. /ship
    - One-command release
  7. /qa staging.app.com
    - Staging verification
undefined
  1. /plan-ceo-review
    - 验证产品方向
  2. /plan-eng-review
    - 确定架构
  3. 开发功能
  4. /review
    - 严谨代码评审
  5. /qa
    - 全面测试分支
  6. /ship
    - 一键发布
  7. /qa staging.app.com
    - 验证预发布环境
undefined

Advanced Usage

高级用法

Custom QA Scenarios

自定义QA场景

typescript
// Feature-specific testing
You: /qa --focus=checkout-flow
You: /qa --mobile-only
You: /qa --accessibility

// Performance testing
You: /browse https://app.com
// Then: "Run lighthouse audit on this page"
typescript
// 特定功能测试
你：/qa --focus=checkout-flow
你：/qa --mobile-only
你：/qa --accessibility

// 性能测试
你：/browse https://app.com
// 然后："对该页面运行Lighthouse审计"

Cross-Browser Testing

跨浏览器测试

typescript
// Test in multiple browsers
You: /setup-browser-cookies app.com
You: /browse app.com --browser=chrome
// [switch session]
You: /browse app.com --browser=firefox
typescript
// 在多浏览器中测试
你：/setup-browser-cookies app.com
你：/browse app.com --browser=chrome
// [切换会话]
你：/browse app.com --browser=firefox

Regression Testing

回归测试

typescript
// Before major changes
You: /qa --baseline
// [make changes]  
You: /qa --compare-baseline
// AI identifies visual/functional regressions
typescript
// 重大变更前
你：/qa --baseline
// [进行变更]  
你：/qa --compare-baseline
// AI识别视觉/功能回归

Troubleshooting

故障排查

Binary Issues

二进制文件问题

bash
undefined
bash
undefined

Rebuild browser automation binary

重新构建浏览器自动化二进制文件

cd .claude/skills/gstack rm -rf browse/dist ./setup
undefined
cd .claude/skills/gstack rm -rf browse/dist ./setup
undefined

Permission Errors

权限错误

bash
undefined
bash
undefined

Fix executable permissions

修复可执行权限

cd .claude/skills/gstack chmod +x setup browse/dist/browse
undefined
cd .claude/skills/gstack chmod +x setup browse/dist/browse
undefined

Missing Dependencies

依赖缺失

bash
undefined
bash
undefined

Reinstall Node dependencies

重新安装Node依赖

cd .claude/skills/gstack rm -rf node_modules bun install
undefined
cd .claude/skills/gstack rm -rf node_modules bun install
undefined

Browser Automation Failures

浏览器自动化失败

typescript
// Debug browser issues
You: /browse --debug
// Runs browser in non-headless mode for inspection

// Clear browser data
rm -rf .gstack/browser-data
typescript
// 调试浏览器问题
你：/browse --debug
// 以非无头模式运行浏览器以便检查

// 清除浏览器数据
rm -rf .gstack/browser-data

Skill Registration Issues

Skill注册问题

typescript
// Re-register skills
cd .claude/skills/gstack
./setup

// Verify skills are available
You: /plan-ceo-review --help
The skills work by providing specialized prompts and browser automation tools that transform Claude Code into domain experts. Each workflow enforces specific cognitive modes - CEO strategic thinking, engineering rigor, paranoid review, or systematic testing - instead of generic assistance.
typescript
// 重新注册Skill
cd .claude/skills/gstack
./setup

// 验证Skill是否可用
你：/plan-ceo-review --help
这些Skill通过提供专业提示词与浏览器自动化工具，将Claude Code转变为领域专家。每个工作流都强制特定的思维模式——CEO战略思考、工程严谨性、严谨评审或系统化测试——而非通用辅助。