docs(skill): claude-subagent-playbook — прямой codex exec, уроки прогона 2026-07-09

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-09 20:05:37 +03:00
1 parent 35d4114ba3
commit 4e496a1548
@@ -52,8 +52,10 @@

 ## Открытое

- Механику references/codex-companion.md стоит пересмотреть в пользу прямого
-  CLI (пункты 2–3); плагин оставить для интерактива.
+- ~~Механику references/codex-companion.md стоит пересмотреть в пользу прямого
+  CLI (пункты 2–3); плагин оставить для интерактива.~~ Сделано 2026-07-09:
+  файл заменён на references/codex-exec.md (три ветки: исполнитель/ревьюер/
+  триаж; пункты 2–3 и 6 поглощены), companion — абзац «для интерактива».
 - Определения deep-reasoner/fast-worker из references/claude-agents.md
  созданы в репозитории демо (закоммичены); фрагмент «Orchestration
  workflow» в CLAUDE.md демо-репозитория НЕ добавлен — пользователь решил
@@ -0,0 +1,57 @@
+# Handoff: прогон 2026-07-09 (Windows) и переход на прямой codex exec
+
+Дата: 2026-07-09. Для сессии, которая будет развивать скилл или гонять
+конвейер (на Linux — см. «Открытое»).
+
+## Состояние
+
+- Скилл прошёл **первый прогон по своему письменному тексту** и первый под
+  Windows (local-transcriber, SendTo-меню; фича закоммичена f18ad6e).
+  Эмпирика прогона — в references/lessons.md, блок 2026-07-09; здесь не
+  дублируется.
+- По итогам + урокам handoff 07-07 механика Codex переведена на прямой CLI:
+  references/codex-companion.md **удалён**, вместо него —
+  references/codex-exec.md (три ветки: исполнитель/ревьюер/триаж; сквозные
+  правила: шум в файлы, thread_id из первой строки, resume только по id,
+  проверка «отписки» логом, блок классификатора → решение пользователя).
+  SKILL.md: этап 3 — прямой exec фоновым Bash оркестратора; этап 4 —
+  критерий «вердикт без находок засчитывай после проверки лога».
+- Правки прошли свежий взгляд (Опус, с оптикой /writing-great-skills,
+  сверял команды с реальным `codex --help`): 2 major исправлены
+  (resume принимает `-m`; кавеат про недокументированный
+  `approvals_reviewer`), sediment companion-эры сжат до строки, дубль
+  промпта исполнителя схлопнут в указатель на этап 3.
+
+## Решения и их источники
+
+- Раннер-субагент понижен из «пути запуска» в «переваривание шумного
+  результата» (самодостаточный абзац в codex-exec.md, без ссылок на другие
+  скиллы — они могут быть недоступны). Причина: файл-редиректы дают чистоту
+  контекста без раннера, а 10-минутный потолок Bash бьёт именно по
+  синхронному раннеру, не по фоновому Bash оркестратора.
+- `approvals_reviewer="auto_review"`: в `--help` отсутствует, но
+  `--strict-config` принимает (проверено 2026-07-09), связка с
+  `approval_policy="on-request"` отработала боевой write-прогон. Следить:
+  если в новой версии CLI ключ отвалится — падение будет громким только
+  со `--strict-config`.
+
+## Открытое / не проверено боем
+
+1. **Linux-прогон рецептов codex-exec.md** — файл написан по
+   Windows-эмпирике + старым companion-урокам; первый линукс-прогон должен
+   подтвердить рецепты (особенно пути `$SCRATCH` и поведение классификатора).
+2. **Раннер-«переваривание»** в новой формулировке не обкатан (сегодня не
+   понадобился — вердикты были короткими).
+3. **Порог «мелочь vs конвейер»** — по-прежнему калиброван парой случаев.
+4. **deep-reasoner/fast-worker** в прогонах плейбука пока не участвовали;
+   вопрос «куда класть фрагмент Orchestration workflow» из handoff 07-07
+   так и открыт.
+5. Идея «эмпирического ревьюера» (безопасные проверки вне репо — сегодня
+   Опус сам воспроизводил краевые случаи) вписана в lessons, но в промпт
+   ревьюера в SKILL.md не поднята — решить при следующей правке, стоит ли.
+
+## Suggested skills
+
+- `/claude-subagent-playbook` — прогнать на Linux, расхождения — в lessons.
+- `/writing-great-skills` — оптика перед любыми правками структуры.
+- `/handoff` — обновить/заменить эту записку по итогам следующей сессии.