现象

今天用 Claude Code 时,会话一上来就带了系统提醒:当前在一个 git worktree 里,并写明了 worktree 路径和名字。我丢给它的问题很短:

这个 issue 做完了吗?

后面跟的是主仓里的一个公开 issue 链接。

表面上看这只是「问进度」。在多 worktree、多 Agent 并行的用法里,这其实是一类固定操作:把人和 Agent 都钉在同一棵树上,再问可核验的完成态。

为什么 worktree 提醒很重要

Claude Code / Codex 一旦并行,最常见的混乱不是模型答错,而是:

  1. Agent A 在 worktree-1 改代码
  2. 你在主工作区看 git status,以为没动
  3. 另一个会话在 worktree-2 跑测试,测的是旧树
  4. issue 评论里说「做完了」,CI 却还在另一棵树上挂着

系统把 worktree 名字打在会话开头,等于强制对齐坐标系。你提问时最好也带上同一坐标系,而不是只丢一个 issue 号。

我实际怎么问「做完了吗」

短问可以,但要可核验。我现在的模板是三行:

  1. 树:就在当前 worktree(或明确写出名字),不要切走。
  2. 对象:这个 issue 链接。
  3. 完成态:对应 PR 是否已开、CI 是否绿、issue 验收条是否逐条勾上;没有 PR 就说还缺哪一步。

这样 Agent 不能用「我觉得差不多了」糊弄。它必须去看分支、PR、检查项。

并行时我额外守的三条

  • 一棵树一个目标。 同一个 worktree 里不要塞两个无关 issue,否则摘要和 diff 会缠在一起。
  • 问进度前先对齐 cwd。 让它先回 pwd 和当前分支,再谈 issue。
  • 「做完」以仓库状态为准,不以聊天语气为准。 聊天里的「好了」只算线索;PR、测试、issue 关闭条件才算数。

这和我在 App 自动化里踩过的坑是同一类:点击成功 ≠ 业务成功。换到代码协作,就是「Agent 说做完了 ≠ issue 验收过了」。

和 Codex 长循环怎么分工

近两天我两边都在用:

  • Claude Code + worktree:适合钉住单个 issue、做完可审查的一小片改动。
  • Codex 长目标循环:适合同一工作区内反复推进(例如长篇审改、大批量机械改动)。

混用时更要写清树和目标。否则 Claude 在 A 树修 issue,Codex 在 B 树按旧假设继续改,合并时才发现俩人活在平行宇宙。

有没有用

有用的是流程,不是某个模型更聪明:

  • 减少「改丢了」和「测错树」
  • 让「做完了吗」变成可检查问题
  • 给人一个中途介入的钩子:抽检 PR,而不是抽检聊天

成本上,worktree 本身几乎免费;贵的是你不对齐坐标系时浪费的重做次数。


相关阅读:《我让电脑自动领 App 每日奖励,结果卡在「点击成功」上》、《把没做完的任务交给另一个 Agent,什么才算完整交接》、《Harness 才是真模型:我的 Claude Code / Codex 交接包模板》。

口径:worktree 系统提醒与「issue 是否做完」的提问,来自 2026-11-05 的 Claude Code 会话;不展开具体仓库私有实现与未公开分支名。公开 issue 只作为「用链接钉对象」的用法说明。