gstack 工作流全景图

虚拟工程团队 · 运行时基础设施 · Think -> Plan -> Build -> Review -> Test -> Ship -> Reflect

核心心智模型

gstack 不是单个技能包,而是 Claude Code 上的软件工厂。

它把一个产品交付过程拆成多个专家角色:YC 合伙人、CEO、工程经理、设计师、QA、安全、发布工程师、SRE。

关键词:完整性、真实浏览器、审查流水线、持续学习。

运行时层

每个技能前面都有厚重 preamble:

  • 自动更新检查
  • repo mode / branch / session 识别
  • telemetry / analytics
  • project learnings 注入
  • skill routing 提示
  • gbrain context queries

这让技能像应用,不只是提示词。

建造哲学

来自 ETHOS.md 的三条底层偏好:

  • Boil the Lake:AI 让完整实现的边际成本变低
  • Search Before Building:先查已有方案
  • User Sovereignty:模型推荐,用户决定

所以 gstack 倾向扩大审查和验证,而不是最小仪式。

拆解依据

来源仓库:garrytan/gstack

重点读取:

  • README.md:The sprint 与技能总表
  • ETHOS.md:Boil the Lake / Search / User Sovereignty
  • ARCHITECTURE.md:浏览器 daemon 与安全模型
  • SKILL.md 与各 SKILL.md.tmpl:preamble、routing、具体流程
  • docs/OPENCLAW.md:跨 agent 分层派发

0. 安装与路由

./setup 安装到多个 host:Claude Code、Codex、Cursor、OpenCode 等。

Team mode 会把 gstack 作为 repo 约定写入 CLAUDE.md。

作用:让 agent 在看到任务时能主动建议或调用对应 slash command。

CEO Review

/plan-ceo-review

重审问题和野心:

  • Expansion
  • Selective expansion
  • Hold scope
  • Reduction

看这个计划是否值得做、是否太小、是否错过 10-star product。

Eng Review

/plan-eng-review

工程经理模式:

  • 架构图
  • 数据流
  • 状态机
  • 错误路径
  • 测试矩阵

把隐性工程假设变成可审查的计划。

1. Think

/office-hours

两种模式:

  • Startup / intrapreneurship:六个 YC forcing questions
  • Builder:设计思考式 brainstorm

产物:design doc。

硬门禁:此阶段不写代码,只把问题和 wedge 讲清楚。

Design Review

/plan-design-review

计划阶段的设计审查:

  • 设计维度打分
  • AI slop 检测
  • 具体到界面选择
  • 通过 AskUserQuestion 保留 taste 判断

后续可接 /design-review 做真实页面修复。

DX Review

/plan-devex-review

面向开发者产品:

  • persona
  • time to hello world
  • 魔法时刻
  • 摩擦点追踪

对应 live audit 是 /devex-review。

3. Build

gstack 本身不把写代码封装成一个单独技能,而是让 Claude Code 执行被 review 过的计划。

关键约束:

  • 先理解项目指令
  • 遵守计划与 decision log
  • 遇到 taste / 用户方向变更时回问
  • 完整实现 blast radius 内的问题

4. Review

核心技能:

  • /review:staff engineer 找生产级 bug
  • /codex:跨模型 second opinion
  • /cso:OWASP + STRIDE 安全审计

倾向:自动修明显问题,复杂或方向性问题交给用户。

5. Test

真实反馈回路:

  • /qa:浏览器里点真实流程,找 bug 并修复
  • /qa-only:只报告,不改代码
  • /benchmark:性能基线与回归
  • /browse:给 agent 眼睛、截图和交互能力

这是 gstack 区别于纯 prompt 包的关键。

6. Ship

发布工程师链路:

  • /ship:同步 main、跑测试、补测试框架、push、开 PR
  • /setup-deploy:一次性配置部署信息
  • /document-release:把文档更新到刚发布的行为

目标是把交付末端也流程化。

7. Deploy

生产闭环:

  • /land-and-deploy:合并 PR,等待 CI / deploy,验证生产健康
  • /canary:部署后持续监控页面、console、性能、截图

从 approved PR 到 production verified。

8. Reflect

长期复利:

  • /retro:周度工程复盘
  • /learn:查看、搜索、修剪 project learnings
  • /context-save / /context-restore:保存和恢复会话上下文
  • /skillify:把成功套路固化为新技能

每次交付都反哺下一次。

横切能力 A:浏览器系统

/browse 背后是长驻 Chromium daemon:

  • 首次启动,后续命令 100-200ms
  • cookies / tabs / localStorage 持久
  • 本地 HTTP + CDP
  • 截图、表单、dialog、responsive、network、console

/pair-agent 还能把浏览器 tab 共享给远程 agent。

横切能力 B:安全护栏

  • /careful:危险命令前提醒
  • /freeze:限制编辑目录
  • /guard:careful + freeze
  • /unfreeze:解除边界
  • /cso:安全审计

/investigate 还会在确认根因后锁定 debug scope,防止修 bug 时扩散。

横切能力 C:调查式调试

/investigate 的铁律: NO FIXES WITHOUT ROOT CAUSE。

流程:

  1. 收集症状和近期变更
  2. 复现并提出可验证假设
  3. 用日志/断言验证
  4. 锁定 scope 后修根因
  5. 写 regression test
  6. fresh verification + report

横切能力 D:设计生产线

  • /design-consultation:从零建立设计系统
  • /design-shotgun:生成 4-6 个方向,让用户选 taste
  • /design-html:把 mockup 变成可运行 HTML
  • /design-review:真实页面审查与修复

这是产品 taste 被显式化、记忆化的子系统。

横切能力 E:记忆与上下文

gstack 会维护:

  • ~/.gstack/projects/{slug}/learnings.jsonl
  • timeline / analytics
  • builder profile / taste profile
  • gbrain repo indexing 与 context queries

技能启动时读取相关学习,减少重复踩坑。

横切能力 F:跨 agent 适配

gstack 支持多 host 安装,并为 OpenClaw 定义分层派发:

  • Simple:不用 gstack
  • Medium:gstack-lite planning discipline
  • Heavy:指定 /skill
  • Full:/autoplan -> implement -> /ship
  • Plan:只产出 reviewed plan

提示词就是桥。

代价与风险

优势:端到端、真实反馈、角色齐全、能积累记忆。

代价:

  • 流程重,适合大任务多于小修小补
  • opinionated,默认偏完整实现
  • 运行时复杂度高:daemon、配置、telemetry、learn files
  • 需要用户能判断何时接受扩大 scope

2. Plan

/autoplan

自动跑完整 review gauntlet: CEO -> Design -> Eng -> DX。

用 6 条原则自动回答中间问题:

  • completeness
  • boil lakes
  • pragmatic
  • DRY
  • explicit
  • action bias

Taste / User Challenge 留给用户最终拍板。

idea / taskdesign docreview 1scope settleddesign constraintsarchitectureapproved plandiff passesbrowser + tests passPR approvedprod verifiedfindingsbugroot cause fixreal UI evidencescope locktaste loopprior learningslog patterns