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

- Зачем: - сохранить в основной ветке согласованный способ экономить контекст и сопровождать ревью. - Что: - добавлены правила изоляции и выбора Luna для механики Claude; - закреплены факты прогона, передача отчетов и границы наблюдения. - Проверка: - git diff --check; - проверено слияние двух коммитов feature-ветки без конфликтов.
2026-09-06 14:00:10 -04:00
commit e13fbd7ebb
@@ -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 добавляет взгляд другого семейства; его

 ## Достаточно ли сделанного

-Сопоставь результат с исходной целью и фактическими проверками. Отчет агента
-о тестах или состоянии среды оценивай по доказательствам; ключевое для
-приемки проверь доступным тебе способом. Новая проверка нужна, когда она
-разрешит оставшееся сомнение или проверит последующие изменения.
+Сопоставь результат с исходной целью и фактическими проверками. Сам проверь
+важные для приемки утверждения и доказательства доступным способом. Повторять
+каждую команду помощника не нужно. Для собственной проверки выбирай адресную
+команду или сокращай ее вывод до нужных фактов. Новая проверка оправдана,
+когда она разрешает оставшееся сомнение или проверяет последующие изменения.

 После нескольких исправлений полезен проход на вычитание: какие добавления
-все еще оправданы задачей? Решение об удалении принимай по нужному поведению
-и стоимости поддержки. Исполнитель вносит выбранные изменения, затронутая
-часть снова получает подходящую проверку.
+все еще оправданы задачей? Каждое удаление взвешивай по нужному поведению и
+стоимости поддержки. Ценность прохода измеряй тем, насколько проще понять
+результат и действовать по нему, а не числом удаленных строк. Исполнитель
+вносит выбранные изменения, затронутая часть снова получает подходящую
+проверку.

 Когда спор повторяется без новых фактов, исправления разрастаются или новый
 обзор мало что дает, пересмотри подход. Разбор несходимости находится в
@@ -5,22 +5,25 @@ Claude - необязательная линия; нативный процес

 ## Выбор и доступ

-Модель и глубину выбирай по пользовательскому предпочтению и результатам
-реальных прогонов. Прежние рейтинги Opus, Sonnet или других моделей не являются
-постоянной гарантией. Записывай запрошенные настройки отдельно от фактически
-подтвержденных метаданных запуска.
+Для независимого ревью запускай Opus, если пользователь не выбрал другую
+модель. Записывай запрошенные настройки отдельно от фактически подтвержденных
+метаданных запуска.

 Полноценному ревью нужны доступные тесты, документация, сеть и временные файлы.
 Если установленная версия поддерживает `--permission-mode auto`, запускай
 с этим режимом. Внешняя песочница только для чтения обедняет проверку; исходники
 и постоянное состояние защищает [мандат ревьюера](prompts/review-boilerplate.md).
 Запуск `claude` передает поручение и выбранные материалы внешнему сервису
-Anthropic. Сначала примени уже полученное разрешение. Если действующая политика
-требует отдельного разрешения, получи его до передачи материалов и сохрани
-ценность выбранной линии при ожидании решения. При реальной блокировке назови
-конкретную команду или ресурс и наблюдаемую ошибку, затем выбери доступного
-ревьюера с честно указанным ограничением. Не засчитывай урезанный запуск как
-полноценную выбранную линию.
+Anthropic. Для своей личной конфигурации Дмитрий дал постоянное разрешение
+передавать через CLI Claude материалы текущей задачи для ревью: diff, фрагменты
+кода, отчеты ревью и разбора находок. При переносе скилла другому владельцу это
+не становится его согласием. Фактически действующее разрешение передай точной
+границей в поле `TRANSFER` из
+[шаблона поручения](prompt-templates.md#независимое-ревью). Повторно спрашивать
+о том же канале и тех же материалах не нужно. Посторонние материалы и другие
+внешние действия отдельно сверяй с действующими разрешениями. При реальной
+блокировке назови конкретную команду или ресурс и наблюдаемую ошибку. Урезанный
+доступ не засчитывай как полноценную выбранную линию.

 ## Возможности установленного CLI

@@ -42,13 +45,25 @@ Anthropic. Сначала примени уже полученное разре
 отчета. Для короткого поручения подходит форма:

 ```text
-claude --permission-mode auto --model <model> --effort <level> --bg "<mandate>"
+claude --permission-mode auto --model opus --effort <level> --bg "<mandate>"
 ```

 Большой промпт оставь в общем временном каталоге и передай короткий мандат с
 путем. Шумный поток CLI сохрани во временном журнале; координатору верни
 ограниченный индекс и путь к отчету.

+Для долгой внешней линии предпочтительно выделить отдельную Luna. Она отвечает
+за запуск, наблюдение, получение отчета и продолжение сохраненной сессии до
+завершения линии. Храни у нее идентификатор сессии и пути к промпту, журналу и
+отчету. Другой помощник остается свободен для Git, механики и параллельной
+работы. Партнеру понятно, кто ведет обзор и какого результата ждать. Короткий
+обзор не требует отдельного агента.
+
+Основной канал наблюдения - события среды. В долгой тишине Luna может
+проверять состояние примерно раз в минуту и сообщать координатору о завершении,
+застое, ошибке или нужном решении. Для прямого опроса координатором без новых
+событий ориентир - один раз в пять минут.
+
 Перед узкой перепроверкой убедись, что исходный обзор завершен. Если после
 финального результата его фоновый процесс все еще активен, останови этот
 простаивающий процесс; работающий обзор с прогрессом не останавливай. Продолжи
@@ -24,6 +24,30 @@
 частью истории. Архив открывай для конкретного случая, нужного доказательства
 или проверки происхождения правила.

+## Наблюдение 2026-09-06
+
+В работе над лабораторной по сессиям Luna вела Git-механику и возвращала
+короткие итоги. Полные исследовательские материалы и отчеты при этом часто
+попадали координатору; он наблюдал перегрузку своего контекста. Измеренной
+экономии этот прогон не дал.
+
+Для следующего поручения владелец выбрал для Luna `high` ([комментарий
+#2845](https://git.dementev.space/ddmitry/clickstream-data-platform/issues/236#issuecomment-2845)).
+Это было предпочтение и эксперимент без сравнения с `medium`. При обсуждении
+сопровождения Opus координатор признал свой выбор `high` избыточным для этой
+механики.
+
+Прямой обмен полным отчетом уже состоялся: исполнитель получил файл с девятью
+находками и разобрал их все, а в первоначальную сводку координатора вошли семь.
+Это зафиксировано в [комментарии #2840 к задаче
+#236](https://git.dementev.space/ddmitry/clickstream-data-platform/issues/236#issuecomment-2840).
+Случай подтверждает канал передачи, но не измеряет экономию контекста.
+
+Первый обзор Opus шел в свежей сессии, а исправления проверялись в продолжении
+той же сессии. Устойчивые идентификаторы находок сохранили предмет разговора.
+Это подтверждает действующий [договор перепроверки](review-and-triage.md#перепроверка),
+но не доказывает пользу фиксированной частоты наблюдения за Claude.
+
 ## Проверить на обычных задачах

 - Удерживает ли координатор полезный объем контекста: какие подробности нужны
@@ -35,6 +59,9 @@
 - Помогает ли триаж исполнителю сохранять соразмерность исправлений после
  нескольких кругов ревью? Нужны случаи с основаниями принятых и отклоненных
  находок.
+- Снижает ли помощник для Claude расход контекста, если проверяет состояние
+  примерно раз в минуту и сообщает координатору только о существенных
+  событиях? Измеренного эффекта пока нет.

 Эти вопросы уточнены 2026-09-06 для новой редакции. Наблюдай их там, где
 обычная задача дает материал; отдельные сравнительные прогоны требуют
@@ -95,6 +95,12 @@ FINDING PREFIX: unique stable prefix
 REPORT: unique absolute path
 ```

+Для внешнего канала после уже полученного разрешения добавь точную границу:
+
+```text
+TRANSFER: <exact materials and channel already authorized by the user>
+```
+
 Передай пути к этим параметрам, [мандату ревьюера](prompts/review-boilerplate.md)
 и [правилу языка](prompts/runtime-language.md) либо механически собери из них
 полное поручение.
@@ -10,15 +10,20 @@
  спорные вопросы и принимает результат. Это роль ведущего текущей задачи.
 - **Sol или Terra** обычно реализует задачу, исследует техническую
  неопределенность, проверяет код и исправляет подтвержденные дефекты.
- **Luna** удобна для ясной механики, пакетных операций и известных проверок
-  с объемным выводом.
+- **Помощник** удерживает механику и объемный вывод вне контекста координатора.
+- **Luna** - обычный выбор для такой помощи. Она может просмотреть задачи,
+  комментарии и историю Git, сверить фактическое состояние и подтвержденные
+  чекбоксы. Ей также подходят журналы, трассы, вывод тестов, планы запросов и
+  сопровождение внешнего ревьюера. Если это разрешено, ей можно поручить
+  коммиты, отправку ветки и уборку.

 Эти назначения служат отправной точкой. Состав собирай под задачу; один агент
 может совмещать совместимую работу. Выбор определяется вкладом в задачу и
 качеством доступных моделей. Название роли вторично.

-Свежая Astra полезна для отдельной проверки формы и соразмерности, когда
-цена такого взгляда оправдана.
+Свежая Astra полезна для отдельной проверки формы и соразмерности. Claude Opus
+добавляет независимый взгляд другого семейства. Основания выбора задает
+[основная оптика](../SKILL.md).

 Если партнер поручил группу связанных тикетов, выбирай готовые к работе по
 их существующим зависимостям. Перед выдачей зависимого тикета убедись, что
@@ -27,11 +32,14 @@
 ## Модель и глубина

 Модель и глубину рассуждения выбирай независимо, если среда открывает обе
-ручки. Для ограниченной работы разумная отправная точка - `medium`. Для
-необратимого решения, высокой цены тихой ошибки или существенной
-неопределенности - `high` либо более сильная доступная настройка. Это примеры:
-повышай глубину, когда не хватило поиска и рассуждения, а модель - когда не
-хватило качества суждения.
+ручки. Для Luna `medium` часто удобен как стартовый вариант. Можно сразу
+выбрать `high` по сложности, цене ошибки или предпочтению пользователя.
+
+Для любой роли существенная неопределенность, необратимое решение или высокая
+цена тихой ошибки могут обосновать `high` либо более сильную доступную
+настройку. Повышай глубину, когда не хватило поиска и рассуждения, а модель -
+когда не хватило качества суждения. Основание должно следовать из задачи, а не
+из названия роли.

 Не обещай, что запрошенная модель или глубина фактически применились, если
 инструмент подтверждает лишь принятие параметра. Опирайся на метаданные запуска,