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 --jsoncomet 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、不流转。
  • 推荐仅供参考——推荐规则不能替代你的确认。

下一步

最后修改于 2026年7月24日