67 lines
2.6 KiB
Markdown
67 lines
2.6 KiB
Markdown
|
# 备用钩子池 (Standby Hooks)
|
||
|
|
|
||
|
|
19 个 Hook 脚本存在于 `hooks/` 目录但未在 `settings.json` 中注册。
|
||
|
|
设计为按需激活，不默认注册以避免每次工具调用额外延迟。
|
||
|
|
|
||
|
|
## 激活方式
|
||
|
|
|
||
|
|
在 `settings.json` 的 `hooks` 对应阶段添加条目即可激活:
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"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
|