[ PROMPT_NODE_24892 ]
钩子开发工具脚本
[ SKILL_DOCUMENTATION ]
# 钩子开发实用脚本
这些脚本有助于在部署前验证、测试和检查钩子实现。
## validate-hook-schema.sh
验证 `hooks.json` 配置文件是否存在结构错误和常见问题。
**用法:**
bash
./validate-hook-schema.sh path/to/hooks.json
**检查项:**
- 有效的 JSON 语法
- 必需字段是否存在
- 有效的钩子事件名称
- 正确的钩子类型 (command/prompt)
- 超时值在有效范围内
- 硬编码路径检测
- 提示词钩子事件兼容性
## test-hook.sh
在部署到 Claude Code 之前,使用示例输入测试单个钩子脚本。
**用法:**
bash
./test-hook.sh [options]
**选项:**
- `-v, --verbose` - 显示详细执行信息
- `-t, --timeout N` - 设置超时时间(秒,默认:60)
- `--create-sample ` - 生成示例测试输入
## hook-linter.sh
检查钩子脚本是否存在常见问题和违反最佳实践的情况。
**用法:**
bash
./hook-linter.sh [hook-script2.sh ...]
**检查项:**
- Shebang 是否存在
- `set -euo pipefail` 的使用
- Stdin 输入读取
- 正确的错误处理
- 变量引用(防止注入)
- 退出代码的使用
- 硬编码路径
- 长时间运行代码检测
- 错误输出到 stderr
- 输入验证