Skip to main content
Comet 会自动推进无歧义的阶段,并把产品或风险决策交给你。每个需要你介入的地方都是一个停顿点(blocking decision point):Comet 暂停并等待你选择,收到选择后再继续。 本页完整列出五阶段的所有停顿点,方便你在使用前知道哪些地方需要参与。

你会看到什么样的提问

在支持结构化提问的平台上,例如 Claude Code,Comet 会优先把停顿点展示成可点击的单选或多选问题。你会看到每个选项的短标签和影响说明;推荐项用于辅助判断,最终选择始终由你确认。
如果你在某个平台上只看到编号列表,这不是流程降级。它只是输入界面从可点击选项退回文本编号;阻塞规则、选项含义和状态写入门禁都保持一致。

停顿点总览

下面按阶段顺序列出所有停顿点。每个阶段的停顿点按发生先后排列,前一阶段的最后一个停顿点通过后才会进入下一阶段。
0.4.0-beta.5 起,Comet 只在真正的用户决策点暂停。 前 3 次可修复的验证失败、单一安全的下一步、遵循已持久化配置的操作都会自动处理,不再逐次询问。 auto_transition: false 产生的 NEXT: manual 只是交还控制权。 它不是用户决策点,不会问”是否继续”。

路由阶段

open 阶段

design 阶段

build 阶段

verify 阶段

archive 阶段

升级信号(仅 hotfix/tweak)

小鱼在五阶段路径上的停顿点路牌前等待用户确认

自动推进只处理无歧义衔接,遇到停顿点必须等你确认后再继续

路由阶段停顿点

1 — workflow 目标选择

Comet 只在存在真正歧义时才暂停;只有一个明确相关的 active change 时会直接建议恢复。

open 阶段停顿点

2 — PRD 拆分预检查

选项: 确认前不创建任何 artifact。每个拆分项完成后会通过 openspec status --json 和 comet state check 双重校验,全部通过才宣布拆分完成。详见大型 PRD 拆分。

3 — 工作区决策

你明确表达并行意图时直接使用 worktree,不再单独询问;未明确时把 current、branch、worktree 作为一次决策提供。

4 — proposal/design/tasks 审视(含名称和范围)

0.4.0-beta.5 起,open 阶段的需求澄清和命名默认非阻塞 。范围和命名都明确时直接继续,不再单独暂停让你确认摘要或名称;最终审视会一次性确认名称、范围和三个文档。只有当仍存在会改变范围或目标 change 身份的互斥选择时,才会用一次联合提问。明确请求(clear request)会跳过产物前的命名确认。

design 阶段停顿点

5 — 设计方案确认

确认前不创建 Design Doc、不写 design_doc、不跑 guard。
主动式上下文压缩发生在 Design Doc、状态和 handoff 全部落盘之后(进入 build 前)。平台不支持自动触发压缩时,Comet 只给一条非阻塞的压缩建议并继续,不会为此增加确认点。

build 阶段停顿点

6 — build 联合决策

一次性联合决定 plan-ready 和执行相关的工作模式。工作区隔离已在 open 阶段的工作区决策(停顿点 3)确定,这里不再询问:

plan-ready 选择

Comet 允许你用高级模型做规划、低级模型做执行,支持切换模型后跨设备零上下文恢复执行。

执行方式

TDD 模式

审查模式

0.4.0-beta.5 把 plan-ready 和工作模式合并为一次联合决策,避免分两次暂停。推荐规则仅供参考,不能替代你的确认。选择 branch/worktree 隔离时,分支名沿用你在 open 阶段工作区决策中确认的值。

7 — spec 漂移拆分决策

执行中发现新任务超过初始 tasks.md 的 50% 时,强制让你选择:

verify 阶段停顿点

8 — 验证例外决策

0.4.0-beta.5 起验证失败按以下规则分类处理: CRITICAL 和 IMPORTANT 发现永不可豁免。只有接受 WARNING/SUGGESTION 偏差或第 4 次失败后的策略选择才需要你介入。连续失败计数由 Comet 自动维护的 verify_failures 字段持久化,跨恢复保留。

spec 漂移处理(仅 full 检查 6,属于停顿点 8 的一种触发)

delta spec 与 Design Doc 矛盾时三选一:

archive 阶段停顿点

9 — 归档与交付最终确认

branch_status: handled 表示交付方式已经确认,不表示 push 或 PR 已经成功。Comet 在归档完成后、唯一归档提交前写入它;只有选定的远端操作成功后才清除 current selection 并宣告完成。归档阶段不再加载 finishing-a-development-branch。
无论 auto_transition 是 auto 还是 manual,归档前都会执行停顿点 9。验证通过不会自动归档。

升级信号停顿点(仅 hotfix/tweak)

10 — 升级评估

停顿点规则

所有停顿点遵循同一套协议。0.4.0-beta.5 起,协议先判断是否真的需要用户输入:
  • 用户决策:两个或更多有效选项会改变范围、行为、可接受风险或不可逆结果,必须你选。
  • 自动处理:请求内只剩一个安全的下一步(修复客观失败、核对状态一致性、重试幂等检查、遵循已持久化配置),直接执行并报告,不制造确认。
  • 停止条件:缺少依赖、状态损坏、路径穿越或外部命令不可用,没有有效下一步,报告阻塞和恢复条件。
  • 手动交接:NEXT: manual 只交还控制权,不是新的用户决策点;打印 HINT 并结束当前调用,不问”是否继续”。
只有第一类用本协议的阻塞规则。能合并回答的相邻选择合并提问,不再重复问仍有效的已持久化选择。展示选项前先预检查平台能力和状态,只显示可执行的选项;某字段只有一个合法值时直接说明并应用,不单独暂停。
  • 必须暂停:不能基于推荐、默认值或当前状态自动选择。
  • 优先用结构化提问:平台支持时展示可点击的单选/多选;不可用时降级为编号文本选项。
  • 降级只判定一次:如果第一次结构化提问失败,本会话后续停顿点直接用文本选项。
  • 选择前不推进:不创建产物、不跑 guard、不流转。
  • 推荐仅供参考:推荐规则不能替代你的确认。

下一步

最后修改于 2026年9月4日