comet native 是 Native Runtime 的命令入口。大多数用户只需在 Agent 中输入 /comet 或 /comet-native,Skill 会根据 Runtime 返回的 continuation 调用命令。
命令一览
新的 Native 流程不再公开
checkpoint、evidence 或 receipt 命令;验收检查由 Runtime 在 Verify 中执行(可用 comet native check 随时只读复跑),结果进入 portable 状态和用户报告。
创建和查看
new 创建 brief、Specs 和 comet-state.yaml,本机执行目录放在 .comet/runtime/native/。status/show 是只读的,不会擅自改变 selection。
推进和 Verify
next 不接受 Agent 自填通过结果。它只确认 Shape、接受或修订 Verify 结果、重试允许的 Verifier,或通过 --runner-input 提交 Runtime 定义的 handoff、检查计划和 Verifier 响应:
--accept-result、--revise-implementation 和 --revise-requirements 表达;--confirmed 只确认 Shape 或明确降级的 verifier-unavailable 回退,不用于接受通过结果。Verifier 不可用时的两个选择对应:
--retry-verifier 保留当前候选和已完成检查,只发起新的验收尝试。Supervisor 并行推进相关的 next 还有 --coordination-mode 和 --max-parallel(默认 2);带恢复上下文的调用需要 --expected-state-version / --expected-action 防止旧响应覆盖新状态。
正常输入模板和字段以 comet native status <name> --details --json 返回的 continuation.inputOptions.template 为准。request-checks 只能由当前 Verifier 请求 Runtime 执行;Builder 自行报告通过不会直接进入 Archive。
归档
先查看 Runtime 返回的 archive-ready continuation,再按需预览或执行:verification.md、移动 change 并清理本机 Runtime;正常路径不重新执行 Verify。branch/worktree 隔离的交付方式用 --finish keep|merge|push|pull-request 指定(选项语义见归档与交付);并行 capability 冲突时,根据 continuation 先用 --serial-first 选择串行顺序。
诊断、迁移和恢复
doctor --repair 只做可确定的迁移、未完成事务的收尾和本机 overlay 重建,不替用户改需求、Spec 或代码。跨设备恢复缺少 verification.md 不会阻止 Shape/Build;遇到错误的 branch/worktree 或混合 active/archive 布局时会暂停,等待你处理。
用户可读产物是 brief、Specs、comet-state.yaml 和 verification.md;.comet/runtime/native/ 只放本机 state、日志、锁和事务。
