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

@@ -261,7 +261,8 @@ git (`git show HEAD:path`) + повторным наложением право
SKILL.md — эффорт-карта Claude-субагентов): реализация по
отревьюированному тикету → medium допустим; Claude-субагентам effort
задавать явно — xhigh постановки/планы, high слепое ревью, medium
перепроверки; ревью ниже high не опускать.
перепроверки; ревью ниже high не опускать. **Пересмотрено 2026-07-26**
(см. ниже) — карта сдвинута на ступень вниз под Opus 5.
## Прогон 2026-07-21: yantar-dags, предразметка — этап постановки
@@ -347,3 +348,61 @@ claude-reviews-code-meaningfulness): 1) в линзу Claude-ревьюера д
Попутно: образец заражает — исполнитель добавлял прозаические тесты,
следуя уже существующим в файле (жанр «тест на фразу README» там был до
него). Чистка легаси-жанра — отдельным issue (#24), не в ветке фичи.
## Решение пользователя 2026-07-26: эффорт-карта Claude-субагентов под Opus 5
Скилл писался под Opus 4.8; у Opus 5 усилия распределены иначе, и `high`
стал верхней рабочей ступенью — выше неё смысл появляется редко. Карта в
SKILL.md сдвинута на ступень вниз: `high` — ревью постановок и планов
(было `xhigh`); `medium` — слепое ревью (было `high`) и узкие
перепроверки; default — механика. Нижняя граница ревью опущена с `high`
до `medium`.
Сдвиг неравномерный (оценка пользователя, заведомо условная): `high` у
Opus 5 по отдаче ближе к прежнему `xhigh`, а `medium` — чуть ниже
прежнего `high`. То есть на ревью постановок потеря близка к нулю, а на
слепом ревью просадка есть, но меньше, чем выглядит по названию ступени.
Следствие: ступеней теперь меньше, чем этапов, — слепое ревью и узкие
перепроверки делят `medium`. Это осознанно: эффорт задаёт лишь потолок
глубины поверх выбранной модели, тонкая настройка идёт промптом.
`deep-reasoner` остаётся на `high` (решение пользователя): понижать
специалиста по рассуждению не надо. В роли фолбэк-ревьюера он приедет
ступенью выше карты — принято осознанно, карта задаёт минимум для роли,
а не потолок для агента.
Оси не путать: механика едет на Sonnet (`fast-worker`, модель пришита в
определении), и ярус «default» там означает «эффорт не крутить», а не
дешёвый режим Опуса.
Не изменилось: эффорт Codex (`references/codex-exec.md`) — там своя
шкала, по сложности; запрет менять effort между резюмами одного треда; и
главный предел — от уверенной выдумки внешних фактов не страхует никакой
эффорт (казус CODE-1).
### Открытый вопрос 2026-07-26: чем координатор выставляет effort субагенту
Правило «effort задавай явно» предполагает, что ручка у оркестратора
есть. По схеме Agent-тула в текущем харнессе её нет: параметры вызова —
`model`, `subagent_type`, `isolation`, `run_in_background`, но не
`effort`. Достоверно ступень задаётся двумя путями: фронтматтером в
определении агента (`effort:` — как у `deep-reasoner`) и `opts.effort` в
скрипте Workflow. Значит для разового вызова без определения — вариант
«скептический `general-purpose`» из SKILL.md, этап 4 — карта
нереализуема: агент приедет на эффорте сессии.
Обход, доступный уже сейчас (решение пользователя): нужного субагента
нет в репозитории — **предложи пользователю его создать** по заготовке
из [claude-agents.md](claude-agents.md) (в том числе роль с нужным
`effort:` во фронтматтере) и дальше работай уже им, а не разовым
`general-purpose`. Определение — одноразовая цена, ступень и модель
после него заданы явно и переживают сессию. Заводить молча не надо:
файлы в `.claude/agents/` — территория пользователя.
Пользователь предполагал, что ручка координатору доступна, — проверить
на ближайшем прогоне. Если подтвердится, что нет, это тема рефакторинга
скилла: либо карта явно расписывается «через определение агента / через
Workflow», либо для каждой роли карты заводится определение с пришитым
эффортом (и фолбэк «скептический general-purpose» из этапа 4 уходит).
До проверки карту не переписывать — вопрос механики, не решения.