comet-native

Comet Native

Native 将完整需求、进度和验收结论保存在项目中。Agent 只处理 Runtime 指定的当前阶段。完成当前动作后，读取最新 continuation 并按其中的指令继续，直到任务完成、需要用户决定，或遇到外部阻塞。

必须遵守的规则

• 已确认范围内的实现、文档修复、证据复用和恢复连续推进；只在需要新决定、授权或外部信息时暂停。使用最新 continuation 的命令、模板和任务包，修正输入后沿用当前任务。
• 以磁盘上的 .comet/config.yaml、当前 change、comet-state.yaml 和正式文件为准，聊天记忆只作辅助。工作流保存的正式文件中，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 自行选择。

开始或恢复

1. 已知名称时运行 comet native select <change-name> --json。active change 已存在时，进入返回的 workspace.projectRoot；未知时先运行 comet native status --json。由 Runtime 查找工作区；多个工作区同样匹配时才让用户选择。
2. 没有对应 active change 时，按工作区选择参考确定隔离方式并创建，再进入 preparation.projectRoot。准备失败时，保留已创建的分支和目录，按返回的原因处理。
3. 进入工作区并取得 phase 后，按记忆接入检索一次上下文。需要详情时再展开；实际使用后记录使用结果，任务结束时按该节分别处理项目记忆和个人记忆，再调用 comet task --complete。

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

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

按需读取

只读取当前动作对应的章节。章节中的链接写明了适用条件，满足条件时再读取链接内容；不一次加载整份命令参考或所有参考。

• Shape：必须读取并执行澄清，按项目配置选择 Sequential 或 Batch 的提问步骤。大型需求在最终确认前，必须按该节链接读取 Supervisor 拆分与确认要求。
• 编辑 brief/Spec/children.yaml 或核对验收报告前，必须读取正式产物。文件、附件、链接或本地路径作为需求来源时，必须进入源文档完整覆盖模式；仅用于排错、取证、审查或实现参考的材料不自动触发。
• 首次填写 Runtime 模板或通过 returnAction 回传结果前，必须读取填写命令输入。
• Builder 提交本轮实现前，必须读取Builder 交接。启动 Verifier、补充检查或等待结果前，必须读取Verify 协议。
• 状态包含 childSummary 时，必须在分配任务、接收结果或集成前读取Supervisor 协作，只处理 readyChildren 列出的子任务和 Supervisor 统筹动作。
• 字段含义不清、命令输入被拒绝、Verifier 不可用、执行错误或缺少外部信息：读取命令输入与异常。正常动作直接使用 Runtime 返回的命令和模板。
• 等待外部输入时，按恢复参考中的等待外部输入与监控处理；独立工作继续。进程中断、换设备、连续无进展、并发冲突、迁移失败或状态损坏时，读取故障恢复。