# hooks-guide

Субагент hooks-guide помогает спроектировать хук Claude Code через вопросы о событии, условии запуска и действии. Он пригодится, если нужно автоматизировать шаги рабочего процесса.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 907 у репозитория
- Автор: alirezarezvani
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/alirezarezvani/claude-code-skill-factory/tree/HEAD/.claude/agents/hooks-guide.md
- Обновлён: 2025-11-12
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/hooks-guide

## Что делает

hooks-guide задаёт вопросы о назначении хука, событии запуска, инструментах и команде, которую нужно выполнить. Для некоторых событий он уточняет файлы или инструменты-триггеры, а для `SubagentStop` — должен ли хук запускаться для всех субагентов или только для выбранного. Процесс рассчитан на 5–7 вопросов.

Затем субагент использует скилл `hook-factory`, проверяет результат и создаёт `hook.json` и `README.md`, а также помогает с установкой. Можно описать поведение при ошибках: завершаться молча, показать предупреждение или блокировать рабочий процесс. Для `PostToolUse` важна скорость выполнения: в инструкции указан предел <5s; для `SubagentStop` — <120s.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/hooks-guide.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/hooks-guide.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/hooks-guide.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/alirezarezvani/claude-code-skill-factory/tree/HEAD/.claude/agents/hooks-guide.md

## Когда брать
- выбрать событие, на котором должен запускаться хук
- задать файлы или инструменты-триггеры для хука
- описать команду для форматирования, тестов или уведомления
- определить, как хук реагирует на сбой команды

## Примеры запросов агенту
- Создай хук, который запускает `pytest` после завершения субагента.
- Настрой хук для форматирования Python после редактирования файлов.
- Сделай хук, который добавляет изменённые файлы в Git и молча завершает работу при ошибке.

## Похожие
- [promptfax](https://affpapa.org/nevibecode/mcp/promptfax.md) — MCP-сервер · 3913 установок
- [workflow-orchestrator](https://affpapa.org/nevibecode/commands/workflow-orchestrator.md) — команда · 2341 установка
- [toolroute - Intelligent Automated LLM Routing](https://affpapa.org/nevibecode/mcp/toolroute-intelligent-automated-llm-routing.md) — MCP-сервер · 2098 установок
- [SpaceMolt](https://affpapa.org/nevibecode/mcp/spacemolt.md) — MCP-сервер · 1578 установок
- [hacecuentas](https://affpapa.org/nevibecode/mcp/hacecuentas.md) — MCP-сервер · 1228 установок
- [agentcron](https://affpapa.org/nevibecode/mcp/agentcron.md) — MCP-сервер · 545 установок

Из того же набора: [alirezarezvani/claude-code-skill-factory](https://affpapa.org/nevibecode/by/alirezarezvani/claude-code-skill-factory.md) — 36 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
