comet-verify
验证 Classic change 并记录结果。在用户调用 /comet-verify,或 Classic Runtime 进入 Verify 时使用。
- License 许可
- MIT
- 所属仓库
- rpamis/comet
- 最近更新
- 2026-11-15
- Stars
- ★ 3.3k
- Forks
- 314
01 前言 Front Matter
- name
- comet-verify
- description
- 验证 Classic change 并记录结果。在用户调用 /comet-verify,或 Classic Runtime 进入 Verify 时使用。
02 资源文件 2
- 参考文档agents/openai.yaml198 B
- 参考文档reference/compat.md15.1 KB
03 SKILL.md 正文
Comet 阶段 4:验证(Verify)
首次进入阶段、交接给新 Agent 或上下文恢复后,读取并执行 任务上下文与产物语言,优先采用当前 continuation 或已领取 Action 的 contextRequest;同一阶段连续执行不重复获取。
收到入口返回的 layout 后,首次接收阶段或绑定变化时执行阶段共用入口,复用仍有效的 layout,无需先额外运行 root show;遇编辑判断时按共用入口加载编辑后续行协议。
SDK Run 路径
先读取并执行普通命令与检查。新旧 Run 均使用平台工具执行普通命令,在原 Run 提交实际检查报告;自动升级不恢复旧检查执行器。阶段准备、用户选择、任务完成和验收要求继续有效。
首次进入当前 SDK 阶段、换 Agent 或恢复上下文时,读取阶段入口与恢复及该参考的当前阶段章节;本会话已有且仍有效时直接复用。下文按当前阶段执行;nextAction.kind 的恢复路由只适用于没有 continuation mode 的旧响应。
优先复用同一 change、工作区和 Run 的最新有效响应中的 agent.continuation、data.nextAction、phase、revision 和路径摘要。只有冷恢复、工作区或外部状态变化、响应版本已过期或缺少当前步骤必要信息时,才运行 comet state next <change-name> --json;不要因加载下一 Skill 再读一次。后续写操作仍由 Runtime 校验当前版本与证据,不能用缓存跳过检查或批准。确认 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 方法参考的风险评估、最终集成审查和 light/full 验证方法检查当前 change,但以 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>"。此命令将失败原因作为同一 Run 的 Verify Action 结果并返回 Build;按同次响应的当前 Build Action 继续;缺少续行信息时才读取state next --json。已有检查失败或结果未明时先读取其 Action,不另报一次 Verify 失败。 - 验证结论合格后,将实际检查项、证据引用、审查结论及可接受偏差写入仓库内的验证报告
<report-ref>,运行comet guard <change-name> verify --report <report-ref> --apply --checks <checks-json-file>提交。Guard 核对同一 Run 的报告和验收要求,不重复执行命令。失败或结果未明时使用返回的当前 Action 核对原任务;缺少续行时才读state next --json,不把失败解释为通过。 - Guard 通过后直接使用同次响应;缺少 phase 或 nextAction 时才运行
comet state next <change-name> --json。只有 phase 为archive且nextAction.kind指向 Archive,才加载/comet-archive。Verify 通过不等于用户已经授权归档;由 Archive Skill 获取并记录当前交付决定。
Compat 路径
以下旧 Runtime 步骤仅用于 runtimeFormat: compat。必须读取 Compat 操作,按其中当前阶段继续;SDK 不加载该参考。
可选变更说明
Build 收尾和 Verify 展示结果前,先核对项目 .comet/config.yaml 的 change_walkthrough(默认开启;仅显式 false 关闭)。开启时读取并执行变更说明,用共享模板生成或更新同一 walkthrough.html 并给出打开链接;关闭时跳过额外讲解、详细指引和渲染,保留原有摘要。Archive 只随现有材料保存已有页面并提供实际归档链接,不补生成、不新增确认、不为页面更新重跑代码检查。
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