Hooks

Что это #

Хук — это действие, которое WorkAI выполняет автоматически, когда в сессии происходит определённое событие: началась сессия, агент собирается вызвать инструмент, контекст сжимается. Вместо того чтобы каждый раз реагировать на такой момент вручную, вы один раз привязываете к нему действие — и дальше оно срабатывает само.

События #

Набор событий, на которые можно повесить хук, различается в зависимости от того, для какого таргета вы настраиваете конфигурацию. Ниже — полный список:

Событие	Когда срабатывает
SessionStart	Сессия чата началась
SessionEnd	Сессия чата завершилась
UserPromptSubmit	Вы отправили сообщение агенту
PreToolUse	Перед тем как агент вызовет инструмент
PostToolUse	После того как инструмент отработал
PreCompact	Перед сжатием контекста (см. Compaction)
SubagentStart	Запустился субагент
SubagentStop	Субагент завершил работу
Stop	Агент закончил ход и вернул ответ
ErrorOccurred	Во время работы агента произошла ошибка

Что можно делать #

Хук позволяет выполнить команду перед определённым действием агента или после него, а также получить уведомление о событии жизненного цикла сессии — не вмешиваясь в то, как модель формирует ответ.

Как настроить #

Команда /hooks в чате открывает диалог настройки: он спрашивает, на какое событие реагировать и какую команду выполнить, и сохраняет результат в конфигурационный файл. Тот же мастер доступен из настроек WorkAI — пункт Хуки в списке разделов (он не открывает свой экран, а сразу вызывает этот диалог).

Где хранится конфиг #

Путь	Область действия
.github/hooks	Проект
.claude/settings.local.json	Проект, локальный файл (не для git)
.claude/settings.json	Проект
~/.copilot/hooks	Все проекты текущего пользователя
~/.claude/settings.json	Все проекты текущего пользователя

Дальше #

• Как WorkAI сжимает контекст и на каком событии срабатывает PreCompact — /docs/agent/compaction
• Делегирование работы субагентам, чьи старт и завершение тоже видны хукам — /docs/subagents
• Где ещё в настройках лежат смежные разделы — /docs/configuration/settings