closed-loop

闭环执行（V 模型右臂）

机械化验证流水线。每个验证步骤都会生成与验收标准 ID（AC-n）关联的证据行。

适用场景

此验证框架默认不启用。以下情况运行：

• 通过 /closed-loop <task> 或 /closed-loop <spec-path> 调用。
• 用户要求执行闭环、进行规范验证或提供证据链。
• 00-inbox/MY-PROFILE.md 中的 verification_harness: on，且当前任务是构建任务。
• 声明了 normal+ 通道的其他技能进入验证步骤。

不要在用户未提出要求时运行。笔记、简报、研究、草稿和常规编辑都不属于验证框架运行；为这些任务维护检查点台账纯属额外负担。

阶段 0 — 通道 + 运行文件夹

bash .claude/lib/lane-classify.sh explain "<task>"
bash .claude/lib/checkpoint.sh init 04-projects/harness/runs/<YYYY-MM-DD-HHmm>

通道	检查点
tiny	CP-3 → CP-5（若有修改）
normal	CP-1 → CP-2 → CP-3 → CP-3v → CP-5
full	+ CP-4 + claim-verifier + CP-6
bug	在 CP-3 之前记录根因台账（CP-0）

记录：checkpoint.sh record <run-dir> CP-0 PASS|SKIP "<lane>"

阶段 1 — CP-1 规范（验收标准）

如果规范已存在，使用其中的 ## Acceptance criteria + 可追溯性矩阵。否则，使用 references/spec-template.md 编写：

04-projects/harness/runs/<id>/criteria.md（仅包含标准 + 矩阵部分）。

每项标准都必须：可证伪 + 带有 AC-n ID + 验证方法。

记录：checkpoint.sh record <run-dir> CP-1 PASS "N criteria"

阶段 2 — CP-2 计划

在 evidence/CP-2-plan.md 中将任务映射到 AC ID。将矩阵状态更新为 pending。

记录：checkpoint.sh record <run-dir> CP-2 PASS

阶段 3 — CP-3 构建

Worker 负责实现。仅返回交付物路径。

阶段 4 — CP-3v 组件验证

retry=0
loop:
  spawn task-verifier (fresh context, read-only)
  merge EVIDENCE rows into evidence/ledger.md
  if PASS → break
  if FAIL:escalate → record CP-3v FAIL, escalate
  if FAIL:fixable && retry < 2 → fix-agent → retry++
  else → escalate

将验证器的 EVIDENCE 行复制到 evidence/CP-3v-component.md。

记录：checkpoint.sh record <run-dir> CP-3v PASS|FAIL

阶段 5 — CP-4 集成验证（full 或多任务）

启动只读的 integration-verifier。将行追加到台账。

单任务 normal 可跳过。

记录：checkpoint.sh record <run-dir> CP-4 PASS|SKIP

阶段 6 — CP-5 验收（后置条件）

对于每项修改，观察产物（curl、截图、重新获取）。输出：

EVIDENCE AC-n | CP-5 | PASS | <observation> | <artifact>

**UI/UX 流程变更：**后置条件是视觉层面的。使用环境提供的任意浏览器工具，为每个有意义的状态截图，然后查看图像并确认没有溢出、错位、裁切、颜色错误或响应式布局损坏，再判定为 PASS。Observation 必须描述你看到的内容；artifact 是 evidence/ 中的截图/GIF。修复所有视觉缺陷并重新截图。参见 CLAUDE.md → Visual Verification。

编写 evidence/CP-5-acceptance.md。闭合可追溯性：矩阵中的每个 AC 在台账中都至少有 1 行 PASS 记录。

记录：checkpoint.sh record <run-dir> CP-5 PASS|FAIL

阶段 7 — 记录 + 交接

• 追加到 .claude/logs/loop-ledger.tsv
• 将规范可追溯性矩阵中的状态更新为 verified
• **full 通道 / 大型任务：**根据 references/report-template.html 生成 HTML 汇总报告 → 04-projects/harness/runs/<id>/report.html，内容取自 criteria.md + evidence/ledger.md（标准、AC 可追溯性、验证器结论、后置条件观察结果）。报告需自包含；通过 SendUserFile 发送，或发布为 Artifact。normal/tiny 通道可跳过。
• 建议使用 /retro <run-dir> 执行 CP-7

集成

技能	通道	CP-4
ultragoal	每个阶段均为 full（绝不降级）	integration-verifier + 北极星验收
team-brief	full	claim-verifier
comprehensive-analysis、auto-research	full	对引用的声明运行 claim-verifier
content-factory	normal	跳过
review-cockpit	normal	跳过；CP-6 是用户对每张卡片的审批

升级模板

ESCALATED — <task>
Lane: <lane> | Last CP: <CP-n>
Evidence bundle: 04-projects/harness/runs/<id>/evidence/
Open AC IDs: <list without PASS rows>
Decision needed: <one question>