docs(skill): claude-subagent-playbook — write-ревьюер Codex и уборка

- Зачем:
  - read-only-конфайн обеднял ревью Codex (без тестов, поиска,
    первоисточников), а плотность SKILL.md и дефолты модели/усилия
    из config.toml накопили риски по итогам трёх прогонов.
- Что:
  - ветка «ревьюер» в codex-exec.md переведена на запись + авто-аппрув,
    защита — мандат промптом; в рецепты добавлены --strict-config и
    явные -m / model_reasoning_effort.
  - SKILL.md: правило «мандат промптом» для обоих ревьюеров, правило
    моделей субагентов (Опус/Sonnet, не Fable), /tdd и /research +
    Context7 в этапе 1, таймер-подстраховка ScheduleWakeup; уборка
    плотности и инлайн-дат.
  - handoffs 07-06/07-07/07-09 поглощены запиской 2026-07-10; в lessons.md
    добавлены правило дистилляции и блок 2026-07-10; правки прошли слепое
    ревью Опусом, все находки закрыты.
- Проверка:
  - оверрайды -m/-c проверены живым codex exec --strict-config;
    перекрёстные ссылки и команды сверены ревьюером с codex --help.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Dmitriy DementievandClaude Fable 5 committed 2026-07-10 12:41:09 +03:00
1 parent 4e496a1548
commit 89ebd1d327
8 files changed
+163 -215

No files matched your search

@@ -20,9 +20,9 @@ description: >-
**Не разворачивай конвейер на мелочь.** Косметика, пара часов работы, один
файл — сделай сам: накладные расходы процесса многократно превысят цену
работы (эмпирика 2026-07-06: на полировку ноутбука чуть не завели несколько
issue; пользователь справедливо остановил). Очередь зависимых issue с
автономным прогоном — это `/coordinator-loop`, не этот плейбук.
работы (эмпирика: на полировку ноутбука чуть не завели несколько issue —
пользователь остановил). Очередь зависимых issue с автономным прогоном —
это `/coordinator-loop`, не этот плейбук.
## Роли
@@ -35,13 +35,13 @@ issue; пользователь справедливо остановил). Оч
декомпозиция и постановка остаются у тебя. Механика вызова —
[references/codex-exec.md](references/codex-exec.md).
- **Ревьюеры** — два, **разных родословных**, слепые друг к другу:
Claude-субагент (adversarial-reviewer, **на Опусе** — экономия лимитов) и
Codex **свежим тредом** (не тем, что писал код). Разные родословные ловят
непересекающиеся классы находок — это центральная находка и
`/coordinator-loop` (кросс-линия), и прогона 2026-07-06 (Клод подтвердил
математику и краевые случаи, Кодекс нашёл дыры в тестах). Нет типа
`adversarial-reviewer` в среде — возьми `general-purpose` со скептическим
промптом и запретом менять репозиторий (мандат промптом, не урезанием).
Claude-субагент (`adversarial-reviewer`; нет в среде — скептический
`general-purpose`) и Codex **свежим тредом**, не тем, что писал код.
Разные родословные ловят непересекающиеся классы находок (пересечение в
прогонах — стабильно ~ноль). Обоим — руки: тесты, гипотезы, поиск,
документация, первоисточники; запрет менять исходники и окружение —
**мандатом в промпте, не урезанием песочницы** (рецепт и подстраховка —
[references/codex-exec.md](references/codex-exec.md)).
- **Свежесть**: ревьюеров запускай свежими сессиями, без форка своей истории
(форк тратит токены и убивает независимость). Повторную проверку точечных
правок — **тем же** ревьюером узким вопросом «закрывают ли правки твои
@@ -50,6 +50,10 @@ issue; пользователь справедливо остановил). Оч
рассуждение — `deep-reasoner`, механика с шумным выводом — `fast-worker`.
Они репо-локальные; нет в репозитории — определения для создания в
[references/claude-agents.md](references/claude-agents.md).
- **Модель Claude-субагентов задавай явно**: Опус — рассуждения и ревью,
Sonnet — механика. Без явной модели субагент наследует Fable, чьи лимиты
самые дорогие — держи их для оркестрации (у `deep-reasoner`/`fast-worker`
модели пришиты в определениях).
## Конвейер
@@ -57,8 +61,12 @@ issue; пользователь справедливо остановил). Оч
контекста; всё нужное — в файле: цель, критерии приёмки чекбоксами,
границы («что трогать нельзя»), «сначала прочитать» (спека, ADR, README с
командами), команды проверки. Формат и место — по конвенции репозитория
(например, `.scratch/<feature>/issues/`). Готово, когда исполнитель может
сделать задачу, не задав тебе ни одного вопроса.
(например, `.scratch/<feature>/issues/`). Не хватает фактуры по внешним
библиотекам/API — сначала `/research` и Context7 MCP, выжимку — в
«сначала прочитать». Задача просится под test-first — сошлись в ней на
`/tdd` (скиллы у Codex те же — общий каталог), ключевые требования
продублируй текстом. Готово, когда исполнитель может сделать задачу,
не задав тебе ни одного вопроса.
2. **Свежий взгляд на постановку — до реализации.** Адверсарный ревьюер без
твоего контекста проверяет задачу против кода: фактические ошибки, скрытые
решения-«однострочники», недостающие критерии. Окупается: ловит блокеры,
@@ -77,9 +85,13 @@ issue; пользователь справедливо остановил). Оч
4. **Два слепых ревью параллельно.** Каждому: путь к задаче-файлу + фокус
(математика/краевые случаи, соответствие критериям, честность тестов,
артефакты). Друг про друга не знают, твои выводы им не пересказывай.
Клод-ревьюеру можно поручить смотреть артефакты (картинки из ноутбука).
Этап закрыт, когда оба вердикта у тебя индексами; вердикт без единой
находки засчитывай только после проверки его лога — работа, не отписка
Обоим поощряй безопасные эмпирические проверки (воспроизвести краевой
случай вне репо, сходить в документацию) — вердикт заметно твёрже;
менять исходники и окружение нельзя, после ревью сверь дерево
(`git status`). Клод-ревьюеру можно поручить смотреть артефакты
(картинки из ноутбука). Этап закрыт, когда оба вердикта у тебя индексами
и дерево нетронуто; вердикт без единой находки засчитывай только после
проверки его лога — работа, не отписка
(приём — в [references/codex-exec.md](references/codex-exec.md)).
5. **Синтез и триаж.** Сведи вердикты по индексам: пересечения, противоречия.
Пофиндинговый триаж — у **исполнителя**, не у тебя (правило
@@ -103,14 +115,22 @@ issue; пользователь справедливо остановил). Оч
вердикты сведены), решения по скоупу оставляй ему. Фоновые этапы будят тебя
сами — не поллинг вручную, а отслеживаемые фоновые процессы + уведомления
(механика — [references/codex-exec.md](references/codex-exec.md)).
Подстраховка от молчаливой смерти агента — ScheduleWakeup сроком дольше
ожидаемой длительности: по пробуждению смотри логи сам, по приходу
результата таймер снимай.
## Соседние скиллы
- `/coordinator-loop` — автономный цикл очереди issue на стороне Codex
(координатор в Codex, worker'ы — его субагенты). Выстрадан и отлажен;
словарь (индекс, свежие сессии, две ручки стоимости) — общий.
- `/claude-team-review` — ревью-петля, где лид сам чинит код.
- `/claude-team-review` — ревью-петля, где лид сам чинит код (живёт
отдельным репозиторием, в среде может быть не подключён).
- `/adversarial-review` — разовое адверсарное ревью Кодексом.
- `/tdd` — дисциплина test-first: для задач-мелочей, которые делаешь сам,
и как словарь для test-first-постановки (этап 1).
- `/research` — фоновое исследование первоисточников с выжимкой-файлом;
кормит «сначала прочитать» постановки (этап 1).
- `/conventional-commits` — формат коммита на финале.
## Подробнее