feat(skill): claude-subagent-playbook — конвейер одной задачи с Codex

- Зачем:
  - выжимка боевого прогона 2026-07-06 (t2-ml-forecast, витрина) в
    переиспользуемый плейбук: постановка → свежий взгляд → реализация
    Codex → слепое двойное ревью разных родословных → синтез.
- Что:
  - SKILL.md: роли, шаги с критериями закрытия, триаж у исполнителя,
    границы применимости; словарь общий с coordinator-loop;
  - references: механика codex-companion с ловушками и раннер-паттерном,
    накопительная эмпирика прогонов, определения deep-reasoner/fast-worker
    для воссоздания в новом репозитории;
  - handoffs: записка о рождении скилла и списке непроверенного боем.
- Проверка:
  - зеркало ~/.claude/skills синхронно (diff -rq чисто); боевой тест —
    следующий прогон конвейера по тексту скилла.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Dmitry DementievandClaude Fable 5 committed 2026-07-06 18:22:00 +03:00
1 parent ca30ac5272
commit 138315d496
5 files changed
+414

No files matched your search

@@ -0,0 +1,89 @@
# Codex companion из Claude Code: команды и ловушки
Проверено 2026-07-06 (плагин openai-codex/codex 1.0.5). Путь к скрипту зависит
от версии — найди актуальный:
```bash
ls ~/.claude/plugins/cache/openai-codex/codex/*/scripts/codex-companion.mjs
```
Далее `$CC` = `node <найденный путь>`.
## Команды
```bash
$CC task --background --write --fresh "промпт" # реализация (пишет файлы)
$CC adversarial-review --background --scope working-tree "фокус ревью"
$CC status # все задачи; status <job-id> — одна, с прогрессом
$CC result <job-id> # финальный отчёт завершённой задачи
$CC cancel <job-id>
$CC task-resume-candidate --json # есть ли возобновляемый тред этой сессии
```
## Запуск через раннера-субагента — рекомендуемый путь
Приём из `/adversarial-review`: оркестратор не зовёт CLI сам и не городит
мониторы — фоновый субагент-раннер синхронно гоняет команду у себя, шум
остаётся в нём, а завершение субагента само будит оркестратора.
Ключевое правило: **раннеру — готовую команду, не постановку задачи.**
Получив постановку, «тонкий» агент реализует её сам (ловушка форвардера).
Промпт задачи живёт только внутри строки-аргумента команды.
Рецепт: Agent tool, `subagent_type: "general-purpose"` (или `fast-worker`,
если есть), `run_in_background: true`, промпт раннеру:
```text
Выполни ровно одну команду Bash, ничего не решай и не делай сверх неё:
$CC task --wait --write --fresh "<полный промпт задачи>" \
> /tmp/<scratchpad>/codex-run-<id>.log 2>&1
Затем верни: код возврата, путь к логу и последние ~30 строк лога.
```
Так же запускается и ревью (`adversarial-review --wait ...`). Прямой вызов
CLI с `--background` + фоновый bash-монитор (ниже) — запасной путь, когда
раннер нежелателен (например, экономия субагентов).
## Ловушки (все выстраданы)
- **Без `--write` среда Codex только на чтение.** Задача «реализуй…» без
этого флага молча не сможет писать файлы.
- **`task --help` не существует** — строка `--help` уходит Кодексу как промпт
и создаёт мусорный тред. Синтаксис смотри `$CC` без аргументов.
- **`--fresh` против `--resume-last`:** resume-last цепляет самый свежий тред,
а им может оказаться тред ревью, не реализации. Для точечных починок надёжнее
`--fresh` + точный промпт («добавь только X, ничего больше не меняй»).
- **Коммит запрещай промптом** («коммит не делай — оставь в рабочем дереве»):
ревью идёт по незакоммиченному дифу, коммитит оркестратор.
- **Тонкому агенту-форвардеру не давай содержательный промпт.** Субагент
`codex:codex-rescue` должен только пробросить команду; получив постановку
задачи, он реализует её сам вместо передачи (казус 2026-07-06 — второй
писатель в дереве). Либо зови companion напрямую из Bash, либо давай
форвардеру только готовую команду.
## Мониторинг фоновых задач (запасной путь)
При прямом `--background` уведомлений от companion нет — повесь фоновый
bash-монитор, он разбудит оркестратора по завершении:
```bash
# run_in_background: true
for i in $(seq 1 120); do
st=$($CC status <job-id> 2>/dev/null)
if echo "$st" | grep -q '| running |'; then sleep 30; else echo FINISHED; exit 0; fi
done
```
Парсить plain-text: `status --json` устроен иначе, чем кажется (грабли
2026-07-06 — монитор на JSON-поле `state` крутился вечно на `unknown`).
## Фоновые Claude-субагенты (Agent tool)
- Ревьюеров запускай `model: "opus"` (экономия лимитов; ревью на Фабуле —
~60k токенов за прогон).
- Фоновый агент по завершении шлёт **idle-уведомление без содержимого**.
Финальный отчёт запроси `SendMessage`: «верни готовый результат, ничего
нового не проверяй».
- Проверяй, что делегат сделал именно то, что просили: `git status` до и
после, кто и когда трогал файлы (`stat -c '%y'`), прежде чем запускать
следующего писателя.