hanzhangzzz hook-test-kit
给 hook 脚本配一套行为矩阵测试。hook 是用户环境里的高频基建，一个静默放行/误报 直接影响每一次会话——它值得和业务代码同等的测试纪律。
前置依赖
bash、git、jq（which jq检查，缺失即停下说明）- 被测 hook 脚本路径
执行步骤
1. 生成骨架
bash <本 SKILL.md 所在目录>/scripts/scaffold.sh <hook 脚本路径> [输出目录]
输出 <输出目录|hook 同目录>/test_<hook名>.sh，含可运行的 run/assert 协议与 2 个
TODO 场景。骨架已预修以下高频坑，不要改掉：
- 辅助函数用
local d="$1"; shift转发参数，不把路径混进子命令 - 输出文本中变量一律
${var}花括号（$var后紧跟全角字符会被 bash 吃进变量名） - 断言协议：
EMPTY= 输出必须为空；!pattern= 必须不命中；其余 = egrep 必须命中 case的 pattern 来自变量时不解析|交替与[...]字符类——多模式用循环逐个判定
2. 按 hook 语义填场景
最小矩阵（每个 hook 至少覆盖）：
| 维度 | 场景 |
|---|---|
| 快速门 | 非 hook 目标命令 → 放行/无输出 |
| 主路径放行 | 正常输入 → 预期放行（断言退出码与输出均为空或合法 JSON） |
| 主路径拦截 | 越界输入 → 预期 ask/deny（断言 permissionDecision 与文案） |
| 变异防护 | 每条拦截规则改坏一版（取反/删条件）跑套件必须变红，改回必须复绿 |
PreToolUse 喂 {"tool_input":{"command":...},"cwd":...}；SessionStart 喂 {}；
UserPromptSubmit 喂 {"prompt":...,"cwd":...}。以被测 hook 实际读取的字段为准。
fixture 一律放 scratch 目录（mktemp -d + trap 清理），需要 git 仓库就现场 init；
绝不指向用户真实目录。
3. 收尾：变异实验
套件全绿后，对每条拦截规则做一次变异（取反、删条件、改边界），确认套件变红； 改回后复绿。不变红的断言是装饰，删掉或写尖锐。这一步没做，测试不算交付。
输出格式
- 测试文件落在被测 hook 同目录（或指定输出目录），命名
test_<hook名>.sh - 结尾输出
── 通过 N / 失败 M，退出码 0 仅当 M=0 - 向用户报告：场景数、变异实验结果、遗留盲区
错误处理
- hook 路径不存在 → 报错退出，不生成
- hook 无执行位 → 生成时顺带
chmod +x并提示 - 被测 hook 需要 GPU/浏览器等重环境 → 在场景里标注 SKIP 并如实报告未覆盖