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,64 @@
# Handoff: рождение скилла claude-subagent-playbook и что в нём не проверено
Дата: 2026-07-06. Для сессии, которая будет развивать сам скилл (не МЛ-задачу).
## Состояние
- Скилл собран и готов к вызову: источник —
`~/dotfiles/agents/.agents/skills/claude-subagent-playbook/` (в git dotfiles
ещё не закоммичен), зеркало — `~/.claude/skills/claude-subagent-playbook/`.
Состав: SKILL.md + references/{codex-companion,lessons,claude-agents}.md.
- Собран по итогам одного боевого прогона (задача 05 «полировка витрины» в
`~/sources/t2-ml-forecast`, коммит 880d506) — но сам прогон шёл ДО оформления
скилла. **Скилл ни разу не исполнялся по своему письменному тексту.**
- Эмпирика прогона — в references/lessons.md (файл накопительный, дописывать
после каждого прогона). Память проекта t2-ml-forecast тоже знает о скилле:
`~/.claude/projects/-home-ddmitry-sources-t2-ml-forecast/memory/`.
## Дизайн-решения и их источники (не пересказ — только происхождение)
- Форма «набор знаний, не жёсткий каркас» — явное требование пользователя;
жёсткий каркас уже есть у `/coordinator-loop` (очередь issue, сторона Codex).
- Структура и словарь выверены по `/writing-great-skills`: user-invoked,
короткий description, completion criteria на шагах, ведущие слова общие с
coordinator-loop (индекс, родословная, свежесть).
- Раннер-паттерн для вызова Codex — из `/adversarial-review`
(references/runner.md там — самый проработанный образец: двухканальный
протокол, результат файлом, ретраи). Добавлен по предложению пользователя.
- Триаж находок исполнителем — из `/claude-team-review` и coordinator-loop
(«судит тот, у кого контекст кода»). Тоже добавлен по замечанию пользователя.
## Не проверено боем — проверять в следующих прогонах
1. **Раннер с `task --wait`** — в прогоне 05 использовался `--background` +
bash-монитор, раннер не пробовали. Открытый риск: у Bash-вызова внутри
субагента потолок 10 минут (timeout max 600000 мс), а реализация у Codex
шла ~15 минут. Раннеру, видимо, нужна инструкция «по таймауту не падать, а
опрашивать `$CC status`/`result` до завершения». Обкатать и вписать в
references/codex-companion.md то, что реально сработало.
2. **Триаж исполнителем** — в прогоне 05 триаж делал оркестратор (обе находки
принял сам). Формулировка «перешли индекс дословно, Codex чинит или
аргументированно отклоняет» — теория из соседних скиллов, не наша эмпирика.
3. **Фолбэк ревьюера** (general-purpose со скептическим промптом при
отсутствии adversarial-reviewer) — не обкатан.
4. **Порог «мелочь vs конвейер»** откалиброван по одному случаю — уточнять.
5. **Чего в скилле осознанно нет** (кандидаты при развитии, не тащить без
нужды): журнала прогона (след живёт в задаче-файле — хватит ли на длинной
задаче?); узкого rerun-а ревьюера продолжением той же сессии (SendMessage —
в 05 не понадобился); ролей deep-reasoner в синтезе.
## Ближайший боевой тест
Регламент переобучения («выживаемость») в t2-ml-forecast — единственный
незакрытый пункт Этапа 1 пилота, калибр подходящий. Вызвать
`/claude-subagent-playbook` в свежей сессии и смотреть, где текст скилла
расходится с практикой; расхождения — в lessons.md и правки SKILL.md.
## Suggested skills
- `/claude-subagent-playbook` — предмет работы; прогнать как написано.
- `/writing-great-skills` — перед любыми правками структуры скилла.
- `/adversarial-review` — образец раннера (references/runner.md) при обкатке
пункта 1.
- `/handoff` — по завершении сессии развития обновить эту записку (или
положить рядом новую; старую можно удалить, если полностью поглощена).