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
|
name: codex-subagent-playbook
|
||||||
disable-model-invocation: true
|
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) только после выбора
|
[нативных шаблонов](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. отдельные спорные фрагменты;
|
2. отдельные спорные фрагменты;
|
||||||
3. полный diff, только когда его объём ограничен и чтение нужно для решения.
|
3. полный diff, только когда его объём ограничен и чтение нужно для решения.
|
||||||
|
|
||||||
|
После закрытия триажа находок у заметной работы — **проход на вычитание**:
|
||||||
|
ревью умеет только прибавлять, и за круги правок набираются добавления.
|
||||||
|
Проход ведёт модель со вкусом с правом только резать и явным списком
|
||||||
|
неприкосновенного; сомнение «резать или нет» решается в пользу реза. Мелкой
|
||||||
|
правке достаточно саморевью — причину пропуска назови одной фразой.
|
||||||
|
|
||||||
Доступную детерминированную финальную проверку запускай сам с выводом в файл.
|
Доступную детерминированную финальную проверку запускай сам с выводом в файл.
|
||||||
В контекст возьми точную команду, код возврата, итоговые счётчики, имена
|
В контекст возьми точную команду, код возврата, итоговые счётчики, имена
|
||||||
упавших тестов и путь к журналу. Зелёный журнал не читай. Красный журнал
|
упавших тестов и путь к журналу. Зелёный журнал не читай. Красный журнал
|
||||||
|
|||||||
Reference in new issue
Block a user