用途:这是 SAM 流水线第 6 阶段(Forensic Review)的编排包装技能。核心原则是 AI 无法可靠自评,写代码的代理不能客观评估自己的工作,因此必须由另一个具备全新上下文的代理,依据可观察证据核验声明。生产方与评审方必须始终是不同代理,禁止由执行任务的同一代理调用本技能。
主要能力:解析任务上下文、派发 @dh:code-reviewer、把其结构化输出映射回 SAM 流水线判定,并登记评审工件。
使用方式:在 Stage 5 执行产出 ARTIFACT:EXECUTION 后、每个任务标记完成前,或 NEEDS_WORK 整改周期后重新评审时使用。流程为:先用 sam_cli plan read --address {plan_id}/{task_id} 读取任务及其各次尝试记录(不加 --attempt),提取 item_id(缺失则立即 BLOCK)、expected_outputs、acceptance_criteria;再以 subagent_type="dh:code-reviewer" 派发评审,提示中带上 plan_id、task_id、item_id、implementation_files;解析其 STATUS 中的 Verdict,PASS 映射为 COMPLETE,NEEDS-WORK 或 FAIL 映射为 NEEDS_WORK,STATUS: BLOCKED 则向上游传播;随后用 artifact_read(item_id={item_id}, artifact_type="code-review", artifact_id="{artifact_id}") 读取 code-review 工件,并用 sam_cli plan update --plan-address {plan_id} --task-id {task_id} --append-section "Review Results" --section-content "{artifact_content}" 追加评审结果。若 STATUS 未给出 artifact_id,可按 code-review-{task_id}-{plan_slug} 推导,plan_slug 取自 sam_cli plan status --plan-address {plan_id} 返回的 feature 字段,并用 artifact_list 精确匹配,禁止子串匹配或回退到最新 created_at。
适用场景:SAM 任务完成后的独立核验、整改后复审。
限制:判定必须来自 @dh:code-reviewer 的 STATUS,不得自行编造;整改阻塞项须取自 code-review 工件而非代理摘要;不得新增需求,只对照原始验收标准;Verification Gap 类发现始终为阻塞项。使用 sam_cli 或 dh_scripts 前需先加载 dh:dh-cli-usage。