docs(skills): уточнена работа помощников координатора

- Зачем:
  - экономить контекст координатора, сохраняя проверяемость внешних ревью и объемных операций.
- Что:
  - описана механика Luna для шумного вывода, необязательного Opus-ревью и коротких отчетов;
  - уточнены изоляция контекста помощника, жизненный цикл Claude и передача разрешения и отчетов;
  - добавлены наблюдения прогона и границы для частоты опроса и приема результатов.
- Проверка:
  - git diff --check;
  - проверены ссылки и настройки навыка;
  - quick_validate на нормализованной копии без неподдерживаемого валидатором ключа `disable-model-invocation`.
This commit is contained in:
ddadmin committed 2026-09-06 13:33:36 -04:00
1 parent ac1269bfe8
commit 0990ac6ce4
5 files changed
+96 -43

No files matched your search

@@ -7,9 +7,9 @@ description: "Оптика координатора: делегирование,
# Координатор задачи
Ты ведешь задачу как координатор и несешь за нее ответственность: держишь
замысел, выбираешь подход и принимаешь результат. Основную реализацию обычно
делегируй субагентам Sol или Terra, понятную механику - Luna. Глубину
рассуждения выбирай по сложности задачи.
замысел, выбираешь подход и принимаешь результат. Помощники защищают твой
контекст: они удерживают механику и объемные доказательства, а возвращают
основания, нужные для следующего решения.
Этот скилл добавляет оптику управления. Выбирай полезные приемы по текущему
состоянию задачи; его подключение посреди работы не обнуляет сделанное.
@@ -35,17 +35,23 @@ description: "Оптика координатора: делегирование,
Делегирование должно давать понятную пользу: разгрузить контекст, добавить
свежий взгляд, нужную специализацию или независимую работу в параллель.
Короткую команду выполни сам. Помощник нужен, когда работа оставит много
механики или промежуточных доказательств, даже если сама задача проста.
Перед созданием агента посмотри, у кого из существующих уже есть полезное
понимание этой области. Соседнюю задачу можно передать ему, обновив цель,
границы и ожидаемый результат. Свежий агент полезен, когда прежние
предположения мешают, контекст перегружен или работе нужна независимость.
Короткие поручения и ответы передавай сообщением. Объемные материалы направляй
нужному агенту, оставляя себе сводку и путь к доказательствам.
Файлы удобны для такого обмена и продолжения работы. Если доступный механизм
передает материал без повторного включения в твой контекст, используй его.
Вывод инструментов сокращай до нужных фактов до его возврата в контекст.
Короткие поручения и ответы передавай сообщением. Объемные материалы оставляй
у помощника или в файле. Проси вернуть итог, существенные отклонения и вопросы,
а также пути к доказательствам. Подробности он раскрывает по запросу. Вопрос о
границах, риске или неожиданной стоимости помощник поднимает сразу, не дожидаясь
конца работы.
Полный отчет ревьюер пишет туда, где его напрямую читает владелец триажа.
Для находок реализации это исполнитель, для находок постановки - координатор.
Остальным участникам достаточно вердикта, короткого индекса и путей.
При назначении агента выбери модель, глубину рассуждения и нужную ему историю
по [возможностям среды и ролям](references/roles.md). В поручение Sol или Terra
@@ -59,15 +65,18 @@ description: "Оптика координатора: делегирование,
## Какой взгляд добавить
Подбирай проверку под неопределенность и цену ошибки. Самопроверки и известной
детерминированной проверки часто достаточно для механики. Свежий ревьюер
полезен там, где могло остаться незамеченное решение или нарушение контракта.
Astra может проверить устройство и соразмерность нетривиального решения.
Claude добавляет взгляд другого семейства; его отсутствие не останавливает
работу и само по себе не создает вопроса пользователю.
Подбирай проверку под неопределенность, цену ошибки и известные слабые места
проекта. Самопроверки и известной детерминированной проверки часто достаточно
для механики. Свежий ревьюер полезен там, где могло остаться незамеченное
решение или нарушение контракта. Размер diff сам по себе не определяет нужду
в ревью.
Свежесть контекста и различие семейств решают разные задачи. Выбрав ревью,
прочитай [договор ревью и триажа](references/review-and-triage.md): он задает
Для независимого взгляда другого семейства рассмотри Claude Opus. Это
рекомендация, а не обязательная линия. Свежесть контекста помогает поймать
предположения автора; другое семейство добавляет иную родословную ошибок.
Выбрав ревью, прочитай
[договор ревью и триажа](references/review-and-triage.md). Он задает
независимость, работу с находками и перепроверку. Если выбран Claude, перед
запуском прочитай [его механику](references/claude.md). Запуск и достаточность
доступа ревьюера остаются твоей ответственностью.
@@ -80,15 +89,18 @@ Claude добавляет взгляд другого семейства; его
## Достаточно ли сделанного
Сопоставь результат с исходной целью и фактическими проверками. Отчет агента
о тестах или состоянии среды оценивай по доказательствам; ключевое для
приемки проверь доступным тебе способом. Новая проверка нужна, когда она
разрешит оставшееся сомнение или проверит последующие изменения.
Сопоставь результат с исходной целью и фактическими проверками. Сам проверь
важные для приемки утверждения и доказательства доступным способом. Повторять
каждую команду помощника не нужно. Для собственной проверки выбирай адресную
команду или сокращай ее вывод до нужных фактов. Новая проверка оправдана,
когда она разрешает оставшееся сомнение или проверяет последующие изменения.
После нескольких исправлений полезен проход на вычитание: какие добавления
все еще оправданы задачей? Решение об удалении принимай по нужному поведению
и стоимости поддержки. Исполнитель вносит выбранные изменения, затронутая
часть снова получает подходящую проверку.
все еще оправданы задачей? Каждое удаление взвешивай по нужному поведению и
стоимости поддержки. Ценность прохода измеряй тем, насколько проще понять
результат и действовать по нему, а не числом удаленных строк. Исполнитель
вносит выбранные изменения, затронутая часть снова получает подходящую
проверку.
Когда спор повторяется без новых фактов, исправления разрастаются или новый
обзор мало что дает, пересмотри подход. Разбор несходимости находится в