Native 命令概览

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

命令一览

命令	做什么
`comet native init`	初始化或整理 Native 项目配置
`comet native root show/move`	查看或以事务方式移动产物根目录
`comet native new`	创建 change 并准备 `current`、`branch` 或 `worktree`
`comet native show`	查看 brief、Specs 和 portable 状态
`comet native status`	查看 change、Loop、验收、检查和下一步（`--cursor` 分页、`--details` 看完整 continuation）
`comet native select`	多个 change 并存时选择写入目标
`comet native spec remove`	记录 capability 删除意图
`comet native spec sync`	修正已确认 Spec 中的本地链接（语义修改返回 Shape）
`comet native next`	按 continuation 确认或恢复边界、提交 handoff/Verifier 输入
`comet native archive`	预览或执行归档和工作区收尾
`comet native check`	对指定 change 运行只读的 Native 验证检查
`comet native doctor`	诊断、迁移和重建本机 Runtime

新的 Native 流程不再公开 checkpoint、evidence 或 receipt 命令；验收检查由 Runtime 在 Verify 中执行（可用 comet native check 随时只读复跑），结果进入 portable 状态和用户报告。

创建和查看

comet native new add-user-avatar --isolation current
comet native status --json
comet native status add-user-avatar --details --json
comet native show add-user-avatar

new 创建 brief、Specs 和 comet-state.yaml，本机执行目录放在 .comet/runtime/native/。status/show 是只读的，不会擅自改变 selection。

推进和 Verify

next 不接受 Agent 自填通过结果。它只确认 Shape、接受或修订 Verify 结果、重试允许的 Verifier，或通过 --runner-input 提交 Runtime 定义的 handoff、检查计划和 Verifier 响应：

comet native next add-user-avatar --summary "Shape confirmed" --confirmed
comet native next add-user-avatar --summary "Current result accepted" --accept-result
comet native next add-user-avatar --summary "Implementation needs revision" --revise-implementation
comet native next add-user-avatar --summary "Acceptance criteria changed" --revise-requirements
comet native next add-user-avatar --runner-input <temporary-json-file>

Verify 后的用户决策用 --accept-result、--revise-implementation 和 --revise-requirements 表达；--confirmed 只确认 Shape 或明确降级的 verifier-unavailable 回退，不用于接受通过结果。Verifier 不可用时的两个选择对应：

comet native next add-user-avatar --summary "Retry verifier" --retry-verifier
comet native next add-user-avatar --summary "Accept degraded result" --confirmed

--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 自行报告通过时，change 不会直接进入 Archive。当前命令已经返回所需模板或 Verifier 任务包时，直接使用该响应，不必再查一次 Status。Supervisor 可以用 --confirmed --coordination-mode multi-session|single-session 同时确认完整方案和推进方式；接受结果时可以加 --finish keep|merge|push|pull-request 一起保存交付选择。实际执行时保留最新 continuation 给出的状态版本与预期动作参数。

归档

先查看 Runtime 返回的 archive-ready continuation，再按需预览或执行：

comet native archive add-user-avatar --dry-run
comet native archive add-user-avatar --confirmed

需要符合项目提交规范时，在预览和执行命令中保留相同消息参数。例如，仅保留隔离工作区：

comet native archive add-user-avatar --dry-run --finish keep --commit-message "chore: archive add-user-avatar"
comet native archive add-user-avatar --confirmed --finish keep --commit-message "chore: archive add-user-avatar"

--commit-message 设置归档提交说明，--merge-message 设置本地合并说明；后者仅用于 --finish merge。支持中文和多行文本，传入时按当前 Shell 的规则引用。项目 Hook 仍正常执行，说明被拒绝后的恢复见恢复手册。Archive 应用完整 target Specs、生成 verification.md、移动 change 并清理本机 Runtime；正常路径不重新执行 Verify。branch/worktree 隔离的交付方式用 --finish keep|merge|push|pull-request 指定（选项语义见归档与交付）；并行 capability 冲突时，根据 continuation 先用 --serial-first 选择串行顺序。

诊断、迁移和恢复

comet native doctor
comet native doctor add-user-avatar
comet native doctor add-user-avatar --repair

doctor --repair 只做可确定的迁移、未完成事务的收尾和本机 overlay 重建，不替用户改需求、Spec 或代码。跨设备恢复缺少 verification.md 不会阻止 Shape/Build；遇到错误的 branch/worktree 或混合 active/archive 布局时会暂停，等待你处理。用户可读产物是 brief、Specs、comet-state.yaml 和 verification.md；.comet/runtime/native/ 只放本机 state、日志、锁和事务。

安装和健康检查

SDK 应用

Skill、评估和发布（进阶）

核心脚本

SDK 常用命令

取消未完成任务

命令一览

创建和查看

推进和 Verify

归档

诊断、迁移和恢复

​SDK 常用命令

​取消未完成任务

​命令一览

​创建和查看

​推进和 Verify

​归档

​诊断、迁移和恢复

SDK 常用命令

取消未完成任务

命令一览

创建和查看

推进和 Verify

归档

诊断、迁移和恢复