mirror of
https://github.com/sweetwisdom/everything-claude-code-zh.git
synced 2026-03-21 22:10:09 +00:00
47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
# 钩子系统（Hooks System）
|
||
|
||
## 钩子类型（Hook Types）
|
||
|
||
- **工具调用前（PreToolUse）**：在工具执行之前（验证、参数修改）
|
||
- **工具调用后（PostToolUse）**：在工具执行之后（自动格式化、检查）
|
||
- **会话终止（Stop）**：当会话结束时（最终验证）
|
||
|
||
## 当前已配置的钩子（Current Hooks）（位于 ~/.claude/settings.json 中）
|
||
|
||
### 工具调用前（PreToolUse）
|
||
- **tmux 提醒**：针对耗时较长的命令（npm, pnpm, yarn, cargo 等）建议使用 tmux
|
||
- **git push 审查**：在推送（push）之前打开 Zed 进行代码审查
|
||
- **文档拦截器（doc blocker）**：拦截不必要的 .md/.txt 文件创建
|
||
|
||
### 工具调用后（PostToolUse）
|
||
- **PR 创建**：记录 PR URL 和 GitHub Actions 状态
|
||
- **Prettier**：编辑后自动格式化 JS/TS 文件
|
||
- **TypeScript 检查**：编辑 .ts/.tsx 文件后运行 tsc
|
||
- **console.log 警告**：对已编辑文件中的 console.log 发出警告
|
||
|
||
### 会话终止（Stop）
|
||
- **console.log 审计**：在会话结束前检查所有已修改的文件中是否存在 console.log
|
||
|
||
## 自动授权许可（Auto-Accept Permissions）
|
||
|
||
请谨慎使用：
|
||
- 仅对受信任且定义明确的任务方案启用
|
||
- 在探索性工作中禁用
|
||
- 严禁使用 `dangerously-skip-permissions` 标志
|
||
- 改为在 `~/.claude.json` 中配置 `allowedTools`
|
||
|
||
## TodoWrite 最佳实践
|
||
|
||
使用 TodoWrite 工具（Tool）以：
|
||
- 跟踪多步骤任务的进度
|
||
- 验证对指令的理解程度
|
||
- 实现实时引导（steering）
|
||
- 展示细粒度的实现步骤
|
||
|
||
待办事项列表（Todo list）能够揭示：
|
||
- 步骤顺序错乱
|
||
- 遗漏项
|
||
- 多余的不必要项
|
||
- 粒度错误
|
||
- 需求误读
|