Dmitry DementievandClaude Fable 5
138315d496
- Зачем:
- выжимка боевого прогона 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>
90 lines
5.6 KiB
Markdown
90 lines
5.6 KiB
Markdown
# 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'`), прежде чем запускать
|
||
следующего писателя.
|