comet native 是 Native 工作流的命令入口。Native 工作流把一次需求拆成 Shape、Build、Verify、Archive 四个阶段，这些命令负责创建和管理每次变更、推进阶段、保存进度和归档。
大多数用户不需要直接敲这些命令——在 Agent 平台里输入 /comet 时，Skill 会自动调用它们。这一页帮你了解每条命令在做什么，以及排障或自动化时怎么用。
命令一览
所有命令都支持
--json，输出结构化结果，方便脚本和 CI 解析。
创建和查看变更
开始一次新需求时创建变更。new 会建立变更目录、捕获项目当前文件快照，并把它选为当前变更：
status 不带变更名时列出全部活跃变更；带上变更名时显示它的阶段、验证状态和恢复建议。加 --details 可以看更详细的检查项和验收进度。
show 用来读某次变更里写下的需求和目标规格：
保存进度
一次变更可能要分多轮才能做完。checkpoint 在不推进阶段的前提下，保存你目前做了什么、下一步该做什么，以及产生了哪些文件：
status 返回的进度继续，而不是依赖聊天记录。
检查和验证
check 跑 Comet 内置的只读检查，看代码是否满足这次变更的目标规格。它不调用你的测试命令、不改任何文件，只在 Verify 阶段给出一份检查报告：
receipt 用来记录一次具体的验证动作。分两种：manual 记录你手工执行的步骤和观察；automated 记录一条真实命令及其退出结果：
推进阶段
next 把变更推进到下一个阶段。它会校验当前阶段的证据是否齐全，齐全才放行：
验证失败会自动退回 Build，并把没通过的检查项告诉你，修完再重新验证。
归档
变更完成后用archive 归档。归档分两步，先预演确认没有冲突，再正式提交：
诊断和修复
状态异常时先用doctor 诊断。不带参数只检查、不改文件：
--repair，它只处理能证明安全的事项，比如清理过期锁、恢复中断的事务，不会改写你的需求、规格或代码：
配置产物目录
init 配置 Native 把产物（变更目录、状态、证据）放在哪，默认是项目下的 docs/comet/。通常首次创建变更时会自动生成默认配置，不需要手动跑：
root move 事务化迁移，不要直接改配置文件：
没有 comet 命令时
如果环境里没装comet CLI（只有 Skill 文件），可以直接调随包发布的 Runtime，参数和退出码跟 comet native 完全一致：