docs(skills): codex-subagent-playbook опёрт на базовый плейбук Claude

- Зачем:
  - скилл был заброшен, и Codex тихо подтягивал механики claude-subagent-playbook;
    рабочий промт конвейера #154 вручную докручивал недостающее.
- Что:
  - добавлен раздел «Базовый плейбук»: механики конвейера читаются из
    claude-subagent-playbook, при расхождении побеждает базовый.
  - добавлен раздел «Запуск Claude-субагентов»: permission-mode, свежая сессия
    и resume ревью-линий, --bg с наблюдением, выбор craftsman/deep-reasoner.
  - в приёмку добавлен проход на вычитание после триажа находок.
  - из описания скилла убрано устаревшее «(spawn_agent, TOML-роли)».
- Проверка:
  - вычитка diff; боевая проверка — прогон следующего тикета витрин
    промтом $codex-subagent-playbook.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
ddadminandClaude Fable 5 committed 2026-08-26 15:21:40 -04:00
1 parent f7e3f0e889
commit 07a17357f6
1 file changed
+41 -1
@@ -1,7 +1,7 @@
---
name: codex-subagent-playbook
disable-model-invocation: true
description: "Оптика тонкого мастера для координатора на стороне Codex (spawn_agent, TOML-роли). Со стороны Claude Code используй claude-subagent-playbook."
description: "Оптика тонкого мастера для координатора на стороне Codex: Codex-специфика поверх базовых механик claude-subagent-playbook, плюс запуск Claude-субагентов. Со стороны Claude Code используй claude-subagent-playbook."
---
# Тонкий мастер
@@ -10,6 +10,17 @@ description: "Оптика тонкого мастера для координа
цели, ограничений, решений, рисков и приёмки. Субагенты выясняют и выполняют;
координатор решает.
## Базовый плейбук
Механики конвейера живут в соседнем `claude-subagent-playbook`
(`../claude-subagent-playbook/SKILL.md`) — при развёртывании конвейера
прочитай его и бери оттуда: этапы от постановки до финала, «одно ревью на
версию артефакта», назначение ревью-линий по семействам и вкусу, триаж
находок у исполнителя, предохранитель кругов. Он написан для оркестратора на
стороне Claude Code: его харнесс-механику (Agent-тул, `codex exec`) заменяй
нативными средствами Codex и разделом «Запуск Claude-субагентов» ниже. Этот
файл правился реже базового — при расхождении побеждает базовый.
## Основная оптика
- Перед запуском агента назови его вклад: защита контекста, свежий взгляд,
@@ -55,6 +66,29 @@ description: "Оптика тонкого мастера для координа
[нативных шаблонов](references/prompt-templates.md) только после выбора
конкретного приёма.
## Запуск Claude-субагентов
Claude (Opus, Fable) запускается процессом CLI `claude` — на разработку,
тестирование и ревью-линии. Линию дефектов ведёт Claude как семейство,
отличное от автора-Codex; вкусовую линию — модель со вкусом
(Fable, effort medium: `claude --model claude-fable-5`).
- Запускай с `--permission-mode auto`: иначе Claude не может искать
информацию в интернете и запускать тесты.
- Первое ревью линии — свежая сессия; повторные ревью — продолжением той же
сессии: контекст первого ревью дешевле нового.
- Длительные задачи — через `--bg`, чтобы тайм-аут одного вызова клиента не
завершал работу. Состояние смотри `claude agents`, содержание —
`claude logs <id>`, примерно раз в 5–10 минут. Это частота наблюдения, а не
лимит времени: процесс жив и в журнале есть прогресс — оставь работать,
Claude может выполнять задачу значительно дольше. `--max-turns` — не ручка
ограничения времени.
- Тайм-аут отдельного запроса — не потеря сессии: продолжай через
`--resume <session-id>`, это быстрее и дешевле, чем начинать заново.
- Прямолинейные суждения бери агентом `craftsman`, сложные решения и
высокоответственные ревью — `deep-reasoner`; карта «роль → модель и
ступень» — в базовом плейбуке, `references/claude-agents.md`.
## Выбор приёма
- **Самодостаточная постановка** нужна исполнителю без истории разговора и
@@ -111,6 +145,12 @@ description: "Оптика тонкого мастера для координа
2. отдельные спорные фрагменты;
3. полный diff, только когда его объём ограничен и чтение нужно для решения.
После закрытия триажа находок у заметной работы — **проход на вычитание**:
ревью умеет только прибавлять, и за круги правок набираются добавления.
Проход ведёт модель со вкусом с правом только резать и явным списком
неприкосновенного; сомнение «резать или нет» решается в пользу реза. Мелкой
правке достаточно саморевью — причину пропуска назови одной фразой.
Доступную детерминированную финальную проверку запускай сам с выводом в файл.
В контекст возьми точную команду, код возврата, итоговые счётчики, имена
упавших тестов и путь к журналу. Зелёный журнал не читай. Красный журнал