Menu
Конвейер обработки эпика: подготовка → реализация задач через сабагентов → ревью → мерж
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | epic-via-subagents |
| description | Конвейер обработки эпика: подготовка → реализация задач через сабагентов → ревью → мерж |
| depends_on | ["run-subagent"] |
todo до done через команду AI-сабагентов.master
└── <epic-branch> ← создаётся от master
├── <task-subbranch-1> ← от ветки эпика, draft PR → сабагент коммитит → мерж по готовности
├── <task-subbranch-2> ← от ветки эпика, draft PR → сабагент коммитит → мерж по готовности
└── <task-subbranch-N> ← ...
Финальный PR: <epic-branch> → master.
⚠️ Критически важно: подветки задач создаются от ветки эпика, а не от master. Ветка эпика содержит весь код, который ещё не влит в master.
todo/EPIC-*.todo.md).[ ].<type>/<epic-id-kebab-case>.master.branch файла эпика. Закоммить и запушь.todo/AGENTS.md).depends_on — все ли зависимости выполнены.assignee, branch, status: in_progress.## Change History:## Инструкции для сабагента
**Ветка:** <task-subbranch> (уже создана и активна)
**PR:** уже создан (draft) из <task-subbranch> в <epic-branch> — [PR #<PR_NUMBER>](<PR_LINK>)
### Порядок действий
1. Переключись в ветку `<task-subbranch>`: `git checkout <task-subbranch>`
2. Реализуй задачу согласно описанию.
3. Следуй [Конвенциям](../../../../docs/conventions/index.md) проекта.
4. Делай промежуточные коммиты после каждого логического этапа.
5. После реализации запусти проверки: `make check`.
6. Сделай `git push`.
7. Переведи PR из draft в ready: `gh pr ready <PR_NUMBER>`.
git push.[<PR_NUMBER>](<PR_LINK>). Закоммить и сделай git push.Запусти сабагента-исполнителя.
<role-title>— заголовок роли из поляtitleфайла роли (например,Бэкендер Левша). Файл роли передаётся через-r, путь в промпте не нужен.
Пример промпта на реализацию:
<role-title>, выполни задачу: todo/<TASK-ID>.todo.md.
Следуй инструкциям из секции 'Инструкции для сабагента' в файле задачи.
Для доработки по замечаниям ревьювера:
<role-title>, доработай задачу: todo/<TASK-ID>.todo.md по замечаниям ревьювера:
<суть замечаний>
[PR #<PR_NUMBER>](<PR_LINK>) уже существует, после правок закоммить и сделай `git push`.
Успех → self-review (Шаг 5). Ошибка → перезапусти с уточнением или эскалируй.
Если агент завершён по таймауту:
git status — есть ли незакоммиченные изменения?git diff --stat, make check 2>&1 | tail -20.git add -A && git commit -m "WIP: <TASK-ID>" && git push.Попроси ту же роль проверить своё решение. Запусти сабагента.
⚠️ Self-review обязателен для любого типа задач — код, документация, конфигурация, исследование. Исполнитель проверяет полноту и качество своей работы на соответствие критериям приёмки задачи.
Пример промпта:
<role-title>, выполни ревью своих изменений в PR [PR #<PR_NUMBER>](<PR_LINK>).
Проверь соответствие задаче: todo/<TASK-ID>.todo.md.
Если замечаний нет → запускай внешнее ревью (Шаг 6). Если есть замечания → вернись к Шаг 3 для доработки.
⚠️ Ревью обязательно для любого типа задач — код, документация, конфигурация, исследование. Выбор ревьювера зависит от сути изменений, а не от наличия кода.
<reviewer-role-title>, выполни ревью [PR #<PR_NUMBER>](<PR_LINK>) из <task-subbranch> в <epic-branch>.
Проверь соответствие задаче: todo/<TASK-ID>.todo.md.
🛑 Pre-merge checkpoint — проверь перед мержем:
status: done, pr: <ссылка>).[x].todo/done/.git push.Когда все задачи эпика выполнены:
Must Have требования в эпике закрыты.make check.master.status: done, pr: <ссылка на финальный PR>.Эпик: <EPIC-ID> — <название>
Финальный PR: [PR #<N>](<URL>)
Критические моменты:
- <таймаут сабагента на задаче X, потребовалось 2 перезапуска>
- <ревьювер выявил проблему с архитектурой, потребовалась доработка>
- <задача Y заблокирована зависимостью, выполнена после TASK-Z>
| Лимит | Значение |
|---|---|
| Итерации реализация → ревью → доработка | 3 |
| Перезапуски сабагента при ошибке/таймауте | 2 |
| Исчерпание лимитов | Эскалация пользователю |
watch-subagent.sh принимает три таймаута: -s (soft), -m (hard), -t (stall).
-s) и Hard-timeout (-m)| Сложность задачи | -s (soft) | -m (hard) |
|---|---|---|
| C1–C2 | 600 сек | auto (1200) |
| C3 | 1200 сек | auto (2400) |
| C4 | 2400 сек | 4800 сек |
| C5+ | 3600 сек | 7200 сек |
-m можно не указывать для C1–C3: скрипт автоматически вычислит max(soft*2, 1200).
Для C4+ указывай -m явно, чтобы избежать слишком раннего хард-килла.
-t)Stall-timeout — время без единого JSONL-события, после которого агент считается зависшим. Срабатывает только если процесс реально простаивает (idle): если он активен (грузит CPU/IO — ретраит, ожидание ответа), stall не убивает, а ждёт до hard-timeout (см. WATCH_STALL_RESPECT_LIVENESS в SKILL run-subagent).
По умолчанию 120 сек. Этого достаточно для реализации (C1–C3), но недостаточно для ревью:
ревьювер читает много файлов, модель «думает» дольше между tool call'ами.
| Тип задачи | -t (stall) |
|---|---|
| Реализация | 120 сек |
| Self-review | 180 сек |
| Ревью | 300 сек |
Пример запуска ревью:
scripts/watch-subagent.sh -s 600 -t 300 -o text,files -r docs/agents/roles/team/code_reviewer_backend_puaro.ru.md <<'PROMPT'
<prompt>
PROMPT
| Ситуация | Действие |
|---|---|
| Сабагент не завершил задачу | Повтор с уточнением, при неудаче — эскалация |
Проверки падают (make check) | Доработка с указанием ошибок |
| 3 итерации с замечаниями | Эскалация пользователю |
| Конфликт слияния | Решить конфликт, перезапустить сабагента |
| Задача заблокирована | Следующая задача, вернуться после разблокировки |
| Сабагент не закоммитил | Оркестратор делает коммит сам |
| Файл задачи не виден на подветке | Проверить, что задача закоммичена в эпик-ветку до создания подветки |
done, файлы в todo/done/.master создан.Войти в роль и объявить её skills в контексте. Применяй, когда промпт подразумевает работу от лица роли: по имени роли («Тимлид», «Аналитик Шерлок», «Ревьювер Бэка Пуаро» и т.п.), по виду задачи («создай задачу», «декомпозируй эпик», «сделай ревью», «проверь тексты») или прямо «возьми на себя роль …». Если роль не названа явно — определи подходящую по описаниям ролей в корневом AGENTS.md или по RACI-матрицам.
Запуск оркестрации AI-агентов по цепочке: static/dynamic chains, quality gates, отчёты, resume
Запуск сабагента через pi/codex для автономного выполнения задачи в изолированном контексте с контролем и фильтрацией вывода
Конвейер обработки эпика через сабагентов
Запуск сабагента через pi/codex для автономного выполнения задачи
Минимальный stub skill become-role для теста InitCommand.