跳转至

文档 / CLI / Worktree 检查点

每个 Orca worktree 都带有一个轻量级的自由文本 comment 字段，可在 UI 中查看——它是该 worktree 当前正在做什么的状态快照。Agent 可以从 CLI 更新它，这是我们推荐的让人类协作者保持知情的方式，无需强制使用聊天。

模式

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

卡片状态（可选）

除了自由文本 comment 外，当阶段变化时，设置工作区卡片状态：

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

状态：todo、in-progress、in-review、completed（或你的工作区使用的自定义 id）。

合适的检查点时机

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

格式

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

orca 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 中可能包含用户编写的上下文，请先读取它，以免覆盖目标或约束：

orca worktree current --json

保留仍然有效的内容，删除过时的内容，并融入你的更新。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 orca48/orca