关于 comet-verify
comet-verify 是用于 Comet 第 4 阶段验证流程的 Agent 技能,指导 SDK Run 进行风险评估、审查、检查和证据记录,为归档阶段做准备。
主要功能
- 01基于风险的验证
- 02综合审查指引
- 03失败时转回构建阶段
- 04证据报告与检查收据
- 05SDK 与兼容路径
适用场景
- 01评估验证范围
- 02报告实现或任务缺陷
- 03运行验证并记录证据
- 04为归档准备通过验证的 Run
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ rpamis/ comet --skill comet-verify安装后在 Claude Code 中输入/comet-verify确认已加载。
附带文件agents/openai.yamlreference/compat.md
详细介绍
Comet 第 4 阶段:验证
首次进入某个阶段、移交给新的 Agent 或恢复上下文时,请阅读并遵循 任务上下文与制品语言。优先使用当前 continuation 或已认领 Action 的 contextRequest;在同一阶段持续工作期间,不要重复检索。
进入阶段后返回布局时,请遵循 comet-classic/reference/classic-layout.md,将每个逻辑根目录绑定到其目录。如果协议已在上下文中,则不要重新加载。调用 OpenSpec CLI 时使用适配器,路径使用已绑定的 <classic-*> 根目录;不要先额外运行 root show。
SDK 运行路径
首次进入当前 SDK 阶段、移交给新的 Agent 或恢复上下文时,请阅读 阶段进入与恢复 以及该参考文档中当前阶段的章节。如果本会话中已提供且仍有效,请重复使用。继续执行下方阶段;基于 nextAction.kind 的恢复路由仅适用于没有 continuation mode 的旧版响应。
对同一变更、工作区和 Run,重复使用最新的有效响应:agent.continuation、data.nextAction、阶段、修订版本和路径摘要。仅在冷恢复、工作区或外部状态发生变化、响应版本过期,或缺少当前步骤所需信息时,才运行 comet state next <change-name> --json;加载下一个 Skill 并非再次查询的理由。运行时仍会在写入时验证当前版本和证据;缓存的上下文不能绕过检查或审批。确认 data.runtimeFormat: sdk、data.phase: verify 和 nextAction.kind,并在已绑定的 projectRoot 中工作。仅当路径缺失或绑定发生变化时,才运行 comet classic workspace resolve <change-name> --json;仅当缺少当前任务、工作区或证据摘要时,才使用 comet state check <change-name> verify --json。对于 reconcile,使用 comet state check <change-name> verify --recover --json 调查原始 Action 和检查;如果结果仍然未知,请停止。
- 遵循 SDK 执行方法中的风险评估、综合审查和轻量/完整验证方法,但以 SDK Run 作为证据依据。不要调用旧版
state scale、state set、comet handoff或comet check证据命令。对于实现或任务缺陷,请报告具体故障。仅当<profile>.verify.run处于待处理状态(<profile>为 full、hotfix 或 tweak)时,才运行comet state transition <change-name> verify-fail --reason "<failure-reason>"。该命令会记录失败的 Verify Action 并返回 Build。根据该响应中的当前 Build Action 继续;仅当 continuation 信息缺失时,才查询state next --json。报告另一个故障前,请先调查已有的失败或未知检查。 - 验证通过后,在仓库报告
<report-ref>中写明实际检查、证据引用、独立审查和可接受的偏差。直接运行comet guard <change-name> verify --report <report-ref> --apply -- <program> [args...],并提供明确且完整的验证命令。Guard 会在一次 Run 中记录报告、证据和实际检查回执;手动声明并不足够。检查失败时,使用同一响应中的失败回执和当前 Build 或 Verify Action;仅当这些信息缺失时,才查询state next --json,并遵循最新的 Action。 - Guard 成功后,直接使用该响应;仅当缺少阶段或 nextAction 时,才运行
comet state next <change-name> --json。仅当阶段为 Archive 且nextAction.kind指向该处时,才加载/comet-archive。验证通过本身并不授权进入 Archive;请在那里获取当前交付决策。
兼容路径
其余原始 Runtime 步骤仅适用于 runtimeFormat: compat。请阅读 兼容操作,并继续当前阶段。SDK 不会加载该参考文档。