docs(skills): эффорт-карта субагентов пересчитана под Opus 5

- Зачем:
  - скилл писался под Opus 4.8; у Opus 5 усилия распределены иначе, high —
    верхняя рабочая ступень, xhigh дефолтить смысла нет.
- Что:
  - карта в SKILL.md сдвинута на ступень вниз (high — ревью постановок,
    medium — слепое ревью и узкие перепроверки, default — механика),
    нижняя граница ревью опущена с high до medium.
  - добавлены оговорки: неравномерность сдвига, deep-reasoner остаётся на
    high, механика едет на Sonnet и эффорт там не крутится.
  - в lessons.md записано решение 2026-07-26, помечена как пересмотренная
    запись 2026-07-21 и заведён открытый вопрос: чем координатор вообще
    выставляет effort (у Agent-тула такого параметра нет).
  - пункт про вспомогательных субагентов переписан активно: нет в репо —
    предложить создать по заготовке и работать ими.
- Проверка:
  - git diff HEAD~1 -- agents/.agents/skills/claude-subagent-playbook/;
    сверить, что xhigh в SKILL.md больше не упоминается.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
ddadminandClaude Opus 5 committed 2026-07-26 19:06:01 +03:00
1 parent c6d7e7eeb0
commit 357896faaa
2 files changed
+83 -10

No files matched your search

@@ -78,8 +78,12 @@ description: >-
дерева веди последовательно одним владельцем.
- **Вспомогательные Claude-субагенты** для попутного делегирования: глубокое
рассуждение — `deep-reasoner`, механика с шумным выводом — `fast-worker`.
Они репо-локальные; нет в репозитории — определения для создания в
[references/claude-agents.md](references/claude-agents.md).
Они репо-локальные; нет в репозитории — **предложи пользователю создать**
по заготовкам из
[references/claude-agents.md](references/claude-agents.md) и дальше
работай ими, а не разовым `general-purpose`: определение — одноразовая
цена, зато модель и effort заданы явно и переживают сессию. Молча не
заводить: `.claude/agents/` — территория пользователя.
- **Модель Claude-субагентов задавай явно**: Опус — рассуждения и ревью,
Sonnet — механика. Без явной модели субагент наследует Fable, чьи лимиты
самые дорогие — держи их для оркестрации (у `deep-reasoner`/`fast-worker`
@@ -88,13 +92,23 @@ description: >-
после двух слабых результатов подряд — свежий более сильный агент вместо
переноса неудачного контекста.
- **Effort Claude-субагентов тоже задавай явно** (решение пользователя
2026-07-21), по цене *тихой* ошибки этапа, не по сложности: `xhigh` —
ревью постановок и планов (дефект каскадирует: отравляет реализацию, оба
ревью и триаж — казус CODE-1 в xray-proxy 04); `high` — слепое ревью
(последняя линия обороны своей линзы, пропуск тихий); `medium`/default —
узкие перепроверки и механика (за ними приёмка оркестратора, ошибка
громкая). Ревью ниже high не опускать даже при двух ревьюерах: линзы
разные, избыточность — не дублирование. Внутри одного агента effort между
2026-07-26 под Opus 5: усилия распределены иначе, чем у 4.8, — `high`
верхняя рабочая ступень, `xhigh` не дефолтить; условно `high` у Opus 5
ближе к прежнему `xhigh`, `medium` — чуть ниже прежнего `high`, то есть
ступени сдвинулись неравномерно), по цене *тихой* ошибки этапа, не по
сложности: `high` — ревью постановок и планов (дефект каскадирует:
отравляет реализацию, оба ревью и триаж); `medium` — слепое ревью
(последняя линия обороны своей линзы, пропуск тихий) и узкие
перепроверки; default — механика (за ней приёмка оркестратора, ошибка
громкая; она и так идёт Sonnet-агентом — эффорт там не крутить вовсе).
Ревью ниже medium не опускать даже при двух ревьюерах: линзы разные,
избыточность — не дублирование. У `deep-reasoner` `high` пришит
фронтматтером и понижению не подлежит: он специалист по рассуждению, а
в роли фолбэк-ревьюера просто приедет ступенью выше карты — карта
задаёт минимум для роли, а не ограничение для агента. Ступеней меньше,
чем этапов, — это нормально: эффорт задаёт лишь глубину поверх
выбранной модели, тонкая настройка идёт промптом. Внутри одного агента
effort между
резюмами не менять (у Claude смена thinking-конфига сбрасывает
messages-ярус кэша; про effort не задокументировано — не рисковать).
Ограничение любого эффорта: от уверенной выдумки внешних фактов (форматы