1. 初始化项目
Comet 需要 Node.js 22 或更高版本。安装 CLI 后,在项目根运行:--workflow both 会安装两套独立工作流,但 /comet 默认仍进入 Native。Native 默认把产物放在 docs/comet/;只有明确需要项目根目录下的 comet/ 时才传入 --root .。该选项不会改变 Classic 目录。
初始化后,项目级共享配置位于 .comet/config.yaml:
2. 从统一入口开始
在 Agent 中输入:/comet 按 .comet/config.yaml 的 default_workflow 确定性转发到 /comet-native。它不会根据任务大小临时猜测模式,也不会把 Native change 转成 Classic change。
若需要绕过默认入口,可以直接调用 /comet-native。它是 Skill 入口,不是 shell 命令。
3. 回答真正影响产品行为的问题
Native 会先调查仓库事实。只有仍会改变范围、输出、默认行为、兼容性、风险或不可逆结果的决定才交给用户。默认的sequential 模式每轮只问一个最上游问题;batch 模式会一次提出当前前置条件都已确定的问题。两种模式都会给出推荐和选项影响。
模型不会把“合理默认值”、相邻实现或行业惯例当作用户决定。澄清完成后,结论进入 brief 与完整目标规格,再继续 Build。
4. 让工作流持续推进
阶段通过后,Native 在同一个 Skill 中继续下一阶段。next: auto 表示 Runtime 已允许继续,不表示后台服务会自行调用模型。遇到用户决定、损坏状态、冲突或重复无进展失败时,工作流会停下并返回具体原因。
5. 查看与恢复
/comet 继续。环境感知恢复会先读取磁盘状态,只在目标明确时自动进入对应 change;多个候选或语义不明确时会询问,不会跨工作流猜测。
如不希望普通请求触发只读恢复探针,可在 .comet/config.yaml 设置:

