Skip to main content

评审与证据

目标​

让 Hub 与各成员仓库变更以 branch、MR、源码审阅和精确 head 外部 CI 提供可审阅证据。

规则​

  • 写入型 changes 必须有 execution branch 和 review surface。
  • Hub/docs 写入仍是写入型 change，默认需要 branch + MR 或等价 producer review surface。 只有只读诊断、配置检查或外部状态确认这类 no_change_review 可以没有 MR/PR。
  • work-package-exe-issue 输出的 ADP_EXECUTION_RESULT 必须记录 execution_run、 workflow_dag、ledger、step_outputs、changed repos、verification、evidence、blockers 和 recommended Plane state。
  • 多 repo workflow 的 evidence 必须使用稳定 step_id 链；每个 changed_repos[].step_id 必须能回到 workflow_dag，且 repo step、Task、subagent、MR、evidence、step output 和 verification 保持单 repo。
  • Producer decision blocker evidence 必须包含 block_kind=producer_decision_required、 producer next action 和已冻结输入摘要；不得包含 Plane issue 创建、repo writes、split preview 或继续执行证据。
  • review-project-execution 默认只读复核，不代签 producer approval；发现 evidence、verification 不足时返回 required fixes 或 blocker；不得重新引入逐 MR/head Producer 再批准。
  • 证据记录 base branch、base commit、head commit、changed files、 validation commands、fact conflicts 和 residual risk。
  • 所属 principal 在源码审阅与精确 head 外部 CI 通过后，可按长期任务授权合并 MR 并经既有 发布路径交付；无需逐 MR/head 或既有发布单次批准。人类最终验收和 Issue Done 独立保留。
  • 任务之外的新生产目标、凭据身份/权限变更、重要数据删除须有明确用户指令；不得绕过 GitLab/CI/远端服务真实拒绝。保留路由与秘密保护，删除 scoped Codex 权限与文件白名单。
  • 本地验证禁止；无外部 CI 时记录无法验证。未经明确测试编写指令及具体用例或输入/预期 结果，不新增或扩写测试。交付记录：本地验证：根据项目策略禁止执行。