工程实践:文档任务与修 Bug 任务如何在同一工作台并行

9 阅读3分钟

问题定义

团队里很常见的冲突调度:

  • 文档债务(安装指引、变更说明)一直欠着;
  • 线上 Bug(例如订单状态偶发错写)突然插队。

若串行:修完 Bug 再写文档,或写完文档再排障,墙钟时间被拉长。
若「两个终端 + 两套 CLI」并行:上下文、分支、卡点分散在窗口里,切换成本高,待确认也容易漏。

目标状态应是:两条执行线并行,状态集中可见,人只处理决策点。 这不是「让 AI 同时更聪明」,而是把调度从操作系统窗口管理,收到工作台任务列表。

工具定位

Caravel = local-first multi-agent workbench。
它不替换 Claude Code / Codex / OpenCode / pi 等 CLI,而是把多任务、多 Agent 收进工作台列表(运行中 / 待确认 / 待验收)。
Demo:caravel-site.pages.dev/
Releases:github.com/yy36295238/…

本文只覆盖能力切片:F02.02 多任务 + F04 多 Agent。不讨论 Diff 验收细节(那是另一条交付闭环),只把「并行可见」跑通。

操作路径(对应三图)

1)任务 A:补文档,先占一条运行中线

在工作台列表视图创建任务 A,目标示例:「完善新用户安装指引」。选择合适 Agent,创建并运行。确认列表出现 运行中,顶部摘要反映运行中数量。

此时不要把注意力锁死在日志滚动上——长文档类任务适合后台推进。工作台的价值是「状态挂在桌上」,不是再提供一个更大的终端滚动条。

任务A运行中

2)任务 B:修 Bug,新建时换 Agent

任务 A 仍在运行时,打开 新建任务

字段建议
工作区勾选出问题的业务仓
任务目标「修复线上订单状态偶发错写的 Bug,定位根因并补回归测试」
运行方式不确定影响面 → 隔离副本;范围极小 → 工作区
运行权限先「请求批准」,敏感动作再人工放行
Agent与任务 A 不同(文档与排障常选不同 CLI/模型)

创建并运行。关键点是「第二任务 + 另一 Agent」,避免同一会话上下文串味。目标文本尽量写清验收口径(定位根因、补回归),减少跑偏后的来回澄清。

新建修Bug任务

3)列表验收:两任务状态并排

回到工作台:任务 A 与任务 B 应同时可见,状态可能同为运行中,或一者已进入待确认/待验收。顶部「N 个任务 · M 运行中 · K 待确认」用于早会式扫描。

人的主线工作(写方案、对齐)继续;仅在待确认/待验收时切入。如果任务变多,可以再切到看板按阶段分列,但本篇最小闭环只要求列表并排可见。

两任务并排

工程收益与边界

收益

  • 墙钟时间上两条线并行;
  • 状态不依赖「记得开着哪个终端」;
  • 多 Agent 按任务类型选型,而不是一个会话通吃。

边界

  • 并行不等于免验收:仍需看 Diff,再「通过并合并」或「放弃改动」;
  • 工作台不替代代码审查与测试策略;
  • 权限卡片仍需人判断,避免为求快默认全放行;
  • 两任务若争用同一工作区文件,仍要靠隔离副本或分支策略降低打架概率。

可复制的检查清单

  1. 先启动可后台化的任务 A(文档);
  2. 立即创建紧急任务 B(Bug),Agent 与 A 不同;
  3. 列表确认两任务状态并排;
  4. 人处理方案与确认点;
  5. 分别验收 Diff,独立决定合并或放弃。

按此路径在 Demo 走通一次,再评估是否纳入你的日常调度:caravel-site.pages.dev/
github.com/yy36295238/…