docs(skills): взаимообогащение близнецов-плейбуков после сверки
- Зачем:
- близнецы развивались порознь и разошлись: проверенные боем правила
клодовского плейбука отсутствовали в кодексовом, и наоборот; промах
скиллом 2026-07-22 показал цену дрейфа.
- Что:
- в кодексовый: одно ревью на версию артефакта, саморевью исполнителя и
сквозная проверка до внешних линий, «Партнёр в петле», цена тихой
ошибки как критерий уровня (заменой, класс задачи — иллюстрация),
проверка внешних фактов первоисточником, кавеат про неработающий
reasoning_effort субагентов;
- в клодовский: «Пределы параллельности» (обратная пара), карта
прогресса поглощена в «Пользователь в петле», автовызов моделью
(описание с триггерами вместо disable-model-invocation);
- lessons обоих: датированные записи сверки, урок 07-13 сжат до
указателя.
- Проверка:
- перечитка диффа свежим взглядом; следующий прогон конвейера — по
автовызванному claude-subagent-playbook.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
8312ef071e
commit
eb0d52ef57
5 files changed
+71
-10
No files matched your search
@@ -1,10 +1,11 @@
|
|||||||
---
|
---
|
||||||
name: claude-subagent-playbook
|
name: claude-subagent-playbook
|
||||||
disable-model-invocation: true
|
|
||||||
description: >-
|
description: >-
|
||||||
Конвейер одной задачи со стороны Claude Code: постановка тикетами-срезами →
|
Конвейер одной нетривиальной задачи со стороны Claude Code: постановка →
|
||||||
свежий взгляд по шкале → реализация Кодексом → ревью по шкале риска
|
свежий взгляд → реализация Кодексом → слепое ревью по шкале риска →
|
||||||
(до слепого двойного) → синтез. Знания, не каркас.
|
триаж → приёмка. Применяй, когда пользователь даёт issue/тикет в работу
|
||||||
|
конвейером, просит делегировать реализацию Codex или устроить
|
||||||
|
независимое ревью изменений.
|
||||||
---
|
---
|
||||||
|
|
||||||
# Плейбук: одна задача через Кодекса и слепое ревью
|
# Плейбук: одна задача через Кодекса и слепое ревью
|
||||||
@@ -70,6 +71,11 @@ description: >-
|
|||||||
(форк тратит токены и убивает независимость). Повторную проверку точечных
|
(форк тратит токены и убивает независимость). Повторную проверку точечных
|
||||||
правок — **тем же** ревьюером узким вопросом «закрывают ли правки твои
|
правок — **тем же** ревьюером узким вопросом «закрывают ли правки твои
|
||||||
находки», не полным обходом.
|
находки», не полным обходом.
|
||||||
|
- **Пределы параллельности**: глубина один — субагенты не разворачивают
|
||||||
|
собственных субагентов; параллельно только работа без конфликтующих
|
||||||
|
входов и общего изменяемого состояния; второй обзор добавляй ради
|
||||||
|
отдельной линии, а не ради свободного слота; реализацию и починку одного
|
||||||
|
дерева веди последовательно одним владельцем.
|
||||||
- **Вспомогательные Claude-субагенты** для попутного делегирования: глубокое
|
- **Вспомогательные Claude-субагенты** для попутного делегирования: глубокое
|
||||||
рассуждение — `deep-reasoner`, механика с шумным выводом — `fast-worker`.
|
рассуждение — `deep-reasoner`, механика с шумным выводом — `fast-worker`.
|
||||||
Они репо-локальные; нет в репозитории — определения для создания в
|
Они репо-локальные; нет в репозитории — определения для создания в
|
||||||
@@ -231,9 +237,12 @@ description: >-
|
|||||||
|
|
||||||
## Пользователь в петле
|
## Пользователь в петле
|
||||||
|
|
||||||
В отличие от `/coordinator-loop`, здесь пользователь рядом: докладывай в чат
|
В отличие от `/coordinator-loop`, здесь пользователь рядом: на границах
|
||||||
короткие статусы на границах этапов (постановка готова, ревью пришло,
|
этапов давай в чат карту прогресса в 4–7 строк обычными словами
|
||||||
вердикты сведены), решения по скоупу оставляй ему. Фоновые этапы будят тебя
|
(✅ сделано / ▶ идёт / ⬜ дальше); термины плейбука — только с расшифровкой
|
||||||
|
(урок 2026-07-13: телеграфные статусы в терминах этапов потеряли
|
||||||
|
пользователя). Карта дополняет содержательную сводку, не заменяет её.
|
||||||
|
Решения по скоупу оставляй пользователю. Фоновые этапы будят тебя
|
||||||
сами — не поллинг вручную, а отслеживаемые фоновые процессы + уведомления
|
сами — не поллинг вручную, а отслеживаемые фоновые процессы + уведомления
|
||||||
(механика — [references/codex-exec.md](references/codex-exec.md)).
|
(механика — [references/codex-exec.md](references/codex-exec.md)).
|
||||||
Подстраховка от молчаливой смерти агента — ScheduleWakeup сроком дольше
|
Подстраховка от молчаливой смерти агента — ScheduleWakeup сроком дольше
|
||||||
|
|||||||
@@ -177,8 +177,9 @@ git (`git show HEAD:path`) + повторным наложением право
|
|||||||
«информирование о ходе процесса было очень скудным». Урок: на каждой
|
«информирование о ходе процесса было очень скудным». Урок: на каждой
|
||||||
границе — карта прогресса 4–7 строк (✅ сделано / ▶ идёт / ⬜ дальше)
|
границе — карта прогресса 4–7 строк (✅ сделано / ▶ идёт / ⬜ дальше)
|
||||||
обычными словами, термины плейбука только с расшифровкой; карта дополняет
|
обычными словами, термины плейбука только с расшифровкой; карта дополняет
|
||||||
содержательную сводку, не заменяет. Кандидат на поглощение в SKILL.md
|
содержательную сводку, не заменяет. Поглощено 2026-07-23: SKILL.md
|
||||||
(«Пользователь в петле»).
|
(«Пользователь в петле») и близнец codex-subagent-playbook
|
||||||
|
(«Партнёр в петле»).
|
||||||
|
|
||||||
**Что поймал каждый этап:**
|
**Что поймал каждый этап:**
|
||||||
- Ревью постановки с эмпирикой перекроило тикет до реализации: Codex из
|
- Ревью постановки с эмпирикой перекроило тикет до реализации: Codex из
|
||||||
@@ -312,3 +313,14 @@ claude-subagent-playbook»); правила канала в codex-exec.md был
|
|||||||
потолок Kafka: манифест 3 152 байта вместо ~0,81 МБ); приёмка — плоское
|
потолок Kafka: манифест 3 152 байта вместо ~0,81 МБ); приёмка — плоское
|
||||||
время next-day 716/718/716 с, мир 3 → 6 дней, 561 942 события; тесты
|
время next-day 716/718/716 с, мир 3 → 6 дней, 561 942 события; тесты
|
||||||
216 + 31 зелёные.
|
216 + 31 зелёные.
|
||||||
|
|
||||||
|
## 2026-07-23: сверка близнецов после промаха скиллом
|
||||||
|
|
||||||
|
В кодексовый близнец перенесены проверенные здешними прогонами правила:
|
||||||
|
одно ревью на версию артефакта, саморевью исполнителя и сквозная проверка
|
||||||
|
до внешних линий, цена тихой ошибки как критерий уровня, проверка внешних
|
||||||
|
фактов первоисточником, партнёр в петле. Обратно взяты «Пределы
|
||||||
|
параллельности» (глубина один; второй обзор ради отдельной линии, а не
|
||||||
|
свободного слота) — в SKILL.md, раздел «Роли». Скилл переведён на
|
||||||
|
автовызов моделью (описание с триггерами), близнец скрыт
|
||||||
|
`disable-model-invocation` — пара промахов исключена с обеих сторон.
|
||||||
@@ -78,6 +78,16 @@ description: "Оптика тонкого мастера для координа
|
|||||||
назвать причину. Сложную, рискованную или архитектурную постановку проверяй
|
назвать причину. Сложную, рискованную или архитектурную постановку проверяй
|
||||||
двумя слепыми линиями, когда цена оправдана.
|
двумя слепыми линиями, когда цена оправдана.
|
||||||
|
|
||||||
|
Одно ревью на версию артефакта, а не на каждую передачу из рук в руки:
|
||||||
|
принятый и не изменившийся артефакт заново не ревьюится, после правок —
|
||||||
|
узкая проверка дельты тем же ревьюером.
|
||||||
|
|
||||||
|
Перед внешними линиями — саморевью исполнителя тем же тредом: он проходит
|
||||||
|
свои изменения против критериев как ревьюер и сам чинит найденное;
|
||||||
|
координатору — одна строка «found N, fixed N». Доступную дешёвую сквозную
|
||||||
|
проверку прогони до запуска ревьюеров, иначе ревью уйдёт на код, который
|
||||||
|
прогон ещё поменяет.
|
||||||
|
|
||||||
Реализацию проверяй по риску:
|
Реализацию проверяй по риску:
|
||||||
|
|
||||||
- тривиальная — саморевью исполнителя;
|
- тривиальная — саморевью исполнителя;
|
||||||
@@ -121,6 +131,13 @@ description: "Оптика тонкого мастера для координа
|
|||||||
Новый урок для [эмпирики](references/lessons.md) только предложи партнёру.
|
Новый урок для [эмпирики](references/lessons.md) только предложи партнёру.
|
||||||
Правь долговечную эмпирику после его согласия.
|
Правь долговечную эмпирику после его согласия.
|
||||||
|
|
||||||
|
## Партнёр в петле
|
||||||
|
|
||||||
|
На границах этапов давай партнёру карту прогресса в 4–7 строк обычными
|
||||||
|
словами: что сделано, что идёт, что дальше. Термины плейбука — только с
|
||||||
|
расшифровкой. Карта дополняет содержательную сводку, не заменяет её.
|
||||||
|
Решения о скоупе и принятии остаточного риска остаются у партнёра.
|
||||||
|
|
||||||
## Сбои координации
|
## Сбои координации
|
||||||
|
|
||||||
- Нет ожидаемого файла: один раз запроси короткий итог в том же треде; после
|
- Нет ожидаемого файла: один раз запроси короткий итог в том же треде; после
|
||||||
|
|||||||
@@ -24,6 +24,16 @@
|
|||||||
права ревьюера смешались с каналом результата; семь буквальных этапов
|
права ревьюера смешались с каналом результата; семь буквальных этапов
|
||||||
породили лишние проверки. Вывод поглощён в
|
породили лишние проверки. Вывод поглощён в
|
||||||
[основную оптику](../SKILL.md) и [договор ревью](review-and-triage.md).
|
[основную оптику](../SKILL.md) и [договор ревью](review-and-triage.md).
|
||||||
|
- 2026-07-23 — сверка с клодовским близнецом (claude-subagent-playbook):
|
||||||
|
перенесены проверенные его прогонами правила — одно ревью на версию
|
||||||
|
артефакта, саморевью исполнителя и сквозная проверка до внешних линий,
|
||||||
|
партнёр в петле (в [основную оптику](../SKILL.md)); цена тихой ошибки
|
||||||
|
как критерий уровня и проверка внешних фактов первоисточником
|
||||||
|
(в [роли](roles.md)).
|
||||||
|
- 2026-07-23 — по опыту партнёра хост принимает `reasoning_effort`
|
||||||
|
субагента, но фактически не применяет его; действующая ручка уровня —
|
||||||
|
модель и TOML-роль. Кавеат внесён в [роли](roles.md); снять после
|
||||||
|
починки хоста.
|
||||||
|
|
||||||
## Проверить боем
|
## Проверить боем
|
||||||
|
|
||||||
|
|||||||
@@ -78,11 +78,24 @@
|
|||||||
| Глубокий | Архитектура, сложная реализация, ревью кода | Сильная модель, `high` |
|
| Глубокий | Архитектура, сложная реализация, ревью кода | Сильная модель, `high` |
|
||||||
| Исключительный | Необратимое решение или несходимость сильных агентов | Самая сильная модель, `max` |
|
| Исключительный | Необратимое решение или несходимость сильных агентов | Самая сильная модель, `max` |
|
||||||
|
|
||||||
|
Критерий выбора — цена *тихой* ошибки этапа, не сложность работы: где
|
||||||
|
пропущенный дефект никто ниже по конвейеру не поймает (постановка, слепое
|
||||||
|
ревью, диагноз), ставь глубокий уровень; где за результатом стоит приёмка
|
||||||
|
координатора и ошибка громкая (узкая перепроверка, механика), хватает
|
||||||
|
рабочего. Таблица «для чего» — иллюстрация этого критерия, не замена.
|
||||||
|
Экономию уровня считай по конвейеру целиком: дешёвый этап, породивший
|
||||||
|
длинный триаж находок, выходит дороже дорогого.
|
||||||
|
|
||||||
Модель задаёт потолок способности, effort — глубину работы этой модели.
|
Модель задаёт потолок способности, effort — глубину работы этой модели.
|
||||||
Повышай effort, когда подходящей модели не хватило поиска или рассуждения.
|
Повышай effort, когда подходящей модели не хватило поиска или рассуждения.
|
||||||
Повышай модель, когда не хватает качества решения. После двух слабых
|
Повышай модель, когда не хватает качества решения. После двух слабых
|
||||||
результатов замени исполнителя свежим более сильным агентом вместо переноса
|
результатов замени исполнителя свежим более сильным агентом вместо переноса
|
||||||
его неудачного контекста.
|
его неудачного контекста. От уверенной выдумки внешних фактов (форматы
|
||||||
|
артефактов, версии) не страхует никакой уровень — такие факты проверяй
|
||||||
|
реальным запросом или фикстурой из первоисточника.
|
||||||
|
Кавеат (2026-07-23): текущий хост принимает `reasoning_effort` субагента,
|
||||||
|
но фактически не применяет — рабочая ручка сейчас только модель;
|
||||||
|
перепроверяй после обновлений хоста.
|
||||||
|
|
||||||
`xhigh` не является автоматической ступенью: текущая эмпирика показывает
|
`xhigh` не является автоматической ступенью: текущая эмпирика показывает
|
||||||
малый прирост относительно `high` при заметной цене. Выбирай его вручную для
|
малый прирост относительно `high` при заметной цене. Выбирай его вручную для
|
||||||
|
|||||||
Reference in new issue
Block a user