Skip to main content
comet native 是 Native Runtime 的命令入口。大多数用户只需在 Agent 中输入 /comet/comet-native,Skill 会根据 Runtime 返回的 continuation 调用命令。

命令一览

新的 Native 流程不再公开 checkpointevidencereceipt 命令;验收检查由 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 响应:
Verify 后的用户决策用 --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,再按需预览或执行:
Archive 应用完整 target Specs、生成 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.yamlverification.md.comet/runtime/native/ 只放本机 state、日志、锁和事务。
最后修改于 2026年9月7日