hekouwang-harness-check-skillSAFE

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: hekouwang-harness-check-skill
license: MIT
description: 当用户要求检查、体检、回归、验收、解释或诊断会勇禾口王内容工作流 Harness,或维护、移植、打包、开源这个 Harness 检查器 Skill 时使用。统一调用 verify.sh 及治理、Hook、安全门、Episode 等检查,分别报告本地、暂存区、CI 与真实宿主边界。具体 EP 的文章、实验选型和渠道交付预检由仓内 hekouwang-precheck 负责。
metadata:
  slug: hekouwang-harness-check-skill
  display_name: hekouwang Harness Check
  version: 1.0.0
  summary: 证据驱动的 Agent Harness 独立验收器:检查本地、暂存区、CI、Hook、治理契约和真实宿主边界。
  tags: harness, agent, governance, verification, audit
  homepage: https://huiyonghkw.github.io/hekouwang-harness-check-skill/
allowed-tools:
  - Bash
  - Read
  - Glob
  - Grep
---

# 会勇禾口王 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`。

## 执行规则

1. 直接运行命令并保留退出码。不要用 `| head`、`|| true` 或吞掉 stderr 的方式判断成功。
2. 需要保存长日志时写入临时目录,完整读取失败段;不要把临时日志当成任务证据提交。
3. 先报告自动化结果,再报告人工检查;两者不能合并成一个“全部通过”。
4. 从实际输出读取检查数量。`--ci` 是本机 fixture 回归,只有 `--ci-hermetic` 才能证明干净 clone 的 CI 入口可复现。基础闭环曾输出本地 `722`、CI `165` 项;这些都不是永久硬编码的总分;数量变化时如实记录,不自行补算或夸大。
5. `⚠️` 是警告,不等于 `✅`;只要任一应通过检查返回非零,就判定自动检查失败。
6. 检查失败时先指出失败命令、失败项目和可复现路径。只有用户明确要求修复时才改文件;改前遵守 `AGENTS.md` 的范围说明和确认规则。
7. 不使用 `--no-verify` 绕过 Hook,不为让检查通过而修改计数、删除反例、关闭治理项或把宿主烟测写成自动化证据。

## 结果报告格式

至少输出以下五部分:

1. **模式与范围**:`working-tree`、`staged`、`ci` 或 `ci-hermetic`,以及检查到的仓库/提交。
2. **自动化结论**:命令退出状态;列出通过、失败和警告。若输出包含 Runtime Governance 数量,注明是本地还是 CI。
3. **失败定位**:保留原始检查标签和复现命令,不把“工具没输出”解释成通过。
4. **人工/宿主边界**:说明是否实际触发了 Claude Code、Cursor、CodeBuddy、Codex 的 Hook;是否检查了真实平台视觉、浏览器或 MCP 外部副作用。
5. **下一步**:修复、补宿主烟测、记录失败台账,或明确“自动化通过但不能交付”的原因。

## 不能替代的人工检查

语义 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`](references/check-matrix.md)。面向维护者的开源说明和流程图见 [`README.md`](README.md)。

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (7)

然后打开 <http://127.0.0.1:4173/?lang=zh>。

完整中文 Guide:<http://127.0.0.1:4173/guide/index.html?lang=zh>。产品首页负责定位、动态 GIF、交互 Scorecard 和证据展示;Guide 页负责从“什么是 Harness”到 Hook、Evaluator、失败台账、独立验收和 CLI 的连续阅读。

website/assets/fonts/GoogleSansText-Medium.ttf

website/assets/fonts/GoogleSansText-Regular.ttf

website/assets/fonts/NotoSansSC-Variable-FULL.woff2

website/assets/harness-doctor-icon.png

website/assets/harness-doctor-run.gif

Gates applied: no_behavioural_pass.