huiyonghkw 会勇禾口王 Harness 检查器
目标
把 Harness 检查变成可重复、可审计的交付动作。检查逻辑以仓库 .harness/ 为唯一真源；本 Skill 负责选择入口、完整执行、解释结果和暴露未覆盖边界，不复制或改写检查规则。
入口选择
先定位仓库根目录：必须能找到 .harness/scripts/verify.sh。所有命令从仓库根目录运行。
| 用户目的 | 入口 |
|---|---|
| 检查当前本地工作区 | bash .harness/scripts/verify.sh --working-tree |
| 检查准备提交的治理改动 | bash .harness/scripts/verify.sh --staged |
| 本机 CI 契约/fixture 回归 | bash .harness/scripts/verify.sh --ci |
| 复现远端 CI、排除本机 Skill/宿主软链 | bash .harness/scripts/verify.sh --ci-hermetic |
| 只诊断结构、链接和治理契约 | bash .harness/scripts/harness-check.sh --local 或 --ci |
不要默认只跑 harness-check.sh 就宣称 Harness 完成；完整验收应优先使用 verify.sh。
执行规则
- 直接运行命令并保留退出码。不要用
| head、|| true或吞掉 stderr 的方式判断成功。 - 需要保存长日志时写入临时目录，完整读取失败段；不要把临时日志当成任务证据提交。
- 先报告自动化结果，再报告人工检查；两者不能合并成一个“全部通过”。
- 从实际输出读取检查数量。
--ci是本机 fixture 回归，只有--ci-hermetic才能证明干净 clone 的 CI 入口可复现。基础闭环曾输出本地722、CI165项；这些都不是永久硬编码的总分；数量变化时如实记录，不自行补算或夸大。 ⚠️是警告，不等于✅；只要任一应通过检查返回非零，就判定自动检查失败。- 检查失败时先指出失败命令、失败项目和可复现路径。只有用户明确要求修复时才改文件；改前遵守
AGENTS.md的范围说明和确认规则。 - 不使用
--no-verify绕过 Hook，不为让检查通过而修改计数、删除反例、关闭治理项或把宿主烟测写成自动化证据。
结果报告格式
至少输出以下五部分：
- 模式与范围：
working-tree、staged、ci或ci-hermetic，以及检查到的仓库/提交。 - 自动化结论：命令退出状态；列出通过、失败和警告。若输出包含 Runtime Governance 数量，注明是本地还是 CI。
- 失败定位：保留原始检查标签和复现命令，不把“工具没输出”解释成通过。
- 人工/宿主边界：说明是否实际触发了 Claude Code、Cursor、CodeBuddy、Codex 的 Hook；是否检查了真实平台视觉、浏览器或 MCP 外部副作用。
- 下一步：修复、补宿主烟测、记录失败台账，或明确“自动化通过但不能交付”的原因。
不能替代的人工检查
语义 Hook 配置校验和 fixture 正反例只能证明配置可解析、规则可归一化、失败路径能被拦截，不能证明真实宿主一定触发。以下情况必须单独标记为“宿主烟测待补”：
- 在四个真实 Agent 宿主中触发一次允许、询问和阻断路径；
- 在真实编辑器、浏览器、公众号/头条/小红书宿主中检查最终呈现；
- 检查文章事实、来源、自然度和视觉质量；
- 检查 MCP 工具的真实外部副作用和人工确认链路。
失败后的最小动作
verify.sh失败：按输出先运行对应的单项测试，例如bash .harness/tests/test-hook-config.sh。- 适配链接失败：先查看
bash .harness/scripts/sync-agent-adapters.sh --check；未经用户明确要求，不自动使用--fix。 - Runtime Governance 漂移：检查
.harness/contracts/、AGENTS.md、.agents/skills/和 Memory 真源，不直接改测试让它变绿。 - 内容任务预检：同时加载
hekouwang-precheck，并把自动检查和人工视觉检查分开报告。
详细命令、检查层级和历史基线/当前数量口径见 references/check-matrix.md。面向维护者的开源说明和流程图见 README.md。