From 07a17357f6413fcf935cd29cf4c0a147e91f04b4 Mon Sep 17 00:00:00 2001 From: Dmitry Dementev Date: Wed, 26 Aug 2026 15:21:40 -0400 Subject: [PATCH] =?UTF-8?q?docs(skills):=20codex-subagent-playbook=20?= =?UTF-8?q?=D0=BE=D0=BF=D1=91=D1=80=D1=82=20=D0=BD=D0=B0=20=D0=B1=D0=B0?= =?UTF-8?q?=D0=B7=D0=BE=D0=B2=D1=8B=D0=B9=20=D0=BF=D0=BB=D0=B5=D0=B9=D0=B1?= =?UTF-8?q?=D1=83=D0=BA=20Claude?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - скилл был заброшен, и 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 --- .../skills/codex-subagent-playbook/SKILL.md | 42 ++++++++++++++++++- 1 file changed, 41 insertions(+), 1 deletion(-) 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, только когда его объём ограничен и чтение нужно для решения. +После закрытия триажа находок у заметной работы — **проход на вычитание**: +ревью умеет только прибавлять, и за круги правок набираются добавления. +Проход ведёт модель со вкусом с правом только резать и явным списком +неприкосновенного; сомнение «резать или нет» решается в пользу реза. Мелкой +правке достаточно саморевью — причину пропуска назови одной фразой. + Доступную детерминированную финальную проверку запускай сам с выводом в файл. В контекст возьми точную команду, код возврата, итоговые счётчики, имена упавших тестов и путь к журналу. Зелёный журнал не читай. Красный журнал