Hướng dẫn viết Hook cho Claude Code

Làm được gì

Biến những quy tắc mà Claude cứ vi phạm dù đã ghi trong CLAUDE.md thành một rào chắn cứng bằng cơ chế hook.

• Giải thích rõ từng loại hook, thời điểm kích hoạt và hợp đồng exit code (0 = cho phép, 2 = chặn)
• Bộ khung PreToolUse Bash guard và các pattern chạy được (references/hook_patterns.md)
• Kỹ thuật khớp theo token bằng shlex để tránh chặn oan các lệnh lành tính (tuyệt đối không tách bằng awk)
• Quy trình kiểm thử bash -n + JSON event thật trước khi đăng ký, kèm script test harness
• Mô hình SSOT + symlink để cài lại ~/.claude không làm mất guard
• Đồng bộ nhiều profile và cổng phê duyệt bắt buộc có con người (hộp thoại osascript, gõ YES vào /dev/tty)
• Phương pháp chứng minh vòng lặp Stop hook sẽ kết thúc (loop variant V)

Phù hợp với ai

• Lập trình viên muốn chặn Claude Code chạy lệnh nguy hiểm (force push, xoá file, commit secret)
• Trưởng nhóm đã nhắc quy tắc bằng prompt nhiều lần nhưng vẫn bị vi phạm lặp lại
• Người đã viết hook nhưng bị chặn oan hoặc session hỏng mà không rõ nguyên nhân
• Người vận hành cần triển khai guardrail đồng nhất trên nhiều profile/máy

Ví dụ sử dụng

1. "Tạo hook chặn git push --force" → sinh guard PreToolUse kiểm tra vị trí lệnh, đồng thời cho phép các trường hợp chỉ nhắc tên lệnh như grep hay trong nội dung commit.
2. "Hook mới của tôi chặn cả lệnh bình thường" → chẩn đoán lỗi tách chuỗi bằng awk và thay bằng walker dựa trên shlex.shlex(punctuation_chars=True).
3. "Ngăn Claude tưởng là đã commit" → thiết kế hook PostToolUse đọc lại git HEAD thật và tiêm sự thật đó vào ngữ cảnh.

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục daymade-claude-code/claude-code-hooks từ repo GitHub daymade/claude-code-skills vào ~/.claude/skills/claude-code-hooks/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.