diff --git a/agents/.agents/skills/codex-subagent-playbook/SKILL.md b/agents/.agents/skills/codex-subagent-playbook/SKILL.md index 26df1e1..ab93665 100644 --- a/agents/.agents/skills/codex-subagent-playbook/SKILL.md +++ b/agents/.agents/skills/codex-subagent-playbook/SKILL.md @@ -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 `, примерно раз в 5–10 минут. Это частота наблюдения, а не + лимит времени: процесс жив и в журнале есть прогресс — оставь работать, + Claude может выполнять задачу значительно дольше. `--max-turns` — не ручка + ограничения времени. +- Тайм-аут отдельного запроса — не потеря сессии: продолжай через + `--resume `, это быстрее и дешевле, чем начинать заново. +- Прямолинейные суждения бери агентом `craftsman`, сложные решения и + высокоответственные ревью — `deep-reasoner`; карта «роль → модель и + ступень» — в базовом плейбуке, `references/claude-agents.md`. + ## Выбор приёма - **Самодостаточная постановка** нужна исполнителю без истории разговора и @@ -111,6 +145,12 @@ description: "Оптика тонкого мастера для координа 2. отдельные спорные фрагменты; 3. полный diff, только когда его объём ограничен и чтение нужно для решения. +После закрытия триажа находок у заметной работы — **проход на вычитание**: +ревью умеет только прибавлять, и за круги правок набираются добавления. +Проход ведёт модель со вкусом с правом только резать и явным списком +неприкосновенного; сомнение «резать или нет» решается в пользу реза. Мелкой +правке достаточно саморевью — причину пропуска назови одной фразой. + Доступную детерминированную финальную проверку запускай сам с выводом в файл. В контекст возьми точную команду, код возврата, итоговые счётчики, имена упавших тестов и путь к журналу. Зелёный журнал не читай. Красный журнал