用途:对一项已定义的软件变更做验收,让决策者无需依赖未记录的说法即可接受或拒绝该变更。验收本身不授权部署或合并;检查/验证请求保持只读,修复需另行提出实现请求。代码审查归 code-review-and-quality,无法解释的失败归 hai-debug。
主要能力:先建立审计契约,读取仓库指令层级,确定验收范围、实现边界、目标环境与报告位置,定位规格、决策、计划与评审整改,并在文档冲突时显式记录优先级(较晚批准的决策优先于早期计划,运行时契约优先于过时文字)。以当前 diff 加明确指定的已提交变更作为被测候选。
可追溯性:为每条可独立验证的需求建一行,记录需求 ID 与来源、保护的风险、预期可观察行为、实现证据(稳定文件与行引用)、验证方法与确切命令、观察结果、状态(PASS、PARTIAL、FAIL、BLOCKED、NOT RUN)及剩余人工工作。部分证明用 PARTIAL;跳过、不适用、历史日志、类型检查通过、代码存在或 mock 路径都不能算作已执行的行为通过。
风险面与验证:端到端追踪入口与授权、领域决策与状态转换、持久化与迁移、并发与幂等、外部调用与补偿、公共契约与兼容性、配置与特性开关、指标日志告警、安全与租户隔离。按层执行:静态完整性、单元/契约测试、真实依赖集成、端到端测试、运维探针。有状态测试优先使用一次性数据库或命名空间,从零应用迁移、播种确定性身份、运行后核对不变量并清理。记录确切命令、时间与环境事实、计数、退出状态、跳过与失败原因;环境不可用则标 BLOCKED 或 NOT RUN,不得从源码推断行为。
回归与误绿:将验收项分为 A0 全自动、A1 夹具集成、A2 受控预发、A3 实费金丝雀、M 产品/人工,并明确触发、隔离、断言、清理、产物、负责人、时间预算与防误绿措施。需显式检测跳过测试退出零、缺库静默跳过、陈旧数据满足断言、mock 绕过被测行为、重试掩盖重复写入、只查 HTTP 响应而持久化状态错误等误绿。
结论与报告:结论只能为 GO、CONDITIONAL GO、NO-GO;发现按 P0 至 P3 排序,说明影响、证据、复现与最小关闭证明。完整模式使用 assets/acceptance-report-template.md 结构,紧凑模式用小型需求/证据/状态表加范围化结论。报告应自包含,含结论与条件、范围与排除、规格优先级、系统/变更图、需求追溯矩阵、已执行证据台账、分级发现、详细验收用例、自动化覆盖与回归架构、发布门禁与签署清单、残余风险与跟进归属。工作报告按仓库政策放置,优先本地被忽略的工作文档目录。
限制:资料未提供具体安装命令、收费或平台信息;脚本 bash scripts/collect-repo-evidence.sh <repo> 仅打印元数据,不运行测试也不暴露 diff 内容。