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

@@ -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,20 @@ Anthropic. Сначала примени уже полученное разре
отчета. Для короткого поручения подходит форма:
```text
claude --permission-mode auto --model <model> --effort <level> --bg "<mandate>"
claude --permission-mode auto --model opus --effort <level> --bg "<mandate>"
```
Большой промпт оставь в общем временном каталоге и передай короткий мандат с
путем. Шумный поток CLI сохрани во временном журнале; координатору верни
ограниченный индекс и путь к отчету.
Запуск и наблюдение можно поручить помощнику. Он хранит идентификатор сессии,
пути к промпту, журналу и отчету, а для узкой перепроверки продолжает ту же
сессию. Полный отчет он сохраняет для владельца триажа; координатору сообщает
о старте, завершении, застое, ошибке или нужном решении. Во время долгого
запуска помощник может проверять состояние примерно раз в минуту. Для прямого
опроса координатором без новых событий ориентир - один раз в пять минут.
Перед узкой перепроверкой убедись, что исходный обзор завершен. Если после
финального результата его фоновый процесс все еще активен, останови этот
простаивающий процесс; работающий обзор с прогрессом не останавливай. Продолжи
@@ -24,6 +24,19 @@
частью истории. Архив открывай для конкретного случая, нужного доказательства
или проверки происхождения правила.
## Наблюдение 2026-09-06
В работе над лабораторной по сессиям Luna вела Git-механику и возвращала
короткие итоги. Полные исследовательские материалы и отчеты при этом часто
попадали координатору; он наблюдал перегрузку своего контекста. Измеренной
экономии этот прогон не дал. Общий помощник для журналов Claude и прямой обмен
между ревьюером и исполнителем остаются гипотезами для следующих задач.
Первый обзор Opus шел в свежей сессии, а исправления проверялись в продолжении
той же сессии. Устойчивые идентификаторы находок сохранили предмет разговора.
Это подтверждает действующий [договор перепроверки](review-and-triage.md#перепроверка),
но не доказывает пользу фиксированной частоты наблюдения за Claude.
## Проверить на обычных задачах
- Удерживает ли координатор полезный объем контекста: какие подробности нужны
@@ -35,6 +48,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,15 @@
## Модель и глубина
Модель и глубину рассуждения выбирай независимо, если среда открывает обе
ручки. Для ограниченной работы разумная отправная точка - `medium`. Для
необратимого решения, высокой цены тихой ошибки или существенной
неопределенности - `high` либо более сильная доступная настройка. Это примеры:
повышай глубину, когда не хватило поиска и рассуждения, а модель - когда не
хватило качества суждения.
ручки. Для Luna отправная точка - `medium`. Повышай ее до `high`, только когда
факты текущей задачи показывают, что `medium` не хватит или уже не хватило.
Обязательного повышения для отдельного класса работ нет.
Для любой роли существенная неопределенность, необратимое решение или высокая
цена тихой ошибки могут обосновать `high` либо более сильную доступную
настройку. Повышай глубину, когда не хватило поиска и рассуждения, а модель -
когда не хватило качества суждения. Основание должно следовать из задачи, а не
из названия роли.
Не обещай, что запрошенная модель или глубина фактически применились, если
инструмент подтверждает лишь принятие параметра. Опирайся на метаданные запуска,