gstack：把 Claude Code 变成虚拟工程团队
本文目录
gstack#
gstack 把 Claude Code（以及其他编码智能体）变成一支虚拟工程团队：一位重新思考产品的 CEO、一位锁定架构的工程经理、一位捕捉 AI 垃圾内容的设计师、一位发现生产缺陷的审查者、一位打开真实浏览器的 QA 负责人、一位执行 OWASP + STRIDE 审计的安全官，以及一位发布 PR 的发布工程师。全部是斜杠命令，全部是 Markdown，全部免费，MIT 许可证。
我是 Garry Tan，Y Combinator 的总裁兼 CEO。这是我每天使用的开源软件工厂，我把它分享出来，是因为这些工具应该对所有人可用。背后的故事、生产力数字，以及我如何同时运行十个冲刺，都在 Why gstack 中。
分叉它。改进它。让它成为你的。如果你想批评免费开源软件——欢迎，但我更希望你先把本文试用一遍。
适合谁：
- 创始人和 CEO——尤其是仍然想亲手交付的技术型创始人
- 第一次使用 Claude Code 的人——用结构化角色代替空白提示词
- 技术负责人和资深工程师——在每个 PR 上获得严格的审查、QA 和发布自动化
快速开始#
- 安装 gstack（两段粘贴，约 30 秒完成设置；见下文）。
- 运行
/office-hours并描述你正在构建的东西。它会质疑你的框架，并写出一份供其他技能读取的设计文档。 - 在任何有改动的分支上运行
/review。它会找出通过 CI 但在生产环境爆炸的缺陷，并修复明显的那些。 - 在你的预发布 URL 上运行
/qa，或在隔离的本地 API、CLI、任务或 webhook 上运行。它会打开真实浏览器，复现缺陷并修复它们。
先停在这里。你会知道这是否适合你。当你想要完整冲刺时，/autoplan 会端到端审查计划，/ship 会运行测试、审查并创建 PR。
安装——约 30 秒#
要求：Claude Code、Git、Bun v1.4.2+（经过测试的版本；setup 会拒绝低于 1.3.3 的 Bun，因为那会让编译后的工具读取项目的 .env），以及 Windows 上的 Node.js。macOS 上推荐使用 Aside 浏览器（macOS 15+），浏览器技能、/make-pdf 和 /diagram 会优先用它和你真实的已登录会话；没有它，./setup 会构建 gstack 自带的浏览器。/cso 还需要原生工具链；setup 会说明这一点，并在工具链缺失时让它保持不可用。耗时、/cso 前置条件和 setup 注册的钩子见：docs/install.md。
第 1 步：安装到你的机器#
打开 Claude Code 并粘贴以下内容。Claude 会完成其余工作。
Install gstack: run git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setup then add a "gstack" section to CLAUDE.md that says to use the /browse skill from gstack for all web browsing and never use mcp__claude-in-chrome__* tools. Claude Code lists the installed skills itself, so the section needs no skill list. Then ask the user if they also want to add gstack to the current project so teammates get it.第 2 步：团队模式——共享仓库自动更新（推荐）#
在你的仓库内部粘贴以下内容。它会把你切换到团队模式，引导仓库让队友自动获得 gstack，并提交这次变更：
(cd ~/.claude/skills/gstack && ./setup --team) && ~/.claude/skills/gstack/bin/gstack-team-init required && git add .claude/ CLAUDE.md && git commit -m "require gstack for AI-assisted work"仓库里没有随附文件，没有版本漂移，没有手动升级。每个 Claude Code 会话开始时都会做一次快速的自动更新检查（限制为每小时一次、网络故障安全、完全静默）。团队模式跟随稳定通道：每周两次打标签的发布（周一和周四，最多每 72 小时一次，加上已验证的安全和回归修复），而不是每次合并到 main。gstack-config set update_channel main 则改为跟随每次合并；参见 docs/releases.md。
如果你更愿意提醒队友而不是阻止他们，可以把 required 换成 optional。
团队模式的 required 钩子运行在 Node.js 上，因此每位队友都需要在 PATH 中有 Node.js（详情）。以后移除 gstack：docs/uninstall.md。
其他 AI 智能体#
gstack 不只运行在 Claude 上。直接执行 ./setup 只为 Claude Code 安装（在 OpenClaw、Hermes 或 Dot 中运行时，它也会把 gstack 的技能注册到该运行环境：docs/hosts.md）。
用 --host <name> 选择另一个智能体，或用 --host auto 为 setup 在本机检测到的每个智能体安装：
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack && ./setup --host auto # or: ./setup --host codex
./setup --status # one row per install: host, tier, scope, version, path显式的 --host X 只为 X 安装，绝不会改动另一个智能体的安装。/gstack-upgrade 会刷新它注册过的每个安装，每个主机一行，并说明哪些失败。
层级：full 由一次真实工作流运行认证（见 Certify your host）；experimental 可以安装并通过一致性测试，但尚无认证运行；instruction-only 什么都不安装，setup 会打印需要复制的内容。
| 智能体 | 层级 | 安装 | 首次调用 | 安全技能 | 外部审查需要 | 修复 |
|---|---|---|---|---|---|---|
| Claude Code | full | --host claude（默认） | /office-hours | 强制执行（钩子阻止） | 已登录的 Codex CLI | ./setup --host claude |
| OpenAI Codex CLI | experimental | --host codex → ${CODEX_HOME:-~/.codex}/skills/gstack-*/ | 请求 gstack-office-hours | 建议性，不阻止 | 已登录的 Claude Code CLI | ./setup --host codex |
| OpenCode | experimental | --host opencode → ~/.config/opencode/skills/gstack-*/ + /gstack-* 命令 | /gstack-office-hours | 建议性，不阻止 | 已登录的 Codex CLI | ./setup --host opencode |
| Cursor | experimental | --host cursor → ~/.cursor/skills/gstack-*/ | 请求 gstack-office-hours | 建议性，不阻止 | 已登录的 Codex CLI | ./setup --host cursor |
| Factory Droid | experimental | --host factory → ~/.factory/skills/gstack-*/ | 请求 gstack-office-hours | 建议性，不阻止 | 已登录的 Codex CLI | ./setup --host factory |
| Kiro | experimental | --host kiro → ~/.kiro/skills/gstack-*/ | 请求 gstack-office-hours | 建议性，不阻止 | 已登录的 Codex CLI | ./setup --host kiro |
| GitHub Copilot CLI | experimental | --host copilot → ~/.copilot/skills/gstack-*/ | /gstack-office-hours | 建议性，不阻止 | 已登录的 Codex CLI | ./setup --host copilot |
| Antigravity CLI | experimental | --host agy（或 --host antigravity）→ ~/.gemini/antigravity-cli/skills/gstack-*/ | /gstack-office-hours | 建议性，不阻止 | 已登录的 Codex CLI | ./setup --host agy |
| Gemini CLI | experimental | --host gemini → ~/.gemini/skills/gstack-*/ | 请求 gstack-office-hours | 建议性，不阻止 | 已登录的 Codex CLI | ./setup --host gemini |
| Slate | instruction-only | --host slate（指向 Claude 安装；Slate 读取 .claude/skills） | 通过 Claude 安装使用 /office-hours | 建议性，不阻止 | — | ./setup --host claude |
| OpenClaw | experimental | --host openclaw（在 OpenClaw 的 skills 文件夹中安装五个任务技能和一个 gstack 路由器技能；在 OpenClaw 内运行 setup 时自动执行；ACP 路径见 docs/OPENCLAW.md） | 询问任务；智能体会打开匹配的任务技能或 gstack 路由器 | 建议性，不阻止 | — | ./setup --host openclaw |
| Hermes | experimental | --host hermes（在 $HERMES_HOME/skills/gstack 中安装每个技能；在 Hermes 内运行 setup 时自动执行） | 询问任务，或 /gstack-review | 建议性，不阻止 | — | ./setup --host hermes |
| GBrain（mod） | instruction-only | --host gbrain（具备大脑感知的变体从 GBrain 仓库发布） | — | 建议性，不阻止 | — | — |
各主机说明（智能体运行环境、Copilot、Antigravity、Gemini CLI、OpenClaw 与 ClawHub、Codex 行为配置和模型层级、外部审查提供商、设计二进制的模型）见 docs/hosts.md。任何会读取规则的智能体（Zed、Amp、Jules）都可以使用 2KB 的 agents 摘要，无需安装。添加主机：docs/ADDING_A_HOST.md。
看它工作#
你：我想为我的日历构建一个每日简报应用。
你：/office-hours
Claude：[询问痛点——具体例子，而不是假设]
你：多个 Google 日历，事件信息过时，地点错误。 准备要花很久，结果还不够好……
Claude：我要质疑这个框架。你说的是“每日简报应用”。但你实际描述的是一个个人幕僚长 AI。 [提取出你没想到自己正在描述的 5 项能力] [挑战 4 个前提——你同意、反对或调整] [生成 3 种实现方案及工作量估算] 建议：明天先发布最窄的切入点，从真实使用中学习。完整愿景是 3 个月的项目——从真正可用的每日简报开始。 [写出设计文档 → 自动流入下游技能]
你：/plan-ceo-review
[读取设计文档，挑战范围，运行 10 节审查]
你：/plan-eng-review
[数据流、状态机、错误路径的 ASCII 图]
[测试矩阵、故障模式、安全顾虑]
你：批准计划。退出计划模式。 [在 11 个文件中写出 2,400 行。约 8 分钟。]
你：/review
[自动修复] 2 个问题。[询问] 竞态条件 → 你批准修复。
你：/qa https://staging.myapp.com
[打开真实浏览器，点击流程，找到并修复一个缺陷]
你：/ship
测试：42 → 51（+9 个新测试）。PR：github.com/you/app/pull/42
你说的是“每日简报应用”。智能体说“你在构建一个幕僚长 AI”——因为它听的是你的痛点，而不是你的功能请求。八个命令，端到端。这不是 copilot。这是一支团队。
冲刺#
gstack 是一个流程，不是一堆工具。技能按照冲刺的顺序运行：
思考 → 规划 → 构建 → 审查 → 测试 → 发布 → 复盘
每个技能都为下一个提供输入。/office-hours 写出的设计文档会被 /plan-ceo-review 读取。/plan-eng-review 写出的测试计划会被 /qa 接手。/review 捕获的缺陷由 /ship 验证已修复。没有东西会掉在地上，因为每一步都知道前面发生了什么。
| 技能 | 你的专家 | 他们做什么 |
|---|---|---|
/office-hours | YC Office Hours | 从这里开始。六个强制性问题，在你写代码之前重新框定产品。质疑你的框架，挑战前提，生成实现备选方案。设计文档会流入每个下游技能。 |
/plan-ceo-review | CEO / 创始人 | 重新思考问题。找到请求里隐藏的 10 星级产品。四种模式：扩张、选择性扩张、保持范围、缩减。 |
/plan-eng-review | 工程经理 | 锁定架构、数据流、图表、边界情况和测试。迫使隐藏假设浮出水面。 |
/plan-design-review | 资深设计师 | 按 0–10 给每个设计维度打分，解释 10 分是什么样，然后编辑计划以达到该分数。检测 AI 垃圾内容。交互式——每个设计选择一个 AskUserQuestion。 |
/plan-devex-review | 开发者体验负责人 | 交互式 DX 审查：探索开发者画像，对照竞品的 TTHW 做基准，设计你的魔法时刻，逐步追踪摩擦点。为阅读错误消息的智能体给错误消息打分（agent-ready errors）。三种模式：DX EXPANSION、DX POLISH、DX TRIAGE。20–45 个强制性问题。 |
/design-consultation | 设计伙伴 | 从零构建完整设计系统。研究领域格局，提出创意风险，生成真实的产品模型图。以开放的 DESIGN.md 格式写入 DESIGN.md，因此 impeccable、Google Stitch 以及任何读取该格式的工具共享同一个文件。 |
/review | 资深工程师 | 找出通过 CI 但在生产环境爆炸的缺陷。自动修复明显的那些。标记完整性缺口和门禁完整性：每一个被削弱的测试、超时、快照或抑制，都会按名字送达某个人。建议性简化视角会标记过度构建的代码——绝不阻止，绝不自动应用。 |
/deslop-shared-libs | 共享代码审查员 | 在近期工作中寻找值得提取的共享代码。最多比较五个机会，推荐最好的三个，附源代码证据、可靠性收益和总代码节省。仅建议。 |
/write-skill | 技能编辑 | 编写新的智能体技能或改进现有技能，避免臃肿。五步编辑阶梯（先修工具，不添加模型已经会做的事，编辑那一行而不是追加，能触达智能体的最低层级，规则而非故事），gstack-skill-bill 报告每层大小及自上次瘦身以来的增长，漂移检查确保技能提到的每个 gstack 命令和标志仍然存在，以及由“之前/之后/无技能”测试证明的完整瘦身。 |
/test-audit | 测试审计员 | 扫描现有测试，找出那些成本高于其保护价值的：源代码 grep、重复、无断言探针、仅供测试的导出。每个候选都带一张证据卡；除非你批准一批，否则只报告。 |
/investigate | 调试器 | 系统化根因调试。铁律：没有调查就不修复。追踪数据流，检验假设，连续 3 次修复失败后停止。 |
/verify | 构建循环 | 运行仓库自己的检查（类型检查、lint、构建）以及 /ship 预门禁会为你的改动挑选的测试，修复失败项，重复直到全绿，然后交给 /ship。运行仓库命令前询问一次；没有测试覆盖时绝不说改动是绿的。 |
/design-review | 会写代码的设计师 | 与 /plan-design-review 相同的审计，然后修复发现的问题。原子提交，前后截图。如果你安装了 impeccable，它的引擎会先运行，每个机械性发现都会带上其规则 ID。 |
/devex-review | DX 测试员 | 实时开发者体验审计。真正测试你的入门流程：浏览文档，尝试快速开始流程，计时 TTHW，以智能体遇到它们的方式触发 CLI 错误（gstack-error-capture：无终端、受控、已脱敏）。与 /plan-devex-review 的评分比较——这是检验你的计划是否匹配现实的回旋镖。 |
/design-shotgun | 设计探索者 | “给我看选项。”生成 4–6 个 AI 模型图变体，在浏览器中打开比较板，收集你的反馈并迭代。品味记忆会学习你喜欢什么。重复直到你爱上某个方案，然后交给 /design-html。 |
/design-html | 设计工程师 | 把模型图变成真正可用的生产 HTML。Pretext 计算式布局：文本重排，高度自适应，布局动态。30KB，零依赖。检测 React/Svelte/Vue。按设计类型智能选择 API 路由（落地页 vs 仪表盘 vs 表单）。有 impeccable 引擎时做一次 slop-gate 检查。产出可交付，不是演示。 |
/design-motion | 动效设计师 | 把已批准的模型图、最终页面或 URL 变成展示循环。重建精确帧，从空白加载，给每个视觉一个故事，在假时钟上记录确定性帧，并在接缝、空拍、静止和溢出检查通过后，导出用于 X 的 MP4、网站 GIF 和 800×500 GIF。需要 ffmpeg。 |
/qa | QA 负责人 | 探索浏览器、API、CLI、任务和 webhook 行为。复现缺陷，编写失败的回归测试，修复原因并在提交前重新验证。 |
/qa-only | QA 报告员 | 探索并报告，附带可重放的证据。建议回归用例，但不改动产品代码或测试。 |
/pair-agent | 多智能体协调器 | 与任何 AI 智能体共享 gstack 自己的浏览器。一条命令，一次粘贴，即可连接。适用于 OpenClaw、Hermes、Codex、Cursor，或任何能 curl 的东西。每个智能体获得自己的标签页。自动启动有头模式，让你看到一切。为远程智能体自动启动 ngrok 隧道。作用域令牌、标签隔离、速率限制、活动归属。（运行在捆绑浏览器上——备用引擎；驱动 Aside 的智能体只需打开自己的标签页。） |
/cso | 首席安全官 | 安全审计，包含应用模型、有支持的发现、独立挑战和明确的覆盖范围。没有目录配置时仍可做静态评估。有匹配的合格配置时，全面模式会增加受控的运行时/扫描器执行，以及可审查的修复候选，适用于 Node/Bun、Python 和 Rails。合格的运行时和扫描器镜像为 linux/amd64 和 linux/arm64 发布。没有 Docker 时，审计只运行静态评估。运行时测试的捆绑包会认证单独的外部断言。项目测试完成度仍标记为 self_reported，因为目标代码控制测试过程；tested 留给未来与目标无关的完成见证。 |
/ship | 发布工程师 | 同步 main，运行测试，探索改动后的行为，审计覆盖率、门禁完整性和文档，然后验证、推送并打开 PR。 |
/land-and-deploy | 发布工程师 | 合并 PR，等待 CI 并部署，验证生产健康。从“已批准”到“已在生产验证”只需一条命令。 |
/modernize | 陈旧 PR 维护者 | 把老化的 PR 带到当前基线，并说明它是否还应该存在：MODERNIZE（变基、git range-diff 证明、以固定到观察到的 head 的租约推送）、REWORK（问题仍在，但 diff 不行）或 CLOSE（建议，未经许可绝不执行）。读取基线移动过的范围，寻找语义冲突，而不仅是文本冲突。 |
/canary | SRE | 部署后监控循环。监视控制台错误、性能回归和页面故障。 |
/benchmark | 性能工程师 | 基线化页面加载时间、Core Web Vitals 和资源大小。在每个 PR 上比较前后。 |
/ubicloud | 远程运行器 | 在临时的 16 vCPU Ubicloud VM 上运行重型测试套件、构建或评估：按所有者和 TTL 命名的 VM，带回收器、配额预检、卡死看门狗，每个仓库一次提交的 verify。 |
/runaway-stopper | 花费管理员 | 在 Capy 上发现失控的智能体线程和子智能体（自身上下文超过 5 亿 token、活跃超过 3 天、子智能体超过 1 亿、空唤醒、无休止的审查轮次），在干净点停止它们，通过交接轮换线程，并设置默认值防止它们回来。gstack-runaway scan 读取主机自己的线程数据，绝不执行动作。 |
/eval-plan | 评估规划师 | 在第一次计费调用前预注册付费评估：门槛、分支、诱饵和停止规则；在真实输入上做 $0 桩模型试运行；以及一个三项计费试点，其外推和花费表决定是否批准。 |
/document-release | 技术写作者 | 每次发布时，在最终验证和发布前，对照项目文档审计改动后的行为。也可独立运行。显示已更新、已审查/仍最新或被阻塞的文档，以及任何剩余缺口。 |
/document-generate | 文档作者 | 使用 Diataxis 框架从零生成缺失文档。先研究代码库，然后编写真正匹配代码的参考/操作指南/教程/解释文档。可独立调用，或在 /document-release 的覆盖图发现缺口时串联调用。了解更多：教程 • 操作指南 • 为什么是 Diataxis。 |
/retro | 工程经理 | 团队感知的每周复盘。按人分解、交付连续记录、测试健康趋势、成长机会。/retro global 跨你所有的项目和 AI 工具运行（Claude Code、Codex、Gemini、Kimi Code、OMP、Antigravity）。 |
/browse | QA 工程师 | 给智能体眼睛。优先驱动你的 Aside 浏览器——你真实的会话、真实点击、真实截图——通过确定性的 aside repl 脚本。没有 Aside？回退到 gstack 自己的 Chromium：真实点击，每条命令约 100ms，/open-gstack-browser 会以有头模式显示它，带侧边栏、反机器人隐身和自动模型路由。其他所有浏览器技能都建立在它之上。 |
/scrape | 数据提取器 | 在你的 Aside 浏览器中，利用页面真实的登录状态，从网页提取结构化数据——表格、列表、价格。在备用浏览器上，/skillify 会把流程变成永久的浏览器技能，下次约 200ms 运行。 |
/setup-browser-cookies | 会话管理器 | 从 Chrome、Chromium、Brave、Edge、仅 Windows 的 Opera 和 Opera GX，或仅 macOS 的 Comet 和 Arc 中复制选定的 cookie 到 gstack 的捆绑浏览器。选择你的配置和域名；复制和登录验证是分开的。仅在备用路径上需要——Aside 已经有你的会话。 |
/autoplan | 审查流水线 | 一条命令，获得完整审查的计划。自动运行 CEO → 设计 → DX → 工程审查（工程总是最后，因此发布门禁审查的是最终修订后的计划），并编码决策原则。只把品味决策呈现给你批准。 |
/spec | 规格作者 | 用五个阶段把模糊意图变成精确、可执行的规格（为什么、范围、带强制代码阅读的技术细节、草稿、文件）。提交前有外部审查质量门禁（Claude Code 上用 Codex；其他运行环境上用 Codex；低于 7/10 阻止），失败关闭的密钥脱敏，对现有 issue 去重，归档到 $GSTACK_STATE_ROOT/projects/$SLUG/specs/ 以供团队语料召回。--execute 在全新 worktree 中启动 claude -p；/ship 在合并时自动关闭源 issue。感知计划模式。 |
/learn | 记忆 | 管理 gstack 跨会话学到的东西。审查、搜索、修剪和导出项目特定的模式、陷阱和偏好。学习会跨会话累积，因此 gstack 会在你的代码库上越来越聪明。 |
/make-pdf | 发布者 | Markdown 进，出版质量文档出。Mermaid 和 excalidraw 围栏渲染为矢量图，完全离线。图像缩放到页面，绝不截断；宽图获得自己的横向页面。--to html 输出一个自包含文件，--to docx 输出 Word 文档。 |
/diagram | 图表制作者 | 英文进，可编辑图表出。输出三件套：mermaid 源码、可在 excalidraw.com 打开和编辑的 .excalidraw（手绘风格），以及渲染后的 SVG/PNG。零网络。把源码嵌入 Markdown，/make-pdf 即可渲染。 |
同样的 /qa 和 /qa-only 命令可以在没有浏览器的情况下测试 CLI、API、任务、worker 和 webhook：没有网页的 QA。
我该用哪种审查？#
| 为……构建 | 计划阶段（写代码前） | 上线后实时审计 |
|---|---|---|
| 最终用户（UI、Web 应用、移动端） | /plan-design-review | /design-review |
| 开发者（API、CLI、SDK、文档） | /plan-devex-review | /devex-review |
| 架构（数据流、性能、测试） | /plan-eng-review | /review |
| 以上所有 | /autoplan（运行 CEO → 设计 → DX → 工程，自动检测适用项；工程总是最后） | — |
强力工具#
| 技能 | 它做什么 |
|---|---|
/codex | 第二意见——来自 OpenAI Codex CLI 的独立代码审查。审查、挑战和咨询模式。除 Codex 外的每个运行环境都可用。 |
/claude-code | 第二意见——来自 Claude Code 的独立代码审查。审查、挑战和咨询模式，带会话连续性以供咨询。除 Claude Code 外的每个运行环境都可用。 |
/careful | 安全护栏——在破坏性命令（rm -rf、DROP TABLE、force-push）前警告。说“be careful”即可激活。可覆盖任何 MEDIUM 警告；根目录/主目录递归删除和默认分支强推会被硬拒绝。 |
/freeze | 编辑锁——把文件编辑限制在一个目录内。防止调试时意外改动范围外的内容。 |
/guard | 完整安全——/careful + /freeze 一条命令。生产工作的最高安全性。 |
/unfreeze | 解锁——移除 /freeze 边界。 |
/open-gstack-browser | GStack 浏览器——以有头模式启动 gstack 自己的浏览器，带侧边栏、反机器人隐身、自动模型路由（动作使用 Sonnet，分析使用 Opus）、一键 cookie 导入和 Claude Code 集成。清理页面，拍摄智能截图，编辑 CSS，并把信息传回终端。备用引擎的可见界面；打开 Aside 时，你会在那里看到智能体的标签页。 |
/setup-deploy | 部署配置器——为 /land-and-deploy 做一次性设置。检测你的平台、生产 URL 和部署命令。 |
/setup-gbrain | GBrain 入门——5 分钟内从零到运行 gbrain。PGLite 本地、现有 Supabase URL，或通过 Management API 自动配置新的 Supabase 项目。为 Claude Code 注册 MCP，并按仓库配置信任三元组（读写/只读/拒绝）。完整指南。 |
/sync-gbrain | 保持大脑最新——通过 gbrain sources add + gbrain sync --strategy code 把本仓库代码重新索引到 gbrain，刷新 CLAUDE.md 中的 ## GBrain Search Guidance 块，并在能力检查失败时自动移除指导。--incremental（默认）、--full、--dry-run。幂等；可安全重复运行。 |
/gstack-upgrade | 自更新器——升级 gstack 到最新。检测全局安装还是随仓库附带安装，同步两者，显示变更。 |
/captain | 团队控制器——从一个控制器运行许多编码智能体：泳道发送 READY 块且从不合并，控制器通过列车合并（调用时盖章、验证、以预期 head 合并），保留摘要，以固定形状转达批准，并每天运行一次不稳定测试修复。也响应 /crew。团队指南。 |
/ios-qa | iOS 真机 QA（v1.43.0.0+）——通过应用内嵌的 StateServer，经 USB CoreDevice 驱动真实 iPhone 或 iPad。读取 Swift 源码，代码生成类型化的 @Observable 访问器，运行智能体循环。可选的 --tailnet 标志把设备暴露给 OpenClaw 或 Tailscale 网络上任何支持 HTTP 的智能体，让远程智能体无需接触硬件即可运行 iOS QA。能力层级允许列表（观察/交互/修改/恢复）、按设备会话锁、审计日志。 |
/ios-fix、/ios-design-review、/ios-clean、/ios-sync | iOS 缺陷修复循环、设计师视角的 HIG 审计、调试桥清理，以及访问器重新同步。见 docs/skills.md。端到端演练：docs/howto-ios-testing-with-gstack.md。 |
除斜杠命令外，gstack 还提供独立 CLI（gstack-egress、gstack-context-bill、gstack-model-benchmark、gstack-pr-wait、审查和证据账本、iOS QA 守护进程）：docs/standalone-binaries.md。备用浏览器的按站点域名技能和原始 CDP 逃生舱，以及许多技能携带的语音输入别名，都有自己的页面。
每个技能的深度解析、示例和理念 →
GBrain——为你的编码智能体提供持久知识#
GBrain 是面向 AI 智能体的持久知识库——可以把它看作智能体在会话之间真正保留的记忆。GStack 提供一条命令的路径，从零到“它跑起来了，我的智能体可以调用它”。
/setup-gbrain
四种设置路径、按仓库信任策略和记忆同步，简要说明：docs/gbrain-quick-tour.md。完整内容——每个场景、每个标志、每个 bin 辅助工具、每个故障排查步骤：USING_GBRAIN_WITH_GSTACK.md
其他参考：docs/gbrain-sync.md（同步专用指南）• docs/gbrain-sync-errors.md（错误索引）
平台说明#
macOS 和 Linux 获得完整支持。Windows 和 Gemini 模型获得最低支持：安装和核心技能可用，除此之外不作承诺。参见支持层级。
macOS：一切都能运行。打开并登录 Aside 浏览器（macOS 15+）时，浏览器技能、/make-pdf 和 /diagram 会使用它和你的真实会话；否则它们使用 ./setup 构建的捆绑浏览器。gstack 从不安装 Aside。
Linux：一切都在捆绑浏览器上运行；Aside 仅限 macOS，因此就绪探测会报一次 NEEDS_ASIDE: Linux，之后技能使用 gstack 自己的 Chromium。如果 Chromium 能安装但无法启动，因为主机阻止非特权用户命名空间（Ubuntu 24.04+ AppArmor 默认），设置 GSTACK_CHROMIUM_NO_SANDBOX=1。
Windows 用户：gstack 可通过 Git Bash 或 WSL 在 Windows 11 上工作。Aside 仅限 macOS，因此在 Windows（和 Linux）上，浏览器技能、/make-pdf 和 /diagram 总是使用 gstack 的捆绑浏览器。除 Bun 外还需要 Node.js——Bun 在 Windows 上与 Playwright 的管道传输存在已知缺陷（bun#4253）。浏览服务器会自动回退到 Node.js。确保 bun 和 node 都在 PATH 中。原生 /cso 还需要 PowerShell（首选 PowerShell 7 pwsh；Windows PowerShell 5.1 为后备）和带有“使用 C++ 的桌面开发”工作负载的 Visual Studio 2022 Build Tools；它们缺失时，setup 会让该技能明确不可用。/cso 是可选的：如果其原生辅助工具构建或发布失败，setup 仍会完成，说明哪一步失败、日志路径和重试命令，并在已有早期辅助工具时保留它（GSTACK_STRICT_BUILD=1 会让该失败致命，CI 就是这样）。
已知问题：Windows Smart App Control（#2595）。gstack 的编译二进制（browse、find-browse、design、pdf、gstack-global-discover）在你的机器上构建且未签名，因此开启 Smart App Control 的 Windows 11 会拒绝启动它们；Git Bash 显示 Permission denied。setup 会检测到这一点，列出被阻止的二进制和需要它们的技能，gstack-doctor 会把它们报告为 blocked。目前的变通方法是在 WSL 中运行 gstack，或关闭 Smart App Control。详情：故障排查。侧边栏终端在 Windows 上使用 Consolas，因此文本不再渲染得间距过大。
在 PowerShell 中，.\setup.ps1（参数与 ./setup 相同）会检查 Git for Windows、Bun 和 Node.js 是否在 PATH 中，为任何缺失项打印 winget 命令，否则在 Git Bash 中运行 ./setup。
在没有开发者模式的 Windows 上（MSYS2 / Git Bash），setup 会回退到文件复制而不是符号链接，因为 ln -snf 会产生在 git pull 后不刷新的冻结副本。每次 git pull 后重新运行 cd ~/.claude/skills/gstack && ./setup，让你的技能文件与仓库匹配。setup 会打印一行提示提醒你。Unix 和 WSL 保留符号链接，无需重新运行。
文档#
| 文档 | 内容 |
|---|---|
| 技能深度解析 | 每个技能的理念、示例和工作流（包括针对 Greptile、CodeRabbit 和其他机器人的审查机器人分诊） |
| 推荐的运行环境 | gstack + Capy 从零到第一次合并列车：安装、Captain 及其 Drive、列车、每日不稳定测试修复、每周两次发布、工厂记分卡、Capy 特有内容、已知 Capy 限制 |
| gstack + Capy：软件工厂 | 我们用 Capy Captains 和 gstack 构建了什么，各部分如何组合，实测前后对比，提示，以及 Garry 如何使用 |
| Why gstack | 故事、生产力数字及其注意事项、Karpathy 的故障模式、并行冲刺 |
| 安装细节 | 设置耗时、详细要求、团队模式、setup 注册的钩子、智能体运行环境注册 |
| 其他智能体 | 智能体运行环境（OpenClaw、Hermes、dots、QM、Muse Code、Grok、任何其他）、OpenClaw 与 ClawHub、按主机说明、Codex 配置和模型层级、外部审查提供商、设计二进制的模型 |
| 没有网页的 QA | 在 CLI、API、任务、worker 和 webhook 上使用 /qa 和 /qa-only |
| 独立二进制 | 独立的 gstack-* CLI（出口审计器、上下文账单、模型基准、审查和证据账本、iOS QA 守护进程），以及 CSO 评估生产者契约 |
| 隐私与遥测 | 发送什么，绝不发送什么，更新检查，外部审查，出口回执 |
| 卸载 | 卸载脚本和手动移除 |
| 图表与文档格式 | PDF 中的 Mermaid/excalidraw 围栏、图像尺寸和安全默认值、--to html / --to docx、/diagram 三件套 |
| 首次生产部署 | 当 /setup-deploy 说尚未部署时该做什么：托管、环境和密钥、DNS、检查它可用，然后回到 /setup-deploy |
| Builder Ethos | 构建者理念：煮海（Boil the Ocean）、构建前先搜索、三层知识 |
| GBrain 快速导览 | 四种设置路径、MCP 注册、按仓库信任策略、记忆同步、Conductor 环境变量 |
| 在 GStack 中使用 GBrain | /setup-gbrain 的每条路径、标志、bin 辅助工具和故障排查步骤 |
| GBrain 同步 | 跨机器记忆设置、隐私模式、故障排查 |
| 架构 | 设计决策和系统内部 |
| 浏览器 | gstack 如何优先驱动 Aside（契约、手册、渲染、研究），备用引擎何时介入，以及备用引擎的完整 $B 命令参考 |
| 贡献 | 开发设置、测试、贡献者模式、开发模式 |
| 值得记住的回忆桥 | 通过 gstack 的可选第三方工作流记忆：两次同意、gstack 移交什么并能证明什么、移除、故障排查 |
| 故障排查 | 每条 not run / unavailable 消息的含义和修复方法 |
| 运行 Captain 团队 | 一个控制器，Capy 上的多条泳道：drive 布局、CREW.md、READY 契约、合并列车、批准、摘要和每日不稳定测试修复，附模板 |
| 变更日志 | 每个版本的新内容 |
隐私与遥测#
除非你选择加入，gstack 不会发送任何关于你如何使用它的信息。遥测默认关闭，只会询问一次；更新检查（两到三次 GitHub 请求：一次 git ls-remote、获取 VERSION，以及当该版本等于你的版本但 main 已移动时的一次 compare-API 调用；开启遥测时还会报告你的 gstack 版本和操作系统；默认开启）可通过 gstack-config set update_check false 关闭；外部审查（默认开启；第一次会打印通知）在你的登录下把代码发送给 Codex 或 Claude Code，可通过 gstack-config set codex_reviews disabled 关闭。每次离开本机的发送都会写一条回执，你可以用 gstack-egress list 审计。完整说明，包括遥测携带的确切字段以及不属于遥测的本地状态：docs/privacy.md。
故障排查#
不知道哪里出了问题？运行诊断：~/.claude/skills/gstack/bin/gstack-doctor
（在其他主机上，gstack 检出目录中的 ./setup --status 会以诊断的绝对路径结尾）。它不会启动技能或花费任何东西；每项检查打印一行（安装、状态根目录、Bun、钩子、Codex 及其缓存的模型探测、产物同步、浏览包、其他编译二进制、/cso 原生辅助工具、Claude Code、你最大的会话日志和最近的 /autoplan 守卫代码），每项为 ok、warn、not configured 或 fail，并附上修复命令。只有 fail 时它以非零状态退出。--live 还会运行付费的 Codex 模型检查（一次短调用）。把输出粘贴到缺陷报告中。
某条消息说 not run、unavailable 或提到修复方法？在 docs/troubleshooting.md 中查找：gstack 打印的每条门禁消息、它的含义、保留了什么，以及修复命令。
Claude 说看不到技能？检查它们已安装（ls ~/.claude/skills）并重启 Claude Code；它会列出每个已安装技能及其描述，因此 CLAUDE.md 不需要逐一枚举（粘贴的列表会随每次发布而过时）。你项目的 CLAUDE.md 只需要浏览规则：
## gstack
Use /browse from gstack for all web browsing. Never use mcp__claude-in-chrome__* tools.如果旧的安装提示在 CLAUDE.md 留下了一行“Available skills:”，删掉它。
技能不显示、安装陈旧、Codex 技能描述、前缀模式、禁用技能、Chromium 安装问题：快速答案。
免费，MIT 许可，开源。没有高级版，没有等候名单。
我开源了我构建软件的方式。你可以分叉它，让它成为你的。
我们在招聘。想以 AI 编码速度交付真实产品，并帮助强化 gstack 吗？ 来 YC 工作——ycombinator.com/software 极具竞争力的薪资和股权。旧金山，Dogpatch 区。
许可证#
MIT。永久免费。去构建点什么吧。
关于#
使用 Garry Tan 的精确 Claude Code 设置：23 个有主见的工具，充当 CEO、设计师、工程经理、发布经理、文档工程师和 QA。