你会看到什么样的提问
在支持结构化提问的平台上,例如 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 — proposal/design/tasks 审视(含名称和范围)
0.4.0-beta.5 起,open 阶段的需求澄清和命名默认非阻塞
。范围和命名都明确时直接继续,不再单独暂停让你确认摘要或名称;最终审视会一次性确认名称、范围和三个文档。只有当仍存在会改变范围或目标
change 身份的互斥选择时,才会用一次联合提问。明确请求(clear request)会跳过产物前的命名确认。
design 阶段停顿点
5 — 设计方案确认
确认前不创建 Design Doc、不写
design_doc、不跑 guard。
Step 1e
主动式上下文压缩时,如果平台不支持程序化触发,也会暂停让你手动压缩。这不算产品决策点,但需要你确认压缩完成。
build 阶段停顿点
5 — build 联合决策
一次性联合决定 plan-ready 和全部工作模式:plan-ready 选择
comet 考虑了用户真实的使用场景,允许用户用高级模型做规划,用低级模型做执行,支持切换模型后跨设备 0 上下文恢复执行。
隔离方式
执行方式
TDD 模式
审查模式
分支名
选择 branch 隔离时,让你确认或覆盖推荐的分支名:-
full →
feature/YYYYMMDD/<name> -
hotfix →
hotfix/YYYYMMDD/<name> -
tweak →
tweak/YYYYMMDD/<name>0.4.0-beta.5 把 plan-ready 和工作模式合并为一次联合决策,避免分两次暂停。推荐规则仅供参考,不能替代你的确认。
6 — spec 漂移拆分决策
执行中发现新任务超过初始 tasks.md 的 50% 时,强制让你选择:verify 阶段停顿点
7 — 验证例外决策
0.4.0-beta.5 起验证失败按以下规则分类处理:
CRITICAL 和 IMPORTANT 发现永不可豁免。只有接受 WARNING/SUGGESTION 偏差或第 4 次失败后的策略选择才需要你介入。连续失败计数由 machine-owned 的
verify_failures 字段持久化,跨恢复保留。
spec 漂移处理(仅 full 检查 6,属于停顿点 7 的一种触发)
delta spec 与 Design Doc 矛盾时三选一:archive 阶段停顿点
8 — 归档与交付最终确认
branch_status: handled 表示交付方式已经确认,不表示 push 或 PR 已经成功。Comet
在归档完成后、唯一归档提交前写入它;只有选定的远端操作成功后才清除 current selection
并宣告完成。归档阶段不再加载 finishing-a-development-branch。无论
auto_transition 是 auto 还是 manual,归档前都会执行停顿点
8。验证通过不会自动归档。升级信号停顿点(仅 hotfix/tweak)
9 — 升级评估
停顿点规则
所有停顿点遵循comet/reference/decision-point.md 协议。0.4.0-beta.5 起协议先判断是否真的需要用户输入:
- 用户决策——两个或更多有效选项会改变范围、行为、可接受风险或不可逆结果,必须你选。
- 自动处理——请求内只剩一个安全的下一步(修复客观失败、调和可验证状态、重试幂等检查、遵循已持久化配置),直接执行并报告,不制造确认。
- 停止条件——缺少依赖、状态损坏、路径逃逸或外部命令不可用,没有有效下一步,报告阻塞和恢复条件。
- 手动交接——
NEXT: manual只交还控制权,不是新的用户决策点;打印 HINT 并结束当前调用,不问”是否继续”。
- 必须暂停——不能基于推荐、默认值或当前状态自动选择。
- 优先用结构化提问——平台支持时展示可点击的单选/多选;不可用时降级为编号文本选项。
- 降级只判定一次——如果第一次结构化提问失败,本会话后续停顿点直接用文本选项。
- 选择前不推进——不创建产物、不跑 guard、不流转。
- 推荐仅供参考——推荐规则不能替代你的确认。
下一步
- open 阶段 — open 的停顿点
- build 阶段 — build 的联合决策
- verify 阶段 — verify 的验证例外决策
- archive 阶段 — archive 的归档与远端交付确认
- 工作流概念 — 用户参与的阻塞点总览

