docs(skill): claude-subagent-playbook — write-ревьюер Codex и уборка
- Зачем:
- read-only-конфайн обеднял ревью Codex (без тестов, поиска,
первоисточников), а плотность SKILL.md и дефолты модели/усилия
из config.toml накопили риски по итогам трёх прогонов.
- Что:
- ветка «ревьюер» в codex-exec.md переведена на запись + авто-аппрув,
защита — мандат промптом; в рецепты добавлены --strict-config и
явные -m / model_reasoning_effort.
- SKILL.md: правило «мандат промптом» для обоих ревьюеров, правило
моделей субагентов (Опус/Sonnet, не Fable), /tdd и /research +
Context7 в этапе 1, таймер-подстраховка ScheduleWakeup; уборка
плотности и инлайн-дат.
- handoffs 07-06/07-07/07-09 поглощены запиской 2026-07-10; в lessons.md
добавлены правило дистилляции и блок 2026-07-10; правки прошли слепое
ревью Опусом, все находки закрыты.
- Проверка:
- оверрайды -m/-c проверены живым codex exec --strict-config;
перекрёстные ссылки и команды сверены ревьюером с codex --help.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
4e496a1548
commit
89ebd1d327
8 files changed
+163
-215
No files matched your search
@@ -13,6 +13,12 @@
|
||||
- **Промпт — файлом, шум — в файлы.** Промпт пиши Write'ом в `$SCRATCH` и
|
||||
подавай через stdin (`-`); stdout/stderr — редиректами туда же. В контекст
|
||||
оркестратора читается ровно один файл — финальный отчёт из `-o`.
|
||||
- **Модель и глубину рассуждения задавай явно** (`-m`,
|
||||
`-c 'model_reasoning_effort="..."'`): дефолты берутся из
|
||||
`~/.codex/config.toml` и плавают за последней интерактивной сессией
|
||||
пользователя. Для реализации и ревью — high; текущую боевую модель сверь
|
||||
с конфигом (2026-07-10: `gpt-5.5`). Оверрайды проверены под
|
||||
`--strict-config`.
|
||||
- **Запуск — собственным фоновым Bash оркестратора** (`run_in_background`):
|
||||
фоновый процесс детачится, живёт сквозь ходы и будит оркестратора по
|
||||
выходу. Потолок 10 минут — только у фронтграундного Bash; фоновому таймаут
|
||||
@@ -21,8 +27,8 @@
|
||||
Забирай сразу после старта: это страховка — если процесс умер или его
|
||||
прибил хост, тред жив: `codex exec resume <id> «дай финальный отчёт»`.
|
||||
- **resume — только по явному id.** Безадресный resume цепляет последний тред
|
||||
сессии — при параллельных тредах подхватит чужой (например, read-only
|
||||
ревью-тред вместо write-треда реализации).
|
||||
сессии — при параллельных тредах подхватит чужой (например, ревью-тред
|
||||
вместо треда реализации).
|
||||
- **Вердикт без находок — проверь лог: работа или отписка.** Дёшево:
|
||||
`grep -c '"command_execution"' stdout.jsonl` (счётчик выполненных команд)
|
||||
или промежуточные сообщения —
|
||||
@@ -40,27 +46,42 @@
|
||||
## Ветка «исполнитель» (пишет код)
|
||||
|
||||
```bash
|
||||
cat "$SCRATCH/task-prompt.md" | codex exec --json \
|
||||
-s workspace-write \
|
||||
cat "$SCRATCH/task-prompt.md" | codex exec --json --strict-config \
|
||||
-s workspace-write -m gpt-5.5 \
|
||||
-c 'model_reasoning_effort="high"' \
|
||||
-c 'approval_policy="on-request"' -c 'approvals_reviewer="auto_review"' \
|
||||
-o "$SCRATCH/task-result.md" - \
|
||||
> "$SCRATCH/task-stdout.jsonl" 2> "$SCRATCH/task-stderr.txt"
|
||||
```
|
||||
|
||||
- Право записи + авто-ревьюер аппрувов (`approvals_reviewer` в `--help` не
|
||||
документирован, но `--strict-config` его принимает — проверено 2026-07-09;
|
||||
связка отработала боевой прогон). Скоуп ограничивай промптом («коммит не
|
||||
делай», границы из файла задачи), не песочницей — жёсткий read-only лишает
|
||||
исполнителя тестов и поиска.
|
||||
- `--strict-config` — обязателен: опечатка в `-c`-ключе упадёт громко, а не
|
||||
проглотится молча (важно для `approvals_reviewer` — в `--help` он не
|
||||
документирован, но strict-config его принимает; связка с
|
||||
`approval_policy="on-request"` отработала боевой прогон 2026-07-09).
|
||||
- Право записи + авто-ревьюер аппрувов. Скоуп ограничивай промптом («коммит
|
||||
не делай», границы из файла задачи), не песочницей — жёсткий read-only
|
||||
лишает исполнителя тестов и поиска.
|
||||
- Промпт: путь к файлу задачи; мандат — в этапе 3 SKILL.md.
|
||||
- До старта сними baseline `git status --porcelain`; после — сверь отчёт
|
||||
Кодекса с деревом: правок, которых он не называл, быть не должно.
|
||||
|
||||
## Ветка «ревьюер» (свежий тред, только чтение)
|
||||
## Ветка «ревьюер» (свежий тред, мандат промптом)
|
||||
|
||||
Тот же вызов, но `-s read-only` и без approvals-флагов. Свежий тред, не тот,
|
||||
что писал код. В промпте — формат «только индекс находок» (SEVERITY,
|
||||
файл:строка, суть, как проверить) и явная строка VERDICT.
|
||||
Тот же вызов, что у исполнителя — запись + авто-аппрув, — но **свежим
|
||||
тредом**, не тем, что писал код. Read-only-песочницей ревьюера не режь: она
|
||||
отнимает у него руки — тесты, проверку гипотез, поиск, документацию,
|
||||
первоисточники. Защита — мандат в промпте: «исходники и окружение не менять,
|
||||
правок не вносить — только находки»; Codex держит его надёжно (практика
|
||||
пользователя, 2026-07-10). Дешёвая подстраховка: `git status --porcelain`
|
||||
до ревью и сверка после — дерево должно остаться нетронутым. Кавеат: сеть
|
||||
под workspace-write по умолчанию закрыта; что поиск/документация проходят
|
||||
эскалацией через авто-аппрув — рабочая гипотеза, боем не обкатана
|
||||
(см. handoff 2026-07-10).
|
||||
|
||||
В промпте — формат «только индекс находок» (SEVERITY, файл:строка, суть,
|
||||
как проверить), явная строка VERDICT и поощрение безопасных эмпирических
|
||||
проверок вне репо (воспроизвести краевой случай, свериться с
|
||||
первоисточником) — вердикт заметно твёрже (эмпирика 2026-07-09).
|
||||
|
||||
## Ветка «триаж/починка» (тем же тредом, что писал код)
|
||||
|
||||
@@ -80,7 +101,8 @@ cat "$SCRATCH/fix-prompt.md" | codex exec resume --json <thread-id> \
|
||||
|
||||
Для запуска раннер не нужен (см. сквозные правила) — он нужен, когда сырой
|
||||
результат шумный и его стоит провалидировать или сжать до индекса, прежде
|
||||
чем показывать оркестратору. Тогда general-purpose-субагенту отдай
|
||||
чем показывать оркестратору. Тогда раннеру (`fast-worker`; нет в
|
||||
репозитории — `general-purpose`) отдай
|
||||
**готовую команду** и правила разбора — не постановку задачи: тонкий агент,
|
||||
получив постановку, реализует её сам (казус форвардера, lessons 2026-07-06).
|
||||
Свой 10-минутный потолок на синхронный Bash раннер обходит отслеживаемым
|
||||
|
||||
Reference in new issue
Block a user