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:
1 parent
ca30ac5272
commit
138315d496
5 files changed
+414
No files matched your search
+64
@@ -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` — по завершении сессии развития обновить эту записку (или
|
||||
положить рядом новую; старую можно удалить, если полностью поглощена).
|
||||
Reference in new issue
Block a user