Comet Native

Native 在项目中保存需求和验收结论。先确认 change 的运行格式，再执行当前动作。

必须遵守的规则

• 已确认范围内的实现、文档修复、证据复用和恢复连续推进；只在需要新决定、授权或外部信息时暂停。使用最新 continuation 的命令、模板和任务包，修正输入后沿用当前任务。
• 以磁盘上的 .comet/config.yaml、当前 change 的 comet-state.yaml、Runtime 返回的进度，以及正式文件为准，聊天记忆只作辅助。工作流保存的正式文件中，Agent 只编辑 brief、完整目标 Spec、关联时的 delta.yaml 和 children.yaml；状态、检查结果、报告、锁和事务由 Runtime 管理。
• 通过 PATH 中公开的 comet native 命令推进，用户不手工执行命令。命令不可用时报告安装不完整并停止；参数以 comet native <command> --help 为准。
• 新建 change 走 CLI 并使用响应路径；拒绝后按信息中的命令或目标修正并重试；自定义 Hook、非 Comet 工作和普通同名文件保持中立。
• Builder 提交本轮待验收的代码和相关文件，称为“候选实现”。每轮都由新的只读 Verifier 独立判断全部验收项。判断全部验收项不等于重跑全部命令：仍与当前候选实现匹配的 Runtime 检查记录可以复用，只补充缺失或失效的检查。失败、阻塞、未执行和超时不能算通过。
• 只有用户明确确认完整 Shape、接受最终结果或选择相应交付方式后，才执行对应的确认命令。沿用已确认的需求范围和 Runtime 保存的用户选择。归档、merge、push、PR 和工作区清理各自需要的授权不能互相代替。
• Native 主流程由本 Skill 和 Runtime 完成，不依赖外部 Skill；不改变已确认的需求和约束时，实现方法由 Agent 自行选择。

开始或恢复

首次开始任务或更换宿主时，必须读取并执行宿主能力核对，在确认 Shape 或开始新的实现前核对独立验收和 Runtime 回报能力。

1. 已知名称时运行 comet native select <change-name> --json，否则运行 comet native status --json。active change 已存在时，进入 workspace.projectRoot；工作区有歧义时才让用户选择。若 Run 记录丢失，读取故障恢复：有检查点则沿用阶段；否则先诊断并等待恢复决定。
2. 没有对应 active change 时，按工作区选择参考确定隔离方式，运行 native new 创建，再进入 preparation.projectRoot。准备失败时，保留已创建的分支和目录，按返回的原因处理。
3. 进入工作区并取得 phase 后，按记忆接入获取适用上下文。进入新阶段、交接给新 Agent 或恢复上下文时，由接收方执行 contextRequest，重新取得当前适用偏好和项目约束；同一阶段连续执行无需重复获取。任务结束时按该节分别处理项目记忆和个人记忆，再调用 comet task --complete。

记忆学习只提交可复用的用户信息；任务摘要、进展、命令输出和测试结果不写入个人记忆。任务结束前按记忆接入章节完成学习检查，并记录 submitted、no-observation 或 not-run。

项目经验与个人偏好分开保存：可由当前项目验证、且未来任务仍可复用的经验在任务结束前执行 comet knowledge remember 写入项目记忆；用户偏好和稳定协作习惯才进入个人记忆。两者的命令和完成条件见记忆接入。

SDK Run 路径