Worktree 检查点

每个 DevAgent worktree 都带有一个轻量的、自由文本的 comment 字段，在 UI 中可见——它是该 worktree 当前正在做什么的状态快照。agent 可以从 CLI 更新它，这也是我们推荐用来让人类协作者随时了解进展、又无需强制聊天的模式。

模式

devcore worktree set --worktree active --comment "reproduced auth failure; testing credential-chain fix" --json

卡片状态（可选）

在自由文本 comment 之外，当阶段发生变化时设置 workspace 卡片状态：

devcore worktree set --worktree active \
  --comment "fix implemented; running integration tests" \
  --workspace-status in-progress \
  --json

状态：todo、in-progress、in-review、completed（或你的 workspace 所用的自定义 id）。

适合设检查点的时机

• 完成了一个有意义的实现切片。
• 证实或推翻了某个假设。
• 完成了一次代码审查。
• 遇到了阻塞（等待外部输入、上游 bug、缺少访问权限）。
• 从调查转向修复，或从修复转向验证。

格式

第一行是行动：刚刚发生了什么、在哪里，以及状态或下一步。

devcore worktree set --worktree active --comment "added debounce to SearchBar onChange (src/components/SearchBar.tsx); ready for review
goal: reduce redundant API calls per #298" --json

先读后写

如果 comment 中可能包含用户写入的上下文，先读取它，以免覆盖掉目标或约束：

devcore worktree current --json

保留仍然有效的内容，删除已过期的部分，并把你的更新融入其中。