delivery-verification

name	delivery-verification
description	Use when validating evidence manifests, deciding dev_done/integration_done/handoff_done claims, issuing verifier attestations, preventing completion overclaim, or requiring fresh consumer / real external verification. 当任务需要证据矩阵、交付验收、claim attestation、fresh consumer、real external、E2E/integration/system 证据或防止假完成时使用。

Delivery Verification

目标：只让 verifier 根据证据出具 attestation。实现者可以请求 claim，但不能自己生成 validated claim。

Evidence Manifest

Canonical input 是 JSON：

{
  "evidence_manifest_id": "ev-001",
  "acceptance_contract_path": "docs/evidence/acceptance-contract.json",
  "acceptance_contract_digest": "sha256:<acceptance-contract>",
  "spec_digest": "sha256:<approved-spec>",
  "required_acceptance_ids": ["AC-1"],
  "claim_requested": "integration_done",
  "acceptance_coverage": [],
  "validators": [],
  "deferred": [],
  "review_focus": []
}

Claim Rules

• dev_done: 至少一个 passing focused validator，可为 unit、manual、diff_review、build、lint、typecheck、integration、e2e、system、fresh_consumer、real_external。
• integration_done: 至少一个 passing integration、e2e、system、fresh_consumer 或 real_external validator。
• handoff_done: 至少一个 passing fresh_consumer 或 real_external validator。

mock、fake、static 证据不能单独支撑 integration_done 或 handoff_done。

每条 acceptance 必须引用至少一个 passing validator。claim 所需的证据类型必须来自 acceptance 实际引用的 passing validator；未被 acceptance coverage 引用的全局 PASS 不能签发 claim。

required_acceptance_ids 必须来自 acceptance-contract.json，且与 acceptance_coverage 完全相等；不得只挑选已通过的 acceptance。该 contract 必须是 Spec review 已批准并登记进 artifact graph 的 canonical artifact：producer=specflow、semantic_owner=spec-review，同时绑定 approved Spec path/digest 和完整 acceptance 集合。validator 必须从 repo root 重算两层 digest，不能相信 evidence 自报或实现者另建的 companion。

references/verifier-registry.json 是 verifier authority 的 canonical registry。workflow-control-plane 可以读取它来拒绝不可信 claim，但不要在别的 skill 中复制 claim 规则。

Validation

python3 skills/delivery-verification/scripts/validate_evidence_manifest.py evidence_manifest.json --repo-root .

通过后生成 attestation：

python3 skills/delivery-verification/scripts/issue_claim_attestation.py \
  evidence_manifest.json workflow_manifest.json \
  --verifier evidence-manifest-validator --repo-root . \
  --output claim_attestation.json

把该 JSON 放入 transition request 的 claim_attestations[]。只有 workflow-control-plane 能记录 claims.validated[]。

本地 attestation 是可重复校验的 evidence binding，不是密码学身份认证：签发要求 clean Git HEAD，并绑定 approved Spec、完整 acceptance、真实 evidence 文件和 verifier registry。面对不可信执行者或 prompt injection，必须由隔离 CI/外部 verifier 持有签名密钥或发布权限；不要把本地 producer 字符串当安全身份。