双航道工作流

代码航道(Code):带硬闸的研发交付

了解 Munk AI 如何将需求转化为隔离 Git Worktree 中的编码任务,并通过自动化门禁与人工审批保障交付质量。

在普通聊天工具里让 AI 改代码,往往聊着聊着就偏离了初衷,或者改坏了主分支却难以收拾。Munk AI 的 代码航道(Code) 把研发过程变成一条受控的流水线:隔离开发、门禁验货、人类拍板。

核心概念

概念说明
产品仓库(Codebase)绑定到本机的 Git 仓库,对应一条具体的产品线。
工作项(Work Item)一件具体的研发任务(新功能、重构或 Bug 修复)。可以从手动输入、GitHub Issue 或运营班次创建。
执行轮次(Run)工作项的一次完整流水线执行。每个工作项都在独立的 Git Worktree 中运行,绝不污染你的主工作区。

四栏研发工作台(Workbench)

进入代码工作台后,界面按职责分为四个区域,让你一眼看清全局进度:

代码工作台

  1. 左侧导航与工作项列表:切换产品线,查看当前正在推进或等待拍板的研发工作项。
  2. 中栏:阶段对话与执行证据:每个对话阶段对应一条独立的 Agent 会话;进入 Code Gates 阶段时,这里会展示只读的构建与测试输出日志。
  3. 右上:Workflow 阶段图:实时显示当前 Run 走到哪一步。遇到需要你拍板的硬闸时,节点旁会直接弹出操作浮层。
  4. 右下:代码树与 Diff 审查:随时查看 Agent 在隔离 Worktree 中新增或修改的每一行代码。

阶段流转与质量硬闸

一条典型的工作项会按以下线性阶段推进:

Intake(需求澄清) → Plan(可选规划) → Coding(隔离编码) → Code Gates(自动化门禁) → Delivery(受控交付)
                                             ↑                      │
                                             └──── 门禁未通过自动再入 ─┘

1. Intake:先定边界,再动手写代码

你提出想法后,Intake Agent 会先阅读代码库现状,向你追问不清楚的细节,并整理出一份结构化的需求说明(prd.md)。只有需求明确后,才会交棒给后续阶段。如果你中途改变主意,随时可以退回 Intake 修改需求。

2. Coding 与 Code Gates:不过门禁不交货

Coding Agent 在独立的 Git Worktree 中完成代码编写后,宿主会自动执行 Code Gates(代码门禁)——例如运行 typecheck、lint、单元测试或打包检查。

  • 未通过门禁:宿主会自动把报错信息带回同一个 Coding 会话,让 Agent 定向修复,直到门禁全绿。
  • 通过门禁:只有当所有自动化检查全部通过后,交付阶段(Delivery)才会解锁。

3. Delivery 与人闸(Human Checkpoints):关键动作你说了算

门禁通过后,Agent 会整理本次改动摘要,并在关键动作前停下来等待你拍板(Waiting):

  • 安全边界:编码 Agent 的命令行禁止携带密钥强推远端分支,也禁止自动合并远端 GitHub PR。
  • 受控交付:提交代码、合并回本地主分支(Local Merge)、推送特性分支或创建 Draft PR,均通过宿主的安全接口执行,并在关键节点由你在 Workflow 浮层 或 收件箱(Inbox) 中点击确认。

相关文档