ENZHKO
Last updated on

如何使用 gstack:不要把 Claude Code 变得过度复杂


gstack 不是藏在终端里的魔法 AI 公司。它更像是一组给 Claude Code 使用的结构化技能,帮助你在写代码前先想清楚,在信任代码前先审查,在发布前先测试。

如果你想先了解 gstack 是什么、为什么受到关注,可以先读 gstack 对 AI Agent 说对的一件事:角色比提示词更重要

这就是它的主要价值。

大多数 AI 编程失败并不是从代码开始的,而是更早。功能定义不清,范围太大,架构还没想明白,agent 就已经开始实现。结果看起来完成了,但真实用户流程没人测过。

gstack 给 Claude Code 加上一条更有纪律的工作流:

思考 → 规划 → 构建 → 审查 → 测试 → 发布

你不需要每次都运行所有命令。关键是知道什么任务该用什么角色。

gstack 提供什么

gstack 会安装一组 Claude Code slash command,例如:

  • /office-hours
  • /plan-ceo-review
  • /plan-eng-review
  • /plan-design-review
  • /autoplan
  • /review
  • /qa
  • /ship
  • /investigate
  • /cso

每个命令都会让 Claude Code 进入不同的工作姿态。有些用于产品思考,有些用于架构,有些用于代码审查、QA、安全或发布。

重点不是角色扮演。重点是不要把 AI 编程当成一个巨大的提示词。

基本安装

官方安装路径默认你已经在使用 Claude Code。

需要:

  • Claude Code
  • Git
  • Bun
  • Windows 上需要 Node.js

安装:

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

安装后,gstack 命令就可以在 Claude Code 中使用。

第一次测试时保持简单:

/office-hours
/plan-ceo-review
/review
/qa

不要一开始就跑完整工作流。先在一个真实功能上试一次。

实际怎么用

想法不清楚时用 /office-hours

当你只有一个模糊的产品想法时,从这里开始。

比如,“做一个 daily briefing app”还不够清楚。真正的问题是日历准备太麻烦?会议上下文缺失?优先级混乱?客户备注过期?

/office-hours 可以把松散请求变成更清楚的功能。

小修小改可以跳过。

/plan-ceo-review 控制范围

AI 很容易让你做太多。

一个小功能很快就会膨胀成设置页、仪表盘、引导流程和没人要求的抽象层。

/plan-ceo-review 问这些问题:

  • 最小但有用的版本是什么?
  • v1 里应该删掉什么?
  • 这个功能要真正有价值,需要什么?

在让 agent 写大量代码之前用它比较合适。

高风险实现前用 /plan-eng-review

如果变更涉及架构、数据流、API、认证、后台任务、迁移或状态管理,就值得使用 /plan-eng-review

目标很简单:在代码改动扩散到整个项目之前,把隐藏假设暴露出来。

小修复可以跳过。多文件工作通常值得做一次。

只有 UI 质量重要时才做设计审查

gstack 有 /plan-design-review/design-review/design-shotgun 等设计命令。

它们适合落地页、仪表盘、引导流程、表单和面向用户的打磨。

不要把设计审查硬塞进后端工作。那只是增加仪式感。

信任分支前先用 /review

Claude Code 实现完之后,运行 /review

这是 gstack 最实用的习惯之一。刚写完代码的 agent 往往会对自己的结果过于乐观。单独的审查步骤可以帮助发现:

  • 漏掉的边界情况
  • 薄弱的错误处理
  • 未完成的实现
  • 测试缺口
  • 安全假设
  • 计划和代码不一致

在接受 AI 写的代码之前,这应该成为常规步骤。

有真实用户流程时用 /qa

如果功能有 staging URL 或浏览器流程,就用 /qa

很多 AI 生成的改动能通过测试,但会在真实产品里失败。按钮没有连到正确状态,空状态坏掉,认证跳转失败,弹窗单独可用但放进完整流程就出问题。

/qa 的意义是像用户一样测试产品,而不是像编译器一样看代码。

/ship 放在最后

/ship 用于发布准备。应该在规划、实现、审查和 QA 之后使用。

它救不了混乱的工作。它只能打包已经准备好的工作。

第一次可以这样试

可以从这个流程开始:

1. 选一个真实要做的功能。
2. 用 /office-hours 梳理用户问题。
3. 用 /plan-ceo-review 缩小范围。
4. 如果实现有风险,再用 /plan-eng-review。
5. 让 Claude Code 构建更小的版本。
6. 运行 /review。
7. 如果有浏览器流程,运行 /qa。
8. 只有准备好之后才运行 /ship。

最重要的是在实现前缩小范围。

gstack 最有用的时候,是它阻止你太早做太多东西的时候。

最先试的 5 个命令

如果只试 5 个命令,就从这里开始。

/office-hours

当你还不确定到底要做什么时使用它。不要只描述功能请求,要描述用户问题。目标是得到更清楚的问题定义和更小的第一版。

好的提示词:

/office-hours
我想为会议太多的人做一个 daily briefing 功能。
帮我理清真正的用户痛点,以及最小但有用的版本。

/plan-ceo-review

当想法已经成形但范围可能太大时使用它。让它缩小范围、挑战薄弱假设,并指出 v1 应该包含什么、删除什么。

好的提示词:

/plan-ceo-review
审查这个功能计划。请严格控制范围。实现前我们应该删掉什么?

/plan-eng-review

当实现会涉及多个文件、数据流、API、认证、迁移或状态管理时,在编码前使用它。你想要的不是更大的野心,而是风险、边界情况和测试计划。

好的提示词:

/plan-eng-review
检查这个计划的架构风险、隐藏假设、边界情况,以及编码前需要的测试。

/review

Claude Code 写完代码后使用它。把它当成独立审查者,而不是实现的延续。让它寻找生产 bug、遗漏场景,以及计划和代码不一致的地方。

好的提示词:

/review
在我接受当前分支之前审查它。重点找那些粗看会漏掉、但上线后可能出问题的 bug。

/qa

当存在真实浏览器流程时使用它。给它 staging URL 和要测试的路径。这一步能发现普通代码审查容易漏掉的产品级失败。

好的提示词:

/qa https://staging.example.com
测试注册、引导流程和第一个成功用户动作。报告 bug,并验证修复结果。

之后可以加 /ship,但不要把 /ship 当成起点。发布是最后一步,不是工作流本身。

什么时候不该用 gstack

不要给所有任务都跑完整 gstack 流程。

这些情况通常过度了:

  • 修 typo
  • 一行 bug
  • 简单依赖更新
  • 小型重构
  • 修法很明显的任务
  • 已经有失败测试覆盖的改动

这种时候,直接告诉 Claude Code 要改什么,跑测试,然后结束。

规则很简单:

如果命令能降低风险,就用。只是在增加仪式,就跳过。

结论

gstack 最适合被理解为 Claude Code 的工作流层。

它帮助 solo builder 把产品思考、架构审查、代码审查、QA 和发布纪律加入 AI 辅助开发过程。

一开始轻量使用就好:

  • 问题不清楚时用 /office-hours
  • 范围可能错时用 /plan-ceo-review
  • 架构重要时用 /plan-eng-review
  • 信任代码前用 /review
  • 真实用户流程重要时用 /qa
  • 工作准备好后再用 /ship

目标不是在 Claude Code 里假装有一家公司。

目标是停止用单个提示词写代码,开始通过更好的工作循环来构建软件。

来源