Это хук реагирует на действия внутри Coroid. Вы выбираете событие, пишете инструкции на простом языке, и хук запускается при возникновении этого события.
Найти их можно в разделе Настройки → Автоматизация → Автоматизации.
События, на которые можно реагировать
| Категория | Примеры |
|---|---|
| Задача | Создана, статус изменён, этап изменён, завершена, завершилась ошибкой |
| Агент | Запущен, итерация, вызов инструмента, завершён, ошибка |
| Репозиторий | Коммит отправлен, ветка создана, pull request открыт, pull request объединён |
| Анализ | Обнаружена зависимость, проблема безопасности, анализ завершён |
| Синхронизация | Внешний источник обновлён |
| Развертывание | Запущено, завершено, завершилось ошибкой |
По умолчанию доступ только для чтения
Хуки анализируют и предоставляют отчёты. Они могут создавать последующие задачи, но напрямую не изменяют ваш код.
Именно это свойство делает их безопасными для использования. Автоматизация, редактирующая код в ответ на событие, действует в момент, когда за ней вряд ли кто-то следит. Хук, который создаёт задачу даёт тот же результат через стандартный процесс — спецификацию, план, проверку, рассмотрение, pull request.
Составление качественных инструкций
Инструкции хука обрабатываются моделью, поэтому они выглядят как указания коллеге, а не как код. Требования к качеству такие же, как к спецификации: укажите, на что обратить внимание, что важно и что делать.
Чётко определите случай «ничего не делать». Без этого хук будет находить повод для действий при каждом запуске, а хуки, которые срабатывают постоянно, перестают привлекать внимание.
Ограничения
Существует три механизма защиты, потому что автоматизация, основанная на событиях, имеет предсказуемые недостатки:
Ограничения частоты. Настраиваются для каждого хука отдельно: за минуту, час и день. Хук на событие с высокой частотой может сработать сотни раз во время активного процесса объединения изменений.
Глубина цепочки. Хуки могут вызывать события, которые, в свою очередь, запускают другие хуки. Максимальная глубина цепочки предотвращает образование циклов.
Разрешения на использование инструментов. Возможности хука контролируются: доступ только для чтения, вызовы MCP и создание задач регулируются отдельно.
Разрешения
Управление хуками доступно только администраторам; все участники могут видеть хуки и историю их выполнения. Поскольку хук работает на уровне всей организации, такая асимметрия является осознанной.
Отслеживание
Каждый хук сохраняет журнал доставки и аналитику. Проверьте журнал после включения нового хука — неудача заключается не в ошибке, а в постоянном срабатывании без каких-либо полезных действий.
Хуки, расписания и Sentinel
| Механизм | Триггер |
|---|---|
| Хук | Событие платформы |
| Расписание | Время |
| Sentinel | Наблюдаемое условие |