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:
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` — формат коммита на финале.
|
||||
|
||||
## Подробнее
|
||||
|
||||
Reference in new issue
Block a user