跳转到主要内容
恢复探测是一个只读步骤,对应的 CLI 命令是 comet resume-probe。它读取活跃 change、.comet.yaml、当前阶段、工作树状态和用户请求,再给出是否适合恢复已有 Comet workflow 的判断。 它不会修改 change、推进阶段、替你选择多个 change,也不会自动执行返回的下一条命令。

基本用法

comet resume-probe . --utterance "继续刚才的登录重构"
如果请求来自标准输入:
echo "继续刚才的登录重构" | comet resume-probe . --stdin --json
常用选项:
选项作用
--utterance <text>直接传入需要分类的用户请求
--stdin从标准输入读取用户请求
--json输出稳定的结构化结果,适合 Agent、hooks 和自动化
--no-workflow-work把当前请求标记为信息查询,而不是需要推进 workflow 的工作
--already-in-comet-flow当前已经在 Comet 流程内时返回 out_of_scope,避免重复路由

如何理解结果

action含义下一步
auto_resume只有一个明确相关的 active change,且不在决策点Agent 可以按 JSON 字段 nextCommand 路由到对应 /comet-* Skill
ask_user存在多个 active change、未提交改动、状态异常或必须由用户决定的停顿点先向用户确认,不要自行选择或推进
out_of_scope用户明确不想恢复、当前已在 Comet 内,或请求只是与 workflow 无关的信息查询正常回答当前请求,不进入 Comet
none没有 active Comet change不执行恢复;如需开始新工作,可显式运行 /comet
文本输出同时包含 confidencereason,以及适用时的 changephasenext。JSON 输出中的后续命令字段名为 nextCommand,同时还包含判断证据,便于调用方解释为什么恢复或暂停。

哪些情况一定会暂停

  • 多个 active change,但用户请求没有点名目标。
  • 工作树有未提交改动,需要先判断归属。
  • active change 缺少有效 Comet 状态。
  • 当前处于 plan-ready、验证失败、归档确认等用户决策点。
  • 请求与唯一 active change 看起来无关。
ask_user 不是错误。它表示证据不足或流程正在等待用户选择;调用方应展示原因并询问用户,而不是反复运行恢复探测。

与其他命令的区别

命令用途
/comet显式开始或恢复 workflow,并路由到正确阶段
comet resume-probe在进入 workflow 前做一次只读恢复探测
comet status查看 active change、阶段、证据和推荐下一步
comet doctor诊断安装、环境或状态损坏

下一步

最后修改于 2026年7月12日