用途:定义最小可重复的命令面,证明仓库改动足够安全可评审;把零散检查变成智能体可运行、CI 可复用、失败可诊断的命令。
主要能力:盘点现有命令与 CI;按仓库/文档、契约、单元/类型/lint、运行时、外部依赖分层设计验证矩阵;为每种变更类型选择最小命令与升级条件;设计统一入口(如 check_repo_harness 或 doctor 负责环境与结构,聚焦命令测行为);设计报告输出(stdout 给人看,JSON/JUnit 给 CI 与产物);要求记录跳过/回退原因,不得把降级验证说成完整验证。
使用方式:先搜索 package.json、Makefile、scripts、CI 工作流、测试目录与文档;若缺少共享验证入口,按 references/build-when-missing.md 引导最小命令面;环境探测与 CI 安全回退见 references/environment-bootstrap.md;共享术语见 ../../references/harness-patterns.md。输出格式含检测映射、变更类型矩阵、命令面、报告输出、CI 门禁、回退/跳过策略。
适用场景:需要 check_repo_harness.py、doctor.py、测试矩阵或 CI 门禁;现有验证命令分散、智能体不知该跑什么;需要 JSON/JUnit 或产物输出。
限制:需提供项目形态、主要面、现有测试命令、CI 配置、变更类型及各自最小门禁、是否需要运行时/打包环境/外部依赖/人工检查。检查要点:命令在干净检出或文档化设置下可运行;分层合理;失败能定位用例、路径、命令与产物;本地与 CI 一致;最小门禁快、重门禁仅高风险触发。常见错误:对所有变更都要求最重端到端检查、只给命令列表无变更矩阵、输出不稳定 JSON/JUnit、省略回退记录却声称完整运行时验证。