[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72W21058REYR0PEK2G0WM5Y":3,"skill-same:01M72W21058REYR0PEK2G0WM5Y":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M72W21058REYR0PEK2G0WM5Y","comet-verify",null,"Use when Comet change 已完成 build 阶段，需要验证实现、处理验证失败决策或完成分支收尾。","rpamis\u002Fcomet","rpamis","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F153429891?v=4","01M72VXBR7EQYMM7KN8C19244V","01M72VXBRYC06QG0ZH0JBGV09V",3298,"MIT","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002F040-beta\u002Fcomet-verify\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: comet-verify\ndescription: \"Use when Comet change 已完成 build 阶段，需要验证实现、处理验证失败决策或完成分支收尾。\"\n---\n\n# Comet 阶段 4：验证与收尾（Verify）\n\n## 前置条件\n\n- 代码已提交（阶段 3 完成）\n- tasks.md 全部任务已完成\n\n## 步骤\n\n### 0a. 输出语言约束\n\n验证报告和分支处理说明必须使用触发本次工作流的用户请求语言。\n\n### 0b. 入口状态验证（Entry Check）\n\n按 `comet\u002Freference\u002Fscripts.md` 定位脚本（定位 `comet-env.mjs`），然后执行入口验证；从任意入口恢复时先按 `comet\u002Freference\u002Fcontext-recovery.md` 运行恢复检查：\n\n```bash\nnode \"$COMET_STATE\" check \u003Cchange-name> verify\n```\n\n验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。\n\n**幂等性**：verify 阶段所有检查可安全重复执行。如 `verify_result` 已为 `pass` 且 `branch_status` 已为 `handled`，说明验证已完成，直接执行 guard 流转。如 `verify_result` 为 `pending`，从头开始验证。\n\n### 1. 改动规模评估\n\n执行规模评估：\n\n```bash\nnode \"$COMET_STATE\" scale \u003Cchange-name>\n```\n\n脚本自动统计任务数、增量规格数、变更文件数，判断使用 light 或 full 验证模式，并设置 verify_mode 字段。判定规则（满足任一即 full）：任务数 > 3、delta spec 能力数 > 1、变更文件数 > 8。\n\n验证开始前，按 `comet\u002Freference\u002Fdirty-worktree.md` 协议检查并处理未提交改动。verify 阶段的特殊处理：\n\n1. 若 dirty diff 属于当前 change 且涉及实现、测试、tasks、delta spec 或 design doc 变更，不在 verify 阶段直接修复或提交；报告失败项并进入 Step 1b 的验证失败决策阻塞点\n2. 若 dirty diff 只是 verify 本阶段产物（例如验证报告草稿、分支处理记录），可继续在 verify 阶段完成并记录状态\n3. 若 dirty diff 已实现但 tasks.md 未勾选，视为 build 状态滞后；报告失败项并进入 Step 1b，由用户决定回退修复或接受偏差\n\n用户选择修复后，才允许回退到 build 阶段：\n\n```bash\n# 仅在用户确认修复后执行\nnode \"$COMET_STATE\" transition \u003Cchange-name> verify-fail\n```\n\n注意：verify-fail 回退到 build 时 `branch_status` 不会被重置。如果首次 verify 已完成分支处理，修复后再次进入 verify 时跳过已完成的分支处理步骤，直接使用 `node \"$COMET_STATE\" set \u003Cchange-name> branch_status handled` 保留原有分支处理结果。\n\n注意：如果 build 阶段每个任务都已提交，脚本基于工作区 diff 的文件数可能低估改动规模。此时必须读取 plan 文件头的 `base-ref` 并用提交区间复核：\n\n```bash\nPLAN=$(node \"$COMET_STATE\" get \u003Cchange-name> plan)\nBASE_REF=$(grep '^base-ref:' \"$PLAN\" 2>\u002Fdev\u002Fnull | head -1 | sed 's\u002F^base-ref: *\u002F\u002F')\ngit diff --stat \"$BASE_REF\"...HEAD\n```\n\n若提交区间显示改动超过轻量阈值（> 8 个文件、跨模块协调、或 delta spec 超过 1 个 capability），手动设置为完整验证：\n\n```bash\nnode \"$COMET_STATE\" set \u003Cchange-name> verify_mode full\n```\n\n**覆盖机制**：如 agent 或用户认为自动评估结果不合适，可随时通过 `node \"$COMET_STATE\" set \u003Cchange-name> verify_mode \u003Clight|full>` 手动覆盖。\n\n### 1b. 验证失败决策（阻塞点）\n\n验证不通过时**必须按 `comet\u002Freference\u002Fdecision-point.md` 的协议暂停并等待用户决定修复或接受偏差**。不得自动运行 `node \"$COMET_STATE\" transition \u003Cchange-name> verify-fail`，也不得自动调用 `\u002Fcomet-build`。\n\n暂停时必须列出：\n- 失败项\n- 是否属于 CRITICAL 或 IMPORTANT（构建失败、测试失败、安全问题、核心验收场景失败、简化代码审查发现的正确性\u002F安全\u002F边界问题）\n- 推荐处理方式\n\n**不确定性原则**：无法确定严重程度时，降级处理（SUGGESTION > WARNING > CRITICAL）。仅对构建失败、测试失败、安全问题使用 CRITICAL；模糊或不确定的问题标为 WARNING 或 SUGGESTION。\n\n用户选择后按以下方式继续：\n- **全部修复**：运行 `node \"$COMET_STATE\" transition \u003Cchange-name> verify-fail`，然后调用 `\u002Fcomet-build` 修复\n- **逐项处理**：CRITICAL 或 IMPORTANT 失败项必须修复；WARNING\u002FSUGGESTION 失败项可选择接受偏差，但必须在验证报告中记录接受原因和影响范围。若存在任何 CRITICAL 或 IMPORTANT 失败项，不允许跳过修复直接全部接受\n\n**重试上限**：连续 3 次 verify-fail 循环后，第 4 次失败时代理不得自动选择继续修复；**必须使用当前平台可用的用户输入\u002F确认机制暂停**，仅给出两个选项：「接受所有偏差并记录」或「继续修复」，由用户明确决定。\n\n### 2. 产物上下文加载（Hash 按需读）\n\n验证需要读取 OpenSpec 产物时，先检查产物是否自 design 阶段以来发生变化：\n\n```bash\nRECORDED_HASH=$(node \"$COMET_STATE\" get \u003Cchange-name> handoff_hash)\nCURRENT_HASH=$(node \"$COMET_HANDOFF\" \u003Cchange-name> --hash-only 2>\u002Fdev\u002Fnull || echo \"\")\n```\n\n- 若 `RECORDED_HASH` = `CURRENT_HASH` 且均非空且均非 `null`：OpenSpec 产物未变化，**tasks.md 无需重新读取全文**（用 `grep -c '\\- \\[ \\]' tasks.md` 确认完成数即可）。proposal.md、design.md、delta spec 仍需读取用于对照检查。\n- 若 `RECORDED_HASH` 为空、为 `null`、或与 `CURRENT_HASH` 不一致：产物已变化或 hash 未记录，正常读取所有所需文件全文。\n\n此优化仅跳过 tasks.md 的重复全文读取。proposal.md 和 design.md 包含验证检查项所需的完整上下文，不得因 hash 匹配而跳过。\n\n**立即执行：** 使用 Skill 工具加载 Superpowers `verification-before-completion` 技能。禁止跳过此步骤。\n\n技能加载后，按 verify_mode 分支执行：\n\n### 2a. 轻量验证（小改动）\n\n按以下 6 项进行检查：\n\n1. tasks.md 全部任务已完成 `[x]`\n2. 改动文件与 tasks.md 描述一致（`git diff --stat` \u002F `git diff --cached --stat` \u002F `git diff --stat \u003Cbase-ref>...HEAD` 对照 tasks 内容）\n3. 编译通过（执行项目对应的构建命令，如 `npm run build`、`mvn compile`、`cargo build` 等）\n4. 相关测试通过\n5. 无明显安全问题（无硬编码密钥、无新增 unsafe 操作）\n6. 代码审查策略：当 `review_mode: standard` 或 `thorough` 时，必须使用 Skill 工具加载 Superpowers `requesting-code-review` 技能，请求只检查正确性、安全、边界条件的轻量代码审查；当 `review_mode: off` 时跳过自动代码审查，并在验证报告中记录跳过原因\n\n简化代码审查的输入应限定为本次改动 diff、tasks.md 和必要的测试结果；审查范围只覆盖实现正确性、安全风险和边界条件，不执行 spec 覆盖率、Design Doc 一致性或漂移检查。若审查发现 CRITICAL 或 IMPORTANT 问题，按验证失败处理并进入 Step 1b。`review_mode: off` 只跳过自动 code review，不跳过构建、测试、安全检查或异常调试协议。\n\n**与 build 阶段审查的去重**：若 build 阶段（`executing-plans` 或 `subagent-driven-development`）已按 `review_mode` 对同一 diff 完成最终代码审查，verify 的这次轻量审查聚焦「实现是否符合 spec\u002Ftasks 的正确性」与「build 之后新增的改动」，不重复评审 build 已审过且未变化的 diff。\n\n**通过标准**：6 项全部 OK，无 CRITICAL 或 IMPORTANT 问题。\n\n**不通过时**：报告失败项，进入 Step 1b 的验证失败决策阻塞点。用户选择修复后，才执行以下命令记录失败并回退到 build 阶段，然后调用 `\u002Fcomet-build` 修复：\n\n```bash\n# 仅在用户确认修复后执行\nnode \"$COMET_STATE\" transition \u003Cchange-name> verify-fail\n```\n\n**报告格式**：简表列出 6 项检查结果 + PASS\u002FFAIL。\n\n**跳过项**（不在轻量验证中检查）：\n- spec scenario 覆盖率\n- design doc 一致性深度比对\n- 不影响正确性、安全、边界条件的 code pattern consistency 建议\n- delta spec 与 design doc 漂移检测\n\n### 2b. 完整验证（大改动）\n\n当规模评估结果为\"大\"时：\n\n**立即执行：** 使用 Skill 工具加载 `openspec-verify-change` 技能。禁止跳过此步骤。\n\n技能加载后，按其指引验证。检查项：\n1. tasks.md 全部任务已完成（`[x]`）\n2. 实现符合 `openspec\u002Fchanges\u002F\u003Cname>\u002Fdesign.md` 高层设计决策\n3. 实现符合 Design Doc（`docs\u002Fsuperpowers\u002Fspecs\u002F` 下的技术设计文档）\n4. 能力规格场景全部通过\n5. proposal.md 目标已满足\n6. delta spec 与 design doc 无矛盾（若 Build 阶段有增量修改 spec，检查 design doc 是否有对应记录）\n7. `docs\u002Fsuperpowers\u002Fspecs\u002F` 关联的设计文档可定位（文件存在且与当前 change 相关）\n\n验证不通过时：报告缺失项，进入 Step 1b 的验证失败决策阻塞点。用户选择修复后，才执行以下命令记录失败并回退到 build 阶段，然后调用 `\u002Fcomet-build` 补充：\n\n```bash\n# 仅在用户确认修复后执行\nnode \"$COMET_STATE\" transition \u003Cchange-name> verify-fail\n```\n\n**Spec 漂移处理**（用户决策点）：\n- 若检查项 6 发现矛盾（delta spec 有内容但 design doc 未体现），**必须使用当前平台可用的用户输入\u002F确认机制以单选题形式暂停并等待用户选择处理方式**，不得自动选择。选项：\n  - 选项 A：在 design doc 追加 \"Implementation Divergence\" 节记录偏差原因。选项 A 属于 verify 阶段允许产物；写入后不得因该 design doc 变更再次触发 Step 1b dirty-worktree 决策\n  - 选项 B：用户选择 B 后，运行 `node \"$COMET_STATE\" transition \u003Cchange-name> verify-fail`，然后调用 `\u002Fcomet-build`；由 `\u002Fcomet-build` 的 Spec 增量更新规则加载 Superpowers `brainstorming` 更新 Design Doc + delta spec\n  - 选项 C：确认偏差可接受，继续验证（归档时 design doc 将标记为 `superseded-by-main-spec`）\n\n### 3. 收尾（Superpowers）\n\n**立即执行：** 使用 Skill 工具加载 Superpowers `finishing-a-development-branch` 技能。禁止跳过此步骤。\n\n如 Superpowers `finishing-a-development-branch` 技能不可用，停止流程并提示安装或启用 Superpowers 技能，不要用普通对话替代该步骤。\n\n技能加载后，按其指引收尾。分支处理选项：\n1. 本地合并到主分支\n2. 推送并创建 PR\n3. 保持分支（稍后处理）\n4. 丢弃工作\n\n这是用户决策点。**必须按 `comet\u002Freference\u002Fdecision-point.md` 的协议暂停并等待用户选择分支处理方式**，不得根据推荐、默认值或当前分支状态自行选择。只有在用户完成选择且对应操作完成后，才允许写入 `branch_status: handled`。\n\n**确认项**：\n- 全部测试通过\n- 无硬编码密钥或安全问题\n\n### 4. 记录验证证据\n\n验证报告必须落盘，并在 `.comet.yaml` 中记录；分支处理完成后也必须写入状态字段。不要手动设置 `verify_result: pass`，由阶段守卫 `--apply` 推进。\n\n```bash\nmkdir -p docs\u002Fsuperpowers\u002Freports\n# 将本次验证结论写入报告文件，例如：\n# docs\u002Fsuperpowers\u002Freports\u002FYYYY-MM-DD-\u003Cchange-name>-verify.md\n\nnode \"$COMET_STATE\" set \u003Cchange-name> verification_report docs\u002Fsuperpowers\u002Freports\u002FYYYY-MM-DD-\u003Cchange-name>-verify.md\nnode \"$COMET_STATE\" set \u003Cchange-name> branch_status handled\n```\n\n## 退出条件\n\n- 验证报告通过\n- 分支已处理\n- `.comet.yaml` 中 `verification_report` 指向已存在的验证报告文件\n- `.comet.yaml` 中 `branch_status: handled`\n- **阶段守卫**：运行 `node \"$COMET_GUARD\" \u003Cchange-name> verify --apply`，全部 PASS 后由守卫通过 `comet-state transition verify-pass` 推进到 `phase: archive`（此步骤更新 `phase` 字段，与 `auto_transition` 无关）\n\n验证和分支处理均完成后，运行阶段守卫推进 phase（此步骤与 `auto_transition` 无关）：\n\n```bash\nnode \"$COMET_GUARD\" \u003Cchange-name> verify --apply\n```\n\n状态文件自动更新为 `phase: archive`、`verify_result: pass`、`verified_at: YYYY-MM-DD`。\n\n## 上下文压缩恢复\n\n按 `comet\u002Freference\u002Fcontext-recovery.md` 执行，phase 参数为 `verify`。\n\n## 自动衔接下一阶段\n\n按 `comet\u002Freference\u002Fauto-transition.md` 执行。关键命令：\n\n```bash\nnode \"$COMET_STATE\" next \u003Cchange-name>\n```\n\n- `NEXT: auto` → 调用 `SKILL` 指向的 skill 进入下一阶段\n- `NEXT: manual` → 不要调用下一 skill，按 `HINT` 提示用户手动运行 `\u002F\u003CSKILL>`\n- `NEXT: done` → 流程已完成，无需继续\n\n注意：无论 `NEXT` 为 `auto` 还是 `manual`，`comet-archive` 进入后必须先执行归档前最终确认阻塞点，等待用户明确选择「确认归档」后才允许运行归档脚本。不得因为验证已通过就自动归档。\n","# Comet 阶段 4：验证与收尾（Verify）\n\n## 前置条件\n\n- 代码已提交（阶段 3 完成）\n- tasks.md 全部任务已完成\n\n## 步骤\n\n### 0a. 输出语言约束\n\n验证报告和分支处理说明必须使用触发本次工作流的用户请求语言。\n\n### 0b. 入口状态验证（Entry Check）\n\n按 `comet\u002Freference\u002Fscripts.md` 定位脚本（定位 `comet-env.mjs`），然后执行入口验证；从任意入口恢复时先按 `comet\u002Freference\u002Fcontext-recovery.md` 运行恢复检查：\n\n```bash\nnode \"$COMET_STATE\" check \u003Cchange-name> verify\n```\n\n验证通过后继续 Step 1。验证失败时脚本会输出具体失败原因。\n\n**幂等性**：verify 阶段所有检查可安全重复执行。如 `verify_result` 已为 `pass` 且 `branch_status` 已为 `handled`，说明验证已完成，直接执行 guard 流转。如 `verify_result` 为 `pending`，从头开始验证。\n\n### 1. 改动规模评估\n\n执行规模评估：\n\n```bash\nnode \"$COMET_STATE\" scale \u003Cchange-name>\n```\n\n脚本自动统计任务数、增量规格数、变更文件数，判断使用 light 或 full 验证模式，并设置 verify_mode 字段。判定规则（满足任一即 full）：任务数 > 3、delta spec 能力数 > 1、变更文件数 > 8。\n\n验证开始前，按 `comet\u002Freference\u002Fdirty-worktree.md` 协议检查并处理未提交改动。verify 阶段的特殊处理：\n\n1. 若 dirty diff 属于当前 change 且涉及实现、测试、tasks、delta spec 或 design doc 变更，不在 verify 阶段直接修复或提交；报告失败项并进入 Step 1b 的验证失败决策阻塞点\n2. 若 dirty diff 只是 verify 本阶段产物（例如验证报告草稿、分支处理记录），可继续在 verify 阶段完成并记录状态\n3. 若 dirty diff 已实现但 tasks.md 未勾选，视为 build 状态滞后；报告失败项并进入 Step 1b，由用户决定回退修复或接受偏差\n\n用户选择修复后，才允许回退到 build 阶段：\n\n```bash\n# 仅在用户确认修复后执行\nnode \"$COMET_STATE\" transition \u003Cchange-name> verify-fail\n```\n\n注意：verify-fail 回退到 build 时 `branch_status` 不会被重置。如果首次 verify 已完成分支处理，修复后再次进入 verify 时跳过已完成的分支处理步骤，直接使用 `node \"$COMET_STATE\" set \u003Cchange-name> branch_status handled` 保留原有分支处理结果。\n\n注意：如果 build 阶段每个任务都已提交，脚本基于工作区 diff 的文件数可能低估改动规模。此时必须读取 plan 文件头的 `base-ref` 并用提交区间复核：\n\n```bash\nPLAN=$(node \"$COMET_STATE\" get \u003Cchange-name> plan)\nBASE_REF=$(grep '^base-ref:' \"$PLAN\" 2>\u002Fdev\u002Fnull | head -1 | sed 's\u002F^base-ref: *\u002F\u002F')\ngit diff --stat \"$BASE_REF\"...HEAD\n```\n\n若提交区间显示改动超过轻量阈值（> 8 个文件、跨模块协调、或 delta spec 超过 1 个 capability），手动设置为完整验证：\n\n```bash\nnode \"$COMET_STATE\" set \u003Cchange-name> verify_mode full\n```\n\n**覆盖机制**：如 agent 或用户认为自动评估结果不合适，可随时通过 `node \"$COMET_STATE\" set \u003Cchange-name> verify_mode \u003Clight|full>` 手动覆盖。\n\n### 1b. 验证失败决策（阻塞点）\n\n验证不通过时**必须按 `comet\u002Freference\u002Fdecision-point.md` 的协议暂停并等待用户决定修复或接受偏差**。不得自动运行 `node \"$COMET_STATE\" transition \u003Cchange-name> verify-fail`，也不得自动调用 `\u002Fcomet-build`。\n\n暂停时必须列出：\n- 失败项\n- 是否属于 CRITICAL 或 IMPORTANT（构建失败、测试失败、安全问题、核心验收场景失败、简化代码审查发现的正确性\u002F安全\u002F边界问题）\n- 推荐处理方式\n\n**不确定性原则**：无法确定严重程度时，降级处理（SUGGESTION > WARNING > CRITICAL）。仅对构建失败、测试失败、安全问题使用 CRITICAL；模糊或不确定的问题标为 WARNING 或 SUGGESTION。\n\n用户选择后按以下方式继续：\n- **全部修复**：运行 `node \"$COMET_STATE\" transition \u003Cchange-name> verify-fail`，然后调用 `\u002Fcomet-build` 修复\n- **逐项处理**：CRITICAL 或 IMPORTANT 失败项必须修复；WARNING\u002FSUGGESTION 失败项可选择接受偏差，但必须在验证报告中记录接受原因和影响范围。若存在任何 CRITICAL 或 IMPORTANT 失败项，不允许跳过修复直接全部接受\n\n**重试上限**：连续 3 次 verify-fail 循环后，第 4 次失败时代理不得自动选择继续修复；**必须使用当前平台可用的用户输入\u002F确认机制暂停**，仅给出两个选项：「接受所有偏差并记录」或「继续修复」，由用户明确决定。\n\n### 2. 产物上下文加载（Hash 按需读）\n\n验证需要读取 OpenSpec 产物时，先检查产物是否自 design 阶段以来发生变化：\n\n```bash\nRECORDED_HASH=$(node \"$COMET_STATE\" get \u003Cchange-name> handoff_hash)\nCURRENT_HASH=$(node \"$COMET_HANDOFF\" \u003Cchange-name> --hash-only 2>\u002Fdev\u002Fnull || echo \"\")\n```\n\n- 若 `RECORDED_HASH` = `CURRENT_HASH` 且均非空且均非 `null`：OpenSpec 产物未变化，**tasks.md 无需重新读取全文**（用 `grep -c '\\- \\[ \\]' tasks.md` 确认完成数即可）。proposal.md、design.md、delta spec 仍需读取用于对照检查。\n- 若 `RECORDED_HASH` 为空、为 `null`、或与 `CURRENT_HASH` 不一致：产物已变化或 hash 未记录，正常读取所有所需文件全文。\n\n此优化仅跳过 tasks.md 的重复全文读取。proposal.md 和 design.md 包含验证检查项所需的完整上下文，不得因 hash 匹配而跳过。\n\n**立即执行：** 使用 Skill 工具加载 Superpowers `verification-before-completion` 技能。禁止跳过此步骤。\n\n技能加载后，按 verify_mode 分支执行：\n\n### 2a. 轻量验证（小改动）\n\n按以下 6 项进行检查：\n\n1. tasks.md 全部任务已完成 `[x]`\n2. 改动文件与 tasks.md 描述一致（`git diff --stat` \u002F `git diff --cached --stat` \u002F `git diff --stat \u003Cbase-ref>...HEAD` 对照 tasks 内容）\n3. 编译通过（执行项目对应的构建命令，如 `npm run build`、`mvn compile`、`cargo build` 等）\n4. 相关测试通过\n5. 无明显安全问题（无硬编码密钥、无新增 unsafe 操作）\n6. 代码审查策略：当 `review_mode: standard` 或 `thorough` 时，必须使用 Skill 工具加载 Superpowers `requesting-code-review` 技能，请求只检查正确性、安全、边界条件的轻量代码审查；当 `review_mode: off` 时跳过自动代码审查，并在验证报告中记录跳过原因\n\n简化代码审查的输入应限定为本次改动 diff、tasks.md 和必要的测试结果；审查范围只覆盖实现正确性、安全风险和边界条件，不执行 spec 覆盖率、Design Doc 一致性或漂移检查。若审查发现 CRITICAL 或 IMPORTANT 问题，按验证失败处理并进入 Step 1b。`review_mode: off` 只跳过自动 code review，不跳过构建、测试、安全检查或异常调试协议。\n\n**与 build 阶段审查的去重**：若 build 阶段（`executing-plans` 或 `subagent-driven-development`）已按 `review_mode` 对同一 diff 完成最终代码审查，verify 的这次轻量审查聚焦「实现是否符合 spec\u002Ftasks 的正确性」与「build 之后新增的改动」，不重复评审 build 已审过且未变化的 diff。\n\n**通过标准**：6 项全部 OK，无 CRITICAL 或 IMPORTANT 问题。\n\n**不通过时**：报告失败项，进入 Step 1b 的验证失败决策阻塞点。用户选择修复后，才执行以下命令记录失败并回退到 build 阶段，然后调用 `\u002Fcomet-build` 修复：\n\n```bash\n# 仅在用户确认修复后执行\nnode \"$COMET_STATE\" transition \u003Cchange-name> verify-fail\n```\n\n**报告格式**：简表列出 6 项检查结果 + PASS\u002FFAIL。\n\n**跳过项**（不在轻量验证中检查）：\n- spec scenario 覆盖率\n- design doc 一致性深度比对\n- 不影响正确性、安全、边界条件的 code pattern consistency 建议\n- delta spec 与 design doc 漂移检测\n\n### 2b. 完整验证（大改动）\n\n当规模评估结果为\"大\"时：\n\n**立即执行：** 使用 Skill 工具加载 `openspec-verify-change` 技能。禁止跳过此步骤。\n\n技能加载后，按其指引验证。检查项：\n1. tasks.md 全部任务已完成（`[x]`）\n2. 实现符合 `openspec\u002Fchanges\u002F\u003Cname>\u002Fdesign.md` 高层设计决策\n3. 实现符合 Design Doc（`docs\u002Fsuperpowers\u002Fspecs\u002F` 下的技术设计文档）\n4. 能力规格场景全部通过\n5. proposal.md 目标已满足\n6. delta spec 与 design doc 无矛盾（若 Build 阶段有增量修改 spec，检查 design doc 是否有对应记录）\n7. `docs\u002Fsuperpowers\u002Fspecs\u002F` 关联的设计文档可定位（文件存在且与当前 change 相关）\n\n验证不通过时：报告缺失项，进入 Step 1b 的验证失败决策阻塞点。用户选择修复后，才执行以下命令记录失败并回退到 build 阶段，然后调用 `\u002Fcomet-build` 补充：\n\n```bash\n# 仅在用户确认修复后执行\nnode \"$COMET_STATE\" transition \u003Cchange-name> verify-fail\n```\n\n**Spec 漂移处理**（用户决策点）：\n- 若检查项 6 发现矛盾（delta spec 有内容但 design doc 未体现），**必须使用当前平台可用的用户输入\u002F确认机制以单选题形式暂停并等待用户选择处理方式**，不得自动选择。选项：\n  - 选项 A：在 design doc 追加 \"Implementation Divergence\" 节记录偏差原因。选项 A 属于 verify 阶段允许产物；写入后不得因该 design doc 变更再次触发 Step 1b dirty-worktree 决策\n  - 选项 B：用户选择 B 后，运行 `node \"$COMET_STATE\" transition \u003Cchange-name> verify-fail`，然后调用 `\u002Fcomet-build`；由 `\u002Fcomet-build` 的 Spec 增量更新规则加载 Superpowers `brainstorming` 更新 Design Doc + delta spec\n  - 选项 C：确认偏差可接受，继续验证（归档时 design doc 将标记为 `superseded-by-main-spec`）\n\n### 3. 收尾（Superpowers）\n\n**立即执行：** 使用 Skill 工具加载 Superpowers `finishing-a-development-branch` 技能。禁止跳过此步骤。\n\n如 Superpowers `finishing-a-development-branch` 技能不可用，停止流程并提示安装或启用 Superpowers 技能，不要用普通对话替代该步骤。\n\n技能加载后，按其指引收尾。分支处理选项：\n1. 本地合并到主分支\n2. 推送并创建 PR\n3. 保持分支（稍后处理）\n4. 丢弃工作\n\n这是用户决策点。**必须按 `comet\u002Freference\u002Fdecision-point.md` 的协议暂停并等待用户选择分支处理方式**，不得根据推荐、默认值或当前分支状态自行选择。只有在用户完成选择且对应操作完成后，才允许写入 `branch_status: handled`。\n\n**确认项**：\n- 全部测试通过\n- 无硬编码密钥或安全问题\n\n### 4. 记录验证证据\n\n验证报告必须落盘，并在 `.comet.yaml` 中记录；分支处理完成后也必须写入状态字段。不要手动设置 `verify_result: pass`，由阶段守卫 `--apply` 推进。\n\n```bash\nmkdir -p docs\u002Fsuperpowers\u002Freports\n# 将本次验证结论写入报告文件，例如：\n# docs\u002Fsuperpowers\u002Freports\u002FYYYY-MM-DD-\u003Cchange-name>-verify.md\n\nnode \"$COMET_STATE\" set \u003Cchange-name> verification_report docs\u002Fsuperpowers\u002Freports\u002FYYYY-MM-DD-\u003Cchange-name>-verify.md\nnode \"$COMET_STATE\" set \u003Cchange-name> branch_status handled\n```\n\n## 退出条件\n\n- 验证报告通过\n- 分支已处理\n- `.comet.yaml` 中 `verification_report` 指向已存在的验证报告文件\n- `.comet.yaml` 中 `branch_status: handled`\n- **阶段守卫**：运行 `node \"$COMET_GUARD\" \u003Cchange-name> verify --apply`，全部 PASS 后由守卫通过 `comet-state transition verify-pass` 推进到 `phase: archive`（此步骤更新 `phase` 字段，与 `auto_transition` 无关）\n\n验证和分支处理均完成后，运行阶段守卫推进 phase（此步骤与 `auto_transition` 无关）：\n\n```bash\nnode \"$COMET_GUARD\" \u003Cchange-name> verify --apply\n```\n\n状态文件自动更新为 `phase: archive`、`verify_result: pass`、`verified_at: YYYY-MM-DD`。\n\n## 上下文压缩恢复\n\n按 `comet\u002Freference\u002Fcontext-recovery.md` 执行，phase 参数为 `verify`。\n\n## 自动衔接下一阶段\n\n按 `comet\u002Freference\u002Fauto-transition.md` 执行。关键命令：\n\n```bash\nnode \"$COMET_STATE\" next \u003Cchange-name>\n```\n\n- `NEXT: auto` → 调用 `SKILL` 指向的 skill 进入下一阶段\n- `NEXT: manual` → 不要调用下一 skill，按 `HINT` 提示用户手动运行 `\u002F\u003CSKILL>`\n- `NEXT: done` → 流程已完成，无需继续\n\n注意：无论 `NEXT` 为 `auto` 还是 `manual`，`comet-archive` 进入后必须先执行归档前最终确认阻塞点，等待用户明确选择「确认归档」后才允许运行归档脚本。不得因为验证已通过就自动归档。\n",{"name":5,"description":7},"master","a61a2e5b4766e1ad62377dec598e402560a259b6","eval\u002Flocal\u002Fskills\u002Fbenchmarks\u002F040-beta\u002Fcomet-verify",314,"https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet","https:\u002F\u002Fdocs.comet.rpamis.com","https:\u002F\u002Fgithub.com\u002Frpamis","More Efficient, Easier to Use, and Less Annoying","2026-11-15 00:26:58",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add rpamis\u002Fcomet --skill comet-verify",{"tool":38,"command":39},"bunx","bunx skills add rpamis\u002Fcomet --skill comet-verify",{"tool":41,"command":42},"pnpm","pnpm dlx skills add rpamis\u002Fcomet --skill comet-verify","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002F040-beta\u002Fcomet-verify\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":18},"01M72W3K6F0C2FKZ8DHABM49R7","writing-skills","Use when creating new skills, editing existing skills, or verifying skills work before deployment","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":18},"01M72W3HCPQ3GVMACX61QJTD4B","writing-plans","Use when you have a spec or requirements for a multi-step task, before touching code","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M72W3F8EVD3EK4NXJG40P84K","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","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fverification-before-completion\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M72W3CA9YM0Y6CSXXTNCV1CA","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","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fusing-git-worktrees\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M72W3AEH0F548GTPRNYRR3H3","test-driven-development","Use when implementing any feature or bugfix, before writing implementation code","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M72W38EN8NEKX1YN4W9G19Y2","systematic-debugging","Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes","https:\u002F\u002Fgithub.com\u002Frpamis\u002Fcomet\u002Fblob\u002Fmaster\u002Feval\u002Flocal\u002Fskills\u002Fbenchmarks\u002Fdependency\u002Fsuperpowers\u002Fsystematic-debugging\u002FSKILL.md",[],[]]