Hooks
Система хуків AI-агента: автоматичні скрипти на різних етапах роботи для безпеки та автоматизації
hooksхукиавтоматизаціябезпекаpre-commitpost-tool
📎ОФІЦІЙНА ДОКУМЕНТАЦІЯ
Hooks
Hooks -- користувацькі скрипти, що автоматично спрацьовують на заздалегідь заданих етапах роботи AI-агента.
⚠️Увага
Промпти -- це лише побажання, які LLM може проігнорувати. Хуки забезпечують суворий, детермінований контроль.
Навіщо потрібні
| Мета | Приклади |
|---|---|
| Безпека | Перехоплення небезпечних дій |
| Автоматизація | Форматування, лінтери, тести |
| Зручність | Сповіщення, автокоміти |
Види подій
| Подія | Коли спрацьовує |
|---|---|
PreToolUse | Перед виконанням інструменту |
PostToolUse | Після виконання інструменту |
PostToolUseFailure | Після невдалого виконання |
PermissionRequest | При запиті дозволу |
SessionStart | На початку сесії |
SessionEnd | При завершенні сесії |
Notification | При сповіщенні |
SubagentStart / SubagentStop | Життєвий цикл субагента |
PreCompact | Перед стисненням контексту |
ConfigChange | При зміні конфігурації |
UserPromptSubmit | При відправці промпту |
Stop | При зупинці агента |
TaskCompleted | При завершенні задачі |
Best Practices
- Налаштуйте базові сповіщення та автоформатування
- Налаштуйте перехоплення деструктивних команд
- Автоматичний git commit після завершення задачі
- Пишіть максимально швидкі скрипти -- хуки не повинні уповільнювати роботу