跳转到主要内容
Comet 会自动推进无歧义的阶段，但不会替你做产品或风险决策。每个需要你介入的地方都是一个停顿点（blocking decision point）——Comet 暂停并等待你选择，选择前不会继续。 本页完整列出五阶段的所有停顿点，方便你在使用前知道哪些地方需要参与。

​
停顿点总览

下面按阶段顺序列出所有停顿点。每个阶段的停顿点按发生先后排列,前一阶段的最后一个停顿点通过后才会进入下一阶段。

​
open 阶段

顺序停顿点你决定什么
1PRD 拆分预检大需求是否拆成多个 change
2需求澄清完成确认澄清摘要是否足够
3change 名称确认用哪个 kebab-case 英文名
4artifacts 审视proposal/design/tasks 是否符合预期

​
design 阶段

顺序停顿点你决定什么
5设计方案确认brainstorming 的技术方案是否采用

​
build 阶段

顺序停顿点你决定什么
6plan-ready 暂停立即继续还是暂停切换模型
7工作模式选择隔离方式、执行方式、TDD 模式、审查模式
8分支名确认分支名是否接受或覆盖
9spec 漂移拆分新任务超 50% 时是否拆分新 change

​
verify 阶段

顺序停顿点你决定什么
10验证失败决策全部修复还是逐项处理
11spec 漂移处理追加说明 / 重新对齐 / 接受偏差
12分支处理合并 / PR / 保留 / 丢弃

​
archive 阶段

顺序停顿点你决定什么
13归档前确认立即归档 / 回去调整 / 暂不归档

​
open 阶段停顿点

​
1a — PRD 拆分预检

属性说明
触发输入是大型 PRD/路线图，或澄清摘要包含多个独立能力
决策是否拆分为多个 change
展示候选拆分清单（名称、目标、范围、依赖、验收场景）
选项：
选项结果
创建多个 OpenSpec changes每个拆分项用独立 /comet-open 创建
保持为一个 change继续单 change，记录不拆分原因
调整拆分方案重新输出候选清单并再次确认
确认前不创建任何 artifact。详见大型 PRD 拆分。

​
1b — 需求澄清完成确认

属性说明
触发澄清摘要形成后，创建 artifact 前
决策确认需求澄清完成
展示目标、非目标、范围边界、关键未知项、验收场景草案
确认后才能进入 Step 1c。确认前不创建 proposal/design/tasks。

​
1c — change 名称确认

属性说明
触发运行 openspec new change 前
决策选择 kebab-case 英文 change 名
展示2-3 个推荐名（各附范围说明）+ 自行输入选项
选项：
选项结果
选择推荐名直接使用
自行输入（合规 kebab-case）直接使用
自行输入（中文/非合规）转换为 kebab-case 英文并回显，确认后使用
名称冲突时报告并让你另选。确认前不运行 openspec new change 或创建 .comet.yaml。

​
5 — artifacts 审视确认

属性说明
触发proposal/design/tasks 创建完成且完整性检查通过
决策确认三个文档符合预期
展示proposal（背景/目标/范围）、design（架构/选型）、tasks（数量/关键任务）
选项结果
确认，继续下一阶段执行 guard 流转
需要调整修改后重新请求确认

​
design 阶段停顿点

​
1c — 设计方案确认

属性说明
触发brainstorming 产出设计方案后，创建 Design Doc 前
决策确认技术方案
展示采用的技术方案、关键权衡和风险、测试策略、Spec Patch（如有）
选项结果
确认进入 Step 1d 定稿，创建 Design Doc
需要调整继续 brainstorming 迭代直到确认
确认前不创建 Design Doc、不写 design_doc、不跑 guard。
Step 1e 主动式上下文压缩时，如果平台不支持程序化触发，也会暂停让你手动压缩。这不算产品决策点，但需要你确认压缩完成。

​
build 阶段停顿点

​
2 — plan-ready 暂停

属性说明
触发实施计划写入文件后，选择隔离和执行方式前
决策立即继续还是暂停切换模型
展示计划已生成的提示
选项结果
A：继续执行设 build_pause: null，进入 Step 3
B：暂停切换模型设 build_pause: plan-ready，停止，稍后 /comet 恢复
恢复时 build_pause: plan-ready + 计划存在：不重新生成计划，确认后设 build_pause: null 继续。

​
3 — 工作模式选择

一次性询问四项：

​
隔离方式

选项说明
branch当前仓库创建分支
worktree独立工作区，可并行开发

​
执行方式

选项说明
subagent-driven-development后台子代理实现，双阶段审查
executing-plans轻量执行
direct直接实现（仅 hotfix/tweak）

​
TDD 模式

选项说明
tdd先写失败测试
direct直接实现

​
审查模式

选项说明
off / standard / thorough见代码审查机制
推荐规则仅供参考，不能替代你的确认。

​
分支名确认

选择 branch 隔离时，让你确认或覆盖推荐的分支名：
  • full → feature/YYYYMMDD/<name>
  • hotfix → hotfix/YYYYMMDD/<name>
  • tweak → tweak/YYYYMMDD/<name>

​
4 — spec 漂移拆分决策

执行中发现新任务超过初始 tasks.md 的 50% 时，强制让你选择：
选项结果
拆分为新 change通过 /comet-open 开新 change
继续在当前 change记录范围扩展，更新 tasks.md 和 delta spec

​
verify 阶段停顿点

​
1b — 验证失败决策

属性说明
触发light 6 项或 full 7 项检查未通过
决策修复还是接受偏差
展示失败项、严重级别（CRITICAL/IMPORTANT/WARNING/SUGGESTION）、推荐处理
选项结果
全部修复transition verify-fail → 调用 /comet-build
逐项处理CRITICAL/IMPORTANT 必须修复；WARNING/SUGGESTION 可接受但记录原因
有 CRITICAL 或 IMPORTANT 失败时不能跳过修复直接全部接受。

​
2b — spec 漂移处理（仅 full 检查 6）

delta spec 与 Design Doc 矛盾时三选一：
选项结果
A在 Design Doc 追加”Implementation Divergence”说明
Btransition verify-fail → /comet-build → 加载 brainstorming 重新对齐
C接受偏差，归档时 Design Doc 标记 superseded-by-main-spec

​
3 — 分支处理

加载 finishing-a-development-branch 后选择：
选项结果
1：本地合并到主分支merge 到主分支
2：推送并创建 PRpush + 创建 PR
3：保持分支稍后处理
4：丢弃工作discard
完成后才能写 branch_status: handled。

​
archive 阶段停顿点

​
1 — 归档前最终确认

属性说明
触发入口状态验证通过后，执行归档脚本前
决策是否立即归档
展示change 名、验证报告、分支状态、即将执行的操作
选项结果
确认归档执行归档脚本，完成 spec 合并和目录移动
需要调整或重新验证archive-reopen 回 phase: verify → /comet-verify
暂不归档保持 phase: archive，稍后再调用 /comet-archive
无论 auto_transition 是 auto 还是 manual，归档前都会执行这个停顿点。验证通过不会自动归档。

​
停顿点规则

所有停顿点遵循 comet/reference/decision-point.md 协议：
  • 必须暂停——不能基于推荐、默认值或当前状态自动选择。
  • 必须用平台输入/确认机制——不能假设特定工具存在。
  • 选择前不推进——不创建产物、不跑 guard、不流转。
  • 推荐仅供参考——推荐规则不能替代你的确认。

​
下一步