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:
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, только когда его объём ограничен и чтение нужно для решения.
|
||||
|
||||
После закрытия триажа находок у заметной работы — **проход на вычитание**:
|
||||
ревью умеет только прибавлять, и за круги правок набираются добавления.
|
||||
Проход ведёт модель со вкусом с правом только резать и явным списком
|
||||
неприкосновенного; сомнение «резать или нет» решается в пользу реза. Мелкой
|
||||
правке достаточно саморевью — причину пропуска назови одной фразой.
|
||||
|
||||
Доступную детерминированную финальную проверку запускай сам с выводом в файл.
|
||||
В контекст возьми точную команду, код возврата, итоговые счётчики, имена
|
||||
упавших тестов и путь к журналу. Зелёный журнал не читай. Красный журнал
|
||||
|
||||
Reference in new issue
Block a user