gstack 中文架构总览
这张 canvas 把项目拆成 6 个视角：
- 源模板与规则
- 生成与构建
- 多宿主安装与分发
- 运行时技能执行
- 持久化工件与知识平面
- 端到端工作流链
建议从右侧的 Markdown 总图谱开始，再沿连线阅读关键文件。
1. 源定义层
核心思想：用模板与规则定义技能，而不是手写多份宿主输出。
包含：
- 根模板
- 各 skill 模板
- review / qa 参考规则
- browse 命令注册表
- 中文文档层
2. 生成与构建层
这里把模板、命令表、snapshot 标志和宿主路径规则合成为最终技能文档与二进制产物。
关键动作：
- placeholder 解析
- Claude / Codex 路径改写
- browse 二进制编译
- server bundle 生成
3. 安装与宿主分发
setup 负责：
- 构建 browse
- 安装 Playwright Chromium
- 链接 Claude / Codex skills
- 创建
.agents/skills/gstack/*sidecar
这是“文本技能”变成“真实可运行系统”的关键桥梁。
4. 运行时执行层
技能运行时统一经过：
- 公共前言（升级、telemetry、AskUserQuestion、完整性原则）
- 专项流程（review / qa / ship / plan）
- browse 浏览器能力
- Git / GitHub / gh 集成
- 可选 Codex 第二意见
5. 持久化知识平面
~/.gstack/ 不是边角缓存，而是系统记忆：
- design docs
- review logs
- QA outcomes
- telemetry
- contributor logs
- retro history
这是 gstack 能跨阶段衔接的根本原因。
关键目录：
~/.gstack/projects/~/.gstack/analytics/~/.gstack/contributor-logs/~/.gstack/sessions/
关键工件：
- 设计文档
- QA 报告
- review readiness
- telemetry 与 pending marker
6. 核心工作流链
/office-hours
→ /plan-ceo-review
→ /plan-eng-review
→ 编码执行
→ /review
→ /qa
→ /ship
→ /document-release
→ /retro
横切能力：
/browse/investigate/careful//freeze//guard/codex