跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
浏览器与自动化

comet-native

Comet Native 工作流。当用户明确调用 /comet-native、要求启动或恢复 Native change,或入口路由到 Native 时使用。

rpamis · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add rpamis/comet --skill comet-native

技能说明


name: comet-native description: "Comet Native 工作流。当用户明确调用 /comet-native、要求启动或恢复 Native change,或入口路由到 Native 时使用。"

Comet Native

Native 把需求、完整目标规格、当前进度和验收结论保存在项目中。每完成一个阶段都回到 Runtime 读取下一步,当前只处理 Runtime 指定的阶段。CLI 文本先给出面向用户的 summary 和唯一 NEXT:;需要稳定解析时使用 --json 读取新增的 summary/next/user_message Envelope,只有排查机器状态才使用 --verbose,并在等待用户决定前先转述 userCommunication。

硬性边界

  • 磁盘中的 .comet/config.yaml、当前 change、comet-state.yaml 和正式产物是工作依据,聊天记忆只作辅助。
  • Runtime 管理工作流状态、本机执行状态、日志、锁和事务;所有阶段推进都通过 PATH 中公开的 comet native 命令完成,用户不手工执行这些命令。
  • 命令不可用时报告 Comet 安装不完整并停止。参数和输出以 comet native <command> --help 为准。
  • Builder 提交候选,由新的只读 Verifier 作出验收判断;Verifier 的启动方式服从用户选择的推进方式和 Runtime 返回的 continuation。
  • Native 主流程由本 Skill 和 Runtime 完成,不依赖任何外部 Skill。

开始或恢复

  1. 已知 change 名称时,先运行紧凑查询 comet native status <change-name> --json;名称未知时才运行 comet native status --json,确定目标后再查询该 change。
  2. 只有当前动作需要验收文字、Builder 交接、历史或验证详情时才加 --details,并按返回的 nextPageArgs 逐页读取;只读取覆盖当前 scopeIds 的页面,不在同一步重复读取完整状态。需要编辑或核对正式正文时才运行 show 或读取对应 brief/Spec。
  3. active change 已存在时,进入返回的 workspace.projectRoot 并 select。Runtime 会扫描已登记的 worktree,优先返回绑定分支匹配的工作区;只有多个同样匹配的候选才让用户选择。
  4. 没有对应 active change 时才创建,并使用配置指定的产物目录。comet init 会按所选 Skill 语言初始化 native.language;之后产物跟随项目配置,只有用户明确要求覆盖时才传入 --language。

记忆接入

进入 change 工作区并读取 Runtime 当前 phase 后,Agent 自动运行一次:

comet task <project-root> --task "<用户原始请求>" --phase "<phase>" --session "<本次任务稳定标识>" --json
  • 只把返回 JSON 的 text 加入当前上下文。manifest(注入文本中的 <context_manifest>)是 Context Manifest,只包含摘要、应用原因和稳定 ID;当前任务需要正文、来源或验证方式时,运行 comet task <project-root> --task "<用户原始请求>" --phase "<phase>" --session "<同一标识>" --expand-context "<id>" --json。路径、操作或阶段变化时,以同一 --session 和新的 --path、--operation、--phase 重新选择;未变化内容不会重复投递。
  • 若 <active_policies> 中包含 <verification command="...">,把这些命令加入当前 Verify 的实际检查,并记录真实结果;只有成功执行过的命令才能让对应策略进入强制执行状态。
  • 只有用户明确要求长期记住偏好或项目约定时,才调用 comet memory remember <project-root> --text "<偏好或约定>" --scope global|project --json 并立即作为显式记忆生效;没有明确长期要求但出现可跨任务复用的稳定协作方式时,才调用 comet memory observe <project-root> --text "<协作方式>" --workflow <workflow> --change <change-id> --candidate-key <stable-topic-key> --json。两者都不得写任务摘要、实现进展、命令输出或测试结果。
  • 实际采用某条上下文后,从 JSON 的 applications[].applicationId(Hook 文本中的 application_id)取得标识,并在结果明确时运行 comet task <project-root> --task "<用户原始请求>" --application "<application-id>" --outcome used-successfully|ignored|overridden|corrected|contributed-to-failure --json;不得为未实际使用的条目回写成功。验证、编译或 linter 失败时直接按诊断修复并重跑。任务结束仍调用 comet task <project-root> --task "<用户原始请求>" --complete --workflow <workflow> --change <change-id> --json 记录工作流检查点。命令不可用、没有内容或自动检索失败时继续工作;无 Hook 平台由本 Skill 使用以上同一接口,comet memory context 只作为兼容入口。

创建 change

先确定小写 kebab-case 名称,再按工作区选择参考决定使用当前目录、创建分支还是创建 worktree。用户明确说并行、同时处理或多个会话时自动选择 worktree,不再询问三种方式。CLI 会在创建 change 前完成分支或 worktree 绑定,复用或重建已登记的 change worktree,维护仓库本地排除规则,核对配置并创建可跨设备恢复的状态。随后进入命令返回的 preparation.projectRoot;后续命令不得继续在原目录执行。 如果准备没有完成,保留已经创建的资源,展示 preparation 中的失败原因,并按 Runtime 或用户给出的恢复方向继续。

按需读取

确认当前阶段(phase)后,按当前动作读取必要的参考文件。通常只读一份;Shape 必须读取澄清参考,编辑正式产物时可同时读取产物参考:

  • Shape:必须读取并执行澄清参考;
  • 实际编辑 brief/完整目标规格,或查看验收报告时读取产物参考;
  • 正常推进时,直接执行 Runtime 在 continuation 中给出的命令。只有返回字段含义不清、命令输入被拒绝、无法启动 Verifier、Verifier 执行报错,或 Verifier 要求用户补充信息时,才读取命令参考;
  • 只有任务因进程中断、换设备后本机状态缺失、连续多轮没有进展、并发冲突、旧版本迁移失败或状态损坏而无法继续时,才读取恢复参考。

Shape

先调查能够从仓库、工具和运行环境确定的事实;彼此独立的事实可以交给 subagent 调查。按 native.clarification_mode 和澄清参考维护决策树,只把会改变用户可见结果、又无法可靠推断的决定交给用户。用户直接提供文件、附件、链接或本地路径作为需求来源时进入源文档完整覆盖模式:完整读取并记录 complete、partial 或 unavailable 状态,分块读取只改变读取顺序和工作记忆管理,不改变最终覆盖集合;brief.md 先保存完整来源需求和覆盖状态,再提出歧义、遗漏或隐含边界问题;可执行来源单元必须同时映射到完整目标 Spec 和至少一个验收 ID,背景、非目标或已废止内容只保留归类、理由和替代关系;修正后的旧单元标为 superseded 并指向替代单元;partial、unavailable、未映射或未确认内容保持 [blocking]。仅用于排错、取证、审查或实现参考的材料不自动触发,用途不明时先澄清;摘要不能替代来源覆盖映射。 确认后的用户可见决定和重要约束立即同步到 Decisions、brief 和完整目标规格;普通实现选择只有影响用户可见行为时才进入正式需求。验收项必须具体、可观察且互不重复。Runtime 只从 brief 顶层的验收示例和 Spec 中明确以 Scenario: 标出的完整场景生成验收项;说明段落、普通列表和单独的 WHEN/THEN 行不能拆成额外验收项。大型需求需要拆分时,在 Supervisor Change 根目录维护 children.yaml;依赖、验收映射和版本兼容规则以产物参考为准。 大型需求在最终 Shape 确认前执行一次拆分检测:只有至少两个结果可独立实现和验证、每项验收都能明确分配给子任务,并且确实存在先后依赖或并行价值时,才建议使用 Supervisor Change;目标紧密相关、需要反复修改同一核心区域、协调成本更高或用户要求单个 Native Change 时,不进行拆分;需求文字长、任务条目多本身不能触发拆分。 建议拆分时,Skill 将 children.yaml 草案、子任务依赖和先后顺序、每项验收由哪个子任务负责,以及推进方式,一并放入最终 Shape 确认;用户可以调整拆分、继续使用单个 Native Change,或从以下方式中选择其一:

选项推进方式实际影响
A多会话协作(推荐)当前会话只负责统筹;优先由独立会话处理当前可执行的子任务,独立会话或 Agent Team 不可用时自动改用 subagent,并持续反馈进度
B单会话推进不创建 Codex 独立会话或 Claude Code Agent Team;全部子任务仍按相同范围、依赖和验收要求,由当前会话依次处理
用户已经明确要求“多个会话”“独立会话”“跨会话协作”或“Agent Team”时,视为选择 A,不重复询问推进方式。确认前不得创建子 change、worktree、Codex 独立会话、Claude Code Agent Team 或分配任务。
当最终 Shape 已确定为包含两个或更多 Child 的 Supervisor Change 时,必须在 Decisions 中明确记录 Supervisor Change 和每个 Child 条目,并在运行 --confirmed 前要求用户在多会话协作和单会话推进中二选一;不得把普通“确认”视为已选择,也不得替用户默认选择。
确认后,Runtime 把推进方式写入 comet-state.yaml 的 coordination_mode,再为 Supervisor Change 创建独立的集成分支和 worktree,并基于集成分支的当前提交,为每个子任务生成包含角色、worktree、基线提交和 runId 的任务包。推进方式不写入 children.yaml,也不改变 Runtime 的 readyChildren、runId、验收或集成规则。Skill 只启动 readyChildren 中列出的当前可执行子任务;选择 A 时最多同时启动两个不依赖其他子任务的任务,选择 B 时按顺序执行。每个子任务的范围都必须来自 Supervisor Change 的确认;出现新的用户可见决定时回到 Supervisor Change 的 Shape。
恢复 /comet-native 时以 Runtime 持久化的 coordination_mode 为准,不重复创建已有子任务或 worktree,也不再询问推进方式。multi-session 继续使用多会话协作及其 subagent 自动降级;single-session 继续由当前会话按顺序推进。原来的 Codex 独立会话或 Claude Code Agent Team 已经不存在时,先重新读取 Runtime;不得根据旧会话或旧团队的状态推断子任务已经完成,也不得自动改为单会话推进。
未解决问题保持 [blocking];有阻塞项时不修改项目实现。完成标准:所有会影响用户可见结果的选择和未明说的假设均已处理,没有 [blocking],用户明确确认目标、范围、关键决定、验收项和非目标,并且 Runtime 已进入 Build。只有用户明确确认后才使用后续指令中含 --confirmed 的命令推进。

Build ↔ Verify Loop

Build 和 Verify 组成一个有界验收循环(Loop):Builder 提交候选,Runtime 执行必要检查,再由新的只读 Verifier 验收。验收未通过时回到 Build,完成修改并提交下一轮候选;全部通过时进入

阅读完整来源 ↗