comet-classic
Comet Classic 工作流入口。当用户明确调用 /comet-classic、要求启动或恢复 Classic,或 resume-probe 返回 auto_resume、确认唯一可恢复的未归档 Classic change 时使用。
- License 许可
- MIT
- 所属仓库
- rpamis/comet
- 最近更新
- 2026-11-15
- Stars
- ★ 3.3k
- Forks
- 314
01 前言 Front Matter
- name
- comet-classic
- description
- Comet Classic 工作流入口。当用户明确调用 /comet-classic、要求启动或恢复 Classic,或 resume-probe 返回 auto_resume、确认唯一可恢复的未归档 Classic change 时使用。
02 资源文件 14
- 参考文档agents/openai.yaml124 B
- 参考文档reference/auto-transition.md3.6 KB
- 参考文档reference/classic-layout.md4.1 KB
- 参考文档reference/comet-yaml-fields.md18.2 KB
- 参考文档reference/context-recovery.md16.7 KB
- 参考文档reference/debug-gate.md2.7 KB
- 参考文档reference/decision-point.md12.6 KB
- 参考文档reference/dirty-worktree.md3.4 KB
- 参考文档reference/file-structure.md2.0 KB
- 参考文档reference/intent-frame.md10.8 KB
- 参考文档reference/scripts.md17.5 KB
- 参考文档reference/sdk-methods.md15.4 KB
- 参考文档reference/subagent-dispatch.md10.3 KB
- 参考文档reference/workspace.md2.1 KB
03 SKILL.md 正文
Comet Classic — OpenSpec + Superpowers
Classic 分为 Open → Design → Build → Verify → Archive 五个阶段。OpenSpec 管理需求规格与归档,Superpowers 提供设计方法,以及用户选定的规划、执行和审查方法。完整流程(full)必须经过 brainstorming 和设计确认;hotfix/tweak 使用各自的预设步骤。
1. 确定目标与工作区
开始新任务或更换宿主时,必须读取并执行宿主能力核对,在批准 Open 前确认当前流程所需的能力。执行配置改变后,只补核对新策略需要的能力。
开始或恢复前,按 comet-classic/reference/classic-layout.md 解析产物路径,并执行 comet-classic/reference/scripts.md 的“CLI 引导”。使用公开 Comet CLI 和 OpenSpec 适配器。所有参考按当前动作读取相关章节,复用上下文中仍有效的规则。
- 未明确调用 Classic、需要判定是否恢复已有工作时:读取
comet-classic/reference/context-recovery.md的 Ambient Resume,按comet resume-probe . --stdin --json结果处理;只有auto_resume自动进入,ask_user按reason使用 Ambient Resume 表格中的问题与选项提问,out_of_scope/none不进入。 - 启动新需求或目标 change 尚不明确时:读取
comet-classic/reference/intent-frame.md的最小示例与目标选择规则,获取未归档的 change 列表后填写 CometIntentFrame,运行comet classic intent route --stdin。Agent 只负责按证据填写意图字段,路由由 Runtime 计算;以返回结果为准,不另写一套自然语言评分规则。 - 已明确目标 change 且已由 Runtime 初始化时:按下方绑定工作区;SDK 新 change 使用
comet-state.yaml,历史.comet.yaml原地读写,compat 初始化仍使用旧名,以state next返回的 Runtime 归属判断恢复路径,不能只看状态文件是否存在。有多个未归档的 change 且尚未选定时,不提前绑定。真正的新 change 直接交/comet-open或对应预设 Skill,它们会先准备工作区再初始化;workspace resolve对未初始化的 change 会报 not found。
comet classic workspace resolve <change-name> --json
# 进入返回的 projectRoot 后选择 change
comet state select <change-name> --json
同一 change 同时存在 comet-state.yaml 和 .comet.yaml 时(包括其中一个是失效符号链接)必须停止,保留两个文件并核对来源;不得静默择一、覆盖或自动改名。
选择结果已包含当前 Runtime 归属、phase、revision 与 nextAction 时直接继续;只有缺少信息、外部状态变化或旧结果已过期时,才运行 comet state next <change-name> --json 补读。
跨设备同步应携带实际状态文件、change 文档、引用工件、代码和项目配置;检查点不包含独立子 worktree 和未提交代码。复制到新设备的 SDK change 若在实际状态文件中有 run_checkpoint,具名 state select 或 state next 会恢复原阶段、Action 和确认;继续外部工作前先确认原设备的执行进程已停止。结果未明的 Action 先核对,不重发。只有旧状态文件缺少检查点、常规入口明确报告 Run 记录丢失时,才核对正式文档,说明显式恢复会回到 Open、旧确认和检查需要重做,取得用户同意后运行 comet state restore <change-name> --confirmed。
发现普通或正式材料的实际文件变化,或续行提示编辑判断时,先读取并执行编辑后继续原流程,再处理阶段动作或修订命令。修订命令不构成用户授权;缺少新增范围的授权时,保留原阶段、已接受结果和待办,只请求相关决定。
响应已有 agent.continuation.mode 时,先按 comet-classic/reference/auto-transition.md 的统一规则处理,以 mode 决定执行、等待、提问、核对或结束;下文的 nextAction.kind 路由仅用于没有 mode 的旧响应。
以 data.runtimeFormat 区分 sdk 与 compat,并按返回的 phase、configuration 和 data.nextAction.kind 继续。SDK 的 action 才能加载返回的 Skill;decision、evidence、reconcile 先进入对应阶段的恢复步骤,核对同一 Run 的待决定项、待提交证据或已领取 Action,不能把它们当作未执行的 Skill 重跑。旧 change 保持原有阶段路由。新 full change 交 /comet-open,由它准备工作区、创建 OpenSpec 产物并初始化 SDK Run;已确认的 hotfix/tweak 分别交 /comet-hotfix、/comet-tweak,按各自预设完成初始化。不直接调用 /opsx:new。已有 change 的 Runtime 归属与文件冲突或格式异常时,按 context-recovery.md 的“入口错误与恢复”停止并核对,不根据现有产物猜测阶段或新建第二份状态。
新 full change 必须先确定工作区,再在 Open 阶段创建产物。full workflow 的 isolation 可为 current、branch 或 worktree;用户明确要求并行工作时准备 Worktree,其他情况按 comet-classic/reference/workspace.md 选择。hotfix/tweak 按各自初始化步骤确认并绑定工作区。恢复时使用已经绑定的工作区;分支归属发生变化时,根据用户已确认的选择执行 rebind,缺少有效授权时才询问。
2. 载入当前阶段
同一组任务复用命令结果和已有上下文;响应含当前状态与 agent.continuation 时直接继续。只有字段缺失、工作区切换、恢复时丢失上下文或外部状态变化时才重新查询。按改动风险选择检查,Verify 负责一次最终集成审查。
绑定工作区并取得 phase 后,以及阶段切换、换 Agent 或上下文恢复时,读取并执行 任务上下文与产物语言,优先使用当前 continuation 或已领取 Action 的 contextRequest 获取快照;同一阶段连续执行不重复获取。按配置确定产物语言;根据 Context Manifest(上下文清单)中的摘要,只展开当前步骤还缺少的内容。实际使用某条内容后如实记录使用结果,任务结束时保存检查点。
记忆学习只提交可复用的用户信息;任务摘要、进展、命令输出和测试结果不写入个人记忆。任务结束前按任务上下文参考完成学习检查,并记录 submitted、no-observation 或 not-run。
项目经验与个人偏好分开保存:任务结束前,把当前项目中已验证且未来可复用的经验用 comet knowledge remember 写入项目记忆;用户偏好和稳定协作习惯才进入个人记忆。命令和过滤条件见 任务上下文与产物语言。
- 新 full / open:
/comet-open:澄清范围、创建必需产物、请用户检查并确认 - design:
/comet-design:完成技术取舍并确认正式设计 - build + full:
/comet-build:恢复配置/计划,完成任务与所需审查 - hotfix / build + hotfix:
/comet-hotfix:已有异常的局部修复 - tweak / build + tweak:
/comet-tweak:单 change 轻量调整 - verify:
/comet-verify:执行验收、修复后复验、完成唯一一次最终集成审查 - archive / verify_result: pass:
/comet-archive:确认归档、只提交当前 change 的文件、完成用户选定的交付方式
阶段工作由对应 Skill 执行;编写产物、调用 OpenSpec 或推进前先加载它。decision、evidence 和 reconcile 沿用当前 Run,不重做阶段工作。
新 full / Open,或当前 Action 指定 comet-open 时:
立即执行: 使用 Skill 工具加载 comet-open 技能。禁止跳过此步骤。
当前 Action 指定 comet-design 时:
立即执行: 使用 Skill 工具加载 comet-design 技能。禁止跳过此步骤。
只有新需求才考虑推荐轻量流程:风险符合预设要求且用户已明确选择时直接进入;由 Agent 推荐时,说明依据,并展示 hotfix/tweak 与保留 full 的选项及各自影响,等待用户确认。不得擅自把已有 full change 改成轻量流程。公共 API、数据迁移、安全、并发或跨模块设计应按实际风险处理,不能因为文件少就省略必要步骤。
运行 hotfix/tweak 时,SDK 必须读取并执行预设范围复核,按该节核对并复用仍有效的 rulings.md 授权;Compat 读取所选预设的 reference/compat.md 中“升级判定”。仅文件数超限时先核对范围和已有授权,需要新决定时才展示继续预设或升级 full 的选项。用户选择升级后,使用当前 Run 的 continuation 或 Compat 对应命令推进。verify_mode 只决定验证级别,不能替代 workflow 选择或预设升级确认。
恢复会话、外部状态变化,或计划、任务、审查、交付记录与实际情况不一致时,读取 comet-classic/reference/context-recovery.md,根据当前阶段入口返回的 nextAction 确定还有哪些步骤未完成。沿用仍有效的配置和成果;任务未勾选不等于尚未实现。具体恢复步骤以该参考文件为准。
3. 继续完成本次获准执行的工作
阶段退出检查通过后,按 comet-classic/reference/auto-transition.md 读取成功结果中的 agent.continuation,只加载它指定的下一 Skill。没有可复用的状态信息、会话恢复时缺少上下文,或发生外部变化时,才重新查询。auto_transition: false 只控制是否调用下一 Skill,不改变 Guard 已更新的 phase;NEXT: manual 时按 HINT 提示用户并结束本次调用,不追加确认。
先核对已有批准、委托授权和用户要求的确认方式;需要新决定时,等待明确答复后再继续。首次需要向用户澄清或确认时,必须先读取 comet-classic/reference/decision-point.md,按其中的选项式提问、推荐理由、每项影响和 AskUserQuestion 优先规则执行;已在当前上下文中时直接复用。以下事项按该协议核对授权;已有授权仍覆盖时继续,需要新决定时才提问:
- 目标 change、PRD 拆分与工作区隔离仍需要用户选择时,把相关问题放在一起询问,并等待选择。
- Open 产物完成后,请用户最终确认名称、范围和产物;Design 形成方案后,请用户确认正式设计。两者都按已有授权核对当前内容;需要用户决定时,提供可检查的结果并等待答复。
- Build 写计划前,只有执行/TDD/review 配置缺失或用户要求更改时,才请用户补充或修改;用户主动要求
plan-ready暂停后,等明确继续指令再恢复。 - Verify 中需要接受偏差、处理实现与 Spec 不一致的问题,或达到自动修复上限后决定如何继续;Archive 中需要选择归档与交付方式。
- 需要从预设升级为完整流程,或 Build 中需要扩大范围、重新设计、拆分 change。
用户明确选择前,不写入依赖该决定的状态,不执行对应分支操作,也不绕过阶段 Guard。已有仍有效的授权与配置直接复用;对于范围内原因明确且可以修复的问题、能根据证据补齐的状态,以及其他只有一种合法做法的步骤,自动继续,不额外询问“是否继续”。
归档与交付方式合并为同一个最终确认,由 /comet-archive 核对用户授权、Git 的实际状态,以及所选交付操作是否完成。验证通过不代表归档授权;归档目录存在也不代表提交、push 或 PR 已完成。
每个阶段都必须遵守的规则
- 流程状态以 Runtime 返回的 phase、Guard 检查结果和当前工作区绑定为准;文件与对话用于核对,不能据此手改 phase,绕过确认或验证。
- proposal 记录目标与范围,spec 规定行为和验收要求,design_doc 指向唯一一份正式技术设计,plan 说明实施方法,tasks.md 记录任务完成状态。
- 遵循已确认的执行方式、TDD 和 review 配置;autonomous 仍须完成 full 要求的设计、计划、实际验证和独立审查。配置缺失或用户要求更改时由 Build 确认,不能根据模型名称擅自替换。
- 未提交改动先按
comet-classic/reference/dirty-worktree.md核对来源和归属;只处理当前 change,保护无关改动。状态更新被拒绝、路径越界、依赖不可用或归属不明时,读取comet-classic/reference/context-recovery.md的“入口错误与恢复”,报告原错误并执行对应恢复规则。 - 当前阶段发生异常时读取
comet-classic/reference/debug-gate.md,先调查再修复;只有实际运行过测试或构建,才能声称完成相应检查。以前通过的结果,只有在 Runtime 确认仍有效时才能复用。
需要状态字段含义时读 comet-classic/reference/comet-yaml-fields.md;需要产物目录说明时读 comet-classic/reference/file-structure.md。其余参考只在上方触发条件满足时读取。
04 同仓库更多 Skills
writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment
writing-plans
Use when you have a spec or requirements for a multi-step task, before touching code
verification-before-completion
Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
using-git-worktrees
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback
test-driven-development
Use when implementing any feature or bugfix, before writing implementation code
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes