docs(skills): codex-playbook — канал командной строки и уроки прогона

- Зачем:
  - боевой прогон 2026-07-22 (конвейер issue #5 в демо-стенде) прошёл
    через плагин-обёртку Codex и воспроизвёл её известные баги; ресёрч
    2026-07-07 давно рекомендовал прямой CLI, но в скилл не был поглощён.
- Что:
  - roles.md: третий режим «Канал командной строки» — codex exec фоном
    у координатора, resume треда, плагин только для интерактива;
  - SKILL.md: передача владения только после остановки прежнего
    владельца; проверка команд сценария на живом объекте до прогона;
  - lessons.md: два датированных наблюдения 2026-07-22, вопрос №9
    переориентирован на проверку CLI-канала боем.
- Проверка:
  - перечитка трёх файлов на связность и отсутствие дублей;
    следующий прогон конвейера — по CLI-каналу.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
ddadminandClaude Fable 5 committed 2026-07-23 00:06:57 +03:00
1 parent db0c3aff09
commit 43a93cd3c3
3 files changed
+31 -5

No files matched your search

@@ -101,6 +101,8 @@ description: "Оптика тонкого мастера для одной не
3. полный diff, только когда его объём ограничен и чтение нужно для решения. 3. полный diff, только когда его объём ограничен и чтение нужно для решения.
Доступную детерминированную финальную проверку запускай сам с выводом в файл. Доступную детерминированную финальную проверку запускай сам с выводом в файл.
Команды нового сценария проверь на живом объекте до полного прогона; сложные
вставки собирай файлами, не экранированием.
В контекст возьми точную команду, код возврата, итоговые счётчики, имена В контекст возьми точную команду, код возврата, итоговые счётчики, имена
упавших тестов и путь к журналу. Зелёный журнал не читай. Красный журнал упавших тестов и путь к журналу. Зелёный журнал не читай. Красный журнал
направь исполнителю или отдельному разборщику; сам открывай детали, когда они направь исполнителю или отдельному разборщику; сам открывай детали, когда они
@@ -123,7 +125,8 @@ description: "Оптика тонкого мастера для одной не
## Сбои координации ## Сбои координации
- Нет ожидаемого файла: один раз запроси короткий итог в том же треде; после - Нет ожидаемого файла: один раз запроси короткий итог в том же треде; после
повторной тишины продолжи свежим агентом от сохранённых артефактов. повторной тишины продолжи свежим агентом от сохранённых артефактов, передав
владение только после остановки прежнего владельца.
- Длинный рассказ пришёл сообщением: попроси повторить ответ сводкой и путём, - Длинный рассказ пришёл сообщением: попроси повторить ответ сводкой и путём,
не переноси рассказ дальше. не переноси рассказ дальше.
- Два исполнителя пересеклись в исходниках: останови их, установи одного - Два исполнителя пересеклись в исходниках: останови их, установи одного
@@ -24,6 +24,18 @@
права ревьюера смешались с каналом результата; семь буквальных этапов права ревьюера смешались с каналом результата; семь буквальных этапов
породили лишние проверки. Вывод поглощён в породили лишние проверки. Вывод поглощён в
[основную оптику](../SKILL.md) и [договор ревью](review-and-triage.md). [основную оптику](../SKILL.md) и [договор ревью](review-and-triage.md).
- 2026-07-22 — конвейер пошёл через плагин-обёртку вопреки ресёрчу
2026-07-07 и воспроизвёл её известные сбои: ложный старт с пустым
запросом, потерянные уведомления, несбрасываемый статус остановленной
задачи, read-only песочница ревьюера (вердикт извлекли из лога задачи).
Результаты спас файловый контроль координатора: мандаты и отчёты жили в
`$SCRATCH`, дерево сверялось тестами. Вывод поглощён в
[роли](roles.md): канал командной строки.
- 2026-07-22 — приёмочный сценарий трижды падал на непроверенных командах
(способ аутентификации, маскировка кода выхода, имя колонки), а
инлайн-python с экранированием в heredoc сломался и после проверки.
Вывод поглощён в [основную оптику](../SKILL.md): проверка команд на
живом объекте, сборка сценария из файлов.
## Проверить боем ## Проверить боем
@@ -42,6 +54,8 @@
7. Доступны ли ревьюеру поиск и документация при текущих сетевых разрешениях. 7. Доступны ли ревьюеру поиск и документация при текущих сетевых разрешениях.
8. Достаточно ли файлового канала, чтобы координатор не открывал полный 8. Достаточно ли файлового канала, чтобы координатор не открывал полный
отчёт, diff и сырые журналы. отчёт, diff и сырые журналы.
9. Может ли будущая линия другого семейства читать и писать общий 9. Работает ли канал командной строки (`codex exec` фоном у координатора)
`$SCRATCH`. Пока адаптер запуска не проверен, он не является действующим на полном конвейере: запуск, resume треда ревьюера, чтение и запись
договором. общего `$SCRATCH`. Прогон 2026-07-22 проверил только плагинный канал —
он забракован; при workspace-write запись в `$SCRATCH` работала,
read-only песочница — нет.
@@ -18,7 +18,8 @@
## Возможности хоста ## Возможности хоста
Сначала установи, позволяет ли текущий хост выбрать пользовательского агента Сначала установи, позволяет ли текущий хост выбрать пользовательского агента
и его конфигурацию. и его конфигурацию, а для линии другого семейства — каким каналом её
запускать.
- **Управляемая стоимость.** Хост видит агентов из `~/.codex/agents` или - **Управляемая стоимость.** Хост видит агентов из `~/.codex/agents` или
`.codex/agents` и схема `spawn_agent` открывает `agent_type`, `model` и `.codex/agents` и схема `spawn_agent` открывает `agent_type`, `model` и
@@ -32,6 +33,14 @@
имя треда. Передавай роль мандатом в промпте, но не утверждай, что выбрана имя треда. Передавай роль мандатом в промпте, но не утверждай, что выбрана
дешёвая или сильная модель. `task_name` — идентификатор треда, а не выбор дешёвая или сильная модель. `task_name` — идентификатор треда, а не выбор
конфигурации агента. конфигурации агента.
- **Канал командной строки.** Хост другого семейства запускай напрямую:
`codex exec` в собственной фоновой команде координатора — pid, код выхода
и лог принадлежат координатору, а не посреднику. Модель и effort задавай
явно; тред продолжай через `codex exec resume <session-id>`.
Плагин-обёртку с фоновыми задачами для конвейера не используй: известные
сбои — ложный «started» с подменой ответа, зависшие фоновые ревью, воркеры
без признаков жизни (openai/codex-plugin-cc issues #279, #158, #49, #277);
она годится только для интерактива по явному запросу партнёра.
Если способ выбора роли не виден в доступном инструменте, считай стоимость Если способ выбора роли не виден в доступном инструменте, считай стоимость
неуправляемой, отметь это в итоговом отчёте и не разделяй совместимую работу неуправляемой, отметь это в итоговом отчёте и не разделяй совместимую работу