gstack 使用教程

12 个技能一览

命令	角色	用途
/plan-ceo-review	CEO / 创始人	重新思考问题，找到"10 星级产品"
/plan-eng-review	工程经理	确定架构、数据流、边界条件、测试覆盖
/plan-design-review	高级设计师	80 项设计审计 + AI Slop 检测，只出报告不改代码
/review	资深工程师	找能通过 CI 但在生产环境炸掉的 bug
/ship	发布工程师	同步 main、跑测试、推分支、开 PR
/browse	QA 工程师	控制无头浏览器检查你的应用
/qa	QA + 修复	测试、发现 bug、原子提交修复、重新验证
/qa-only	QA 报告员	只出报告不修代码
/qa-design-review	设计师 + 前端	设计审计 + 自动修复设计问题
/setup-browser-cookies	会话管理	从真实浏览器导入 Cookie，测试登录页面
/retro	工程经理	每周回顾：commit 分析、贡献者评估、趋势追踪
/document-release	技术写作者	发布后自动更新项目文档

典型工作流：从想法到上线

想清楚要做什么

用 /plan-ceo-review 让 AI 思考真正的产品是什么，而不是只做你说的话。

你: /plan-ceo-review
    我想给列表应用加个卖家照片上传功能

Claude: "照片上传"不是真正的功能。真正的工作是
        帮卖家创建能卖出去的商品列表...
        (提出自动识别商品、拉取规格、
         起草标题等 10 星级方案)

确定技术方案

用 /plan-eng-review 确定架构、数据流、失败处理。

你: /plan-eng-review

Claude: [输出架构图、数据流、异步任务边界、
        失败处理、测试矩阵]

写代码

退出计划模式，按照方案实现功能。

代码审查

用 /review 寻找潜在的安全和并发问题。

你: /review

Claude: 发现竞态条件：两个标签页可能同时修改封面
        信任边界问题：从网络拉取数据到草稿生成
        存在 prompt 注入风险

发布

用 /ship 一条命令完成同步、测试、推送、开 PR。

你: /ship

Claude: [同步 main → 跑测试 → 推分支 → 创建 PR
        6 步搞定]

QA 测试

用 /qa 自动测试受影响的页面。

你: /qa

Claude: 测试了 3 个路由，全部正常。
        无 console 错误。无回归问题。

重点技能详解

/plan-ceo-review — 创始人模式

不要让 AI 只做你说的事。让它思考"这个请求背后真正的产品是什么？"

从用户角度重新思考问题
发现"10 星级产品"方案
示例：你说"加个照片上传"，它会反问能不能自动识别商品、拉取规格、起草标题、检测照片质量

/plan-eng-review — 工程经理模式

关注可构建的技术方案，而非空想。

架构设计、系统边界、数据流
同步 vs 异步任务划分
失败/重试逻辑、并发/竞态条件
信任边界、测试覆盖
强制输出架构图（序列图、状态图、数据流图）

/review — 代码审查

寻找"测试通过但上线会炸"的 bug。

N+1 查询、缺失索引
竞态条件、信任边界漏洞
错误的重试逻辑
通过测试但漏掉真正失败场景的 bug
支持 Greptile 集成（自动分类 PR 评论）

/ship — 一条命令发布

适合已经准备好的分支：

同步 main 分支
运行测试
检查分支状态
更新版本号 / CHANGELOG
推送分支
创建 / 更新 PR

/plan-design-review — 设计审计

打开你的网站，给出设计师视角的审计。

80 项检查清单
设计评分 + AI Slop 评分（字母等级 A-F）
推断你的设计系统，可生成 DESIGN.md
只出报告，不改代码

/qa-design-review — 设计修复

与 /plan-design-review 相同的审计，但会自动修复找到的问题。

每个修复一个原子 commit
CSS 修改自动放行，JSX/TSX 修改有风险控制
前后对比截图

/retro — 每周回顾

分析 commit 历史、贡献者评估、趋势追踪。

团队感知：识别每位贡献者
指标：commits、LOC、测试比例、PR 大小
检测编码会话、热点文件、连续提交天数
JSON 快照保存到 .context/retros/，支持趋势对比

/document-release — 文档更新

发布后自动更新 README、ARCHITECTURE、CONTRIBUTING 等文档。

交叉引用 git diff
更新文件路径、命令列表、项目结构树
润色 CHANGELOG，清理已完成 TODO

/browse — 浏览器自动化

gstack 的核心能力之一。基于 Playwright 的持久化 Chromium 浏览器，首次启动约 3 秒，后续每次调用 ~100-200ms。命令间保持状态（Cookie、localStorage 都保留）。

示例

你: /browse https://staging.myapp.com/signup
    填表测试注册流程

Claude: > browse goto https://staging.myapp.com/signup
        > browse snapshot -i
        > browse fill @e2 "test@example.com"
        > browse click @e5
        > browse screenshot
        注册成功，跳转到 onboarding 页面

        > browse goto https://staging.myapp.com/dashboard
        > browse console
        Dashboard 加载正常，无 console 错误

注意事项

浏览器在命令间保持运行，Cookie 和 localStorage 跨命令保留
30 分钟空闲后自动关闭
不要用敏感生产环境测试，除非你有意为之
Windows 上的 Cookie 导入可能有限制（功能主要针对 macOS Keychain 设计）

/qa — 智能测试

最强大的用法：不需要指定 URL。它会自动分析 git diff，识别受影响的页面和路由，然后逐一测试。

示例

你: /qa

Claude: 分析分支 diff... 12 个文件变更
        受影响路由: /listings/new, /listings/:id, /api/listings
        检测到应用运行在 localhost:3000
        [逐一测试每个页面]

        QA 报告: 3 个路由全部正常，无 console 错误

三种模式

/qa --quick

30 秒

冒烟测试：首页 + 前 5 个导航目标，检查加载、console 错误、坏链

/qa

默认

完整测试所有受 git diff 影响的页面和路由

/qa --regression

对比

与历史基线对比，显示哪些修好了、哪些是新问题、分数变化

/setup-browser-cookies — 登录态导入

测试需要登录的页面时使用。自动检测已安装的浏览器，解密 Cookie 导入到无头会话。

你: /setup-browser-cookies

Claude: 打开 Cookie 选择器，选择要导入的域名...

你: done

Claude: 已导入 2 个域名（47 个 cookies），会话就绪

# 或直接指定域名跳过选择器
你: /setup-browser-cookies myapp.com
Claude: 已从 Chrome 导入 myapp.com 的 12 个 cookies