Hook Development

功能

• Guidance on prompt-based and command hooks
• Explanation of hook types, events, and configuration
• Security best practices for hook development
• Debugging utilities and testing strategies
• Examples for common hook patterns and scenarios

使用场景

• Implementing validation for tool use (PreToolUse, PostToolUse)
• Setting up event-driven automation for the development lifecycle
• Blocking dangerous commands or sensitive file operations
• Loading project context and environment variables at session start

非目标

• Providing specific hook scripts to copy-paste without understanding
• Handling the core logic of external tools or services
• Replacing the need for fundamental bash or prompt engineering knowledge

工作流

1. Identify events to hook into
2. Choose between prompt-based or command hooks
3. Write hook configuration in `hooks/hooks.json`
4. Create hook scripts (for command hooks)
5. Use portable paths (`${CLAUDE_PLUGIN_ROOT}`)
6. Validate configuration and scripts
7. Test hooks thoroughly
8. Implement hooks in Claude Code and test with `--debug`

实践

• Security validation
• Test enforcement
• Context loading
• Code quality checks

先决条件

• Claude Code environment
• Basic understanding of bash scripting (for command hooks)
• Basic understanding of prompt engineering (for prompt hooks)