2.6 KiB
2.6 KiB
备用钩子池 (Standby Hooks)
19 个 Hook 脚本存在于 hooks/ 目录但未在 settings.json 中注册。
设计为按需激活，不默认注册以避免每次工具调用额外延迟。
激活方式
在 settings.json 的 hooks 对应阶段添加条目即可激活:
{
"matcher": "目标工具",
"hooks": [{
"type": "command",
"command": "node ~/.claude/hooks/<hook-name>.js",
"timeout": 3000
}]
}
备用钩子清单
代码质量类
| Hook | 建议阶段 | 匹配器 | 说明 |
|---|---|---|---|
| check-lint.js | PostToolUse | Edit|Write | ESLint 检查，编辑后自动 lint |
| check-typescript.js | PostToolUse | Edit|Write | TypeScript 类型检查 |
| code-quality-gate.js | PostToolUse | Edit|Write | 综合代码质量门控 |
| post-edit-quality-check.js | PostToolUse | Edit|Write | 编辑后质量检查 |
| suggest-tests.js | PostToolUse | Edit|Write | 修改代码后建议补充测试 |
| commit-message-lint.js | PostToolUse | Bash | Git commit 消息规范检查 |
安全防护类
| Hook | 建议阶段 | 匹配器 | 说明 |
|---|---|---|---|
| block-dangerous-commands.js | PreToolUse | Bash | 阻止危险 Shell 命令 |
| constitution-guard.js | PreToolUse | * | 宪法合规守卫 |
| nda-probe-detector.js | PreToolUse | Bash|Read | NDA 探测行为检测 |
| nda-read-guard.js | PreToolUse | Read | NDA 文件读取防护 |
| nda-read-guard.standalone.js | PreToolUse | Read | NDA 独立版 (portable 部署用) |
| security-startup-guard.js | UserPromptSubmit | * | 安全启动守卫 |
| integrity-check.js | PostToolUse | Edit|Write | 文件完整性基线校验 |
分析诊断类
| Hook | 建议阶段 | 匹配器 | 说明 |
|---|---|---|---|
| drift-detector.js | PostToolUse | Edit|Write | 配置漂移检测 |
| edit-precheck-dispatcher.js | PreToolUse | Edit | 编辑前预检调度 |
| log-rotator.js | Stop | * | 日志文件轮转清理 |
| route-auditor.js | PostToolUse | Skill | 路由决策审计追踪 |
| route-interceptor-bundle.js | PreToolUse | Skill | 路由拦截器 (调试用) |
报告类
| Hook | 建议阶段 | 匹配器 | 说明 |
|---|---|---|---|
| constitution-session-report.js | Stop | * | 会话宪法合规报告 |
推荐组合
开发模式 (高质量): 激活 check-lint + check-typescript + suggest-tests 安全模式 (高防护): 激活 block-dangerous-commands + constitution-guard + integrity-check 调试模式 (全追踪): 激活 drift-detector + route-auditor + log-rotator