docs(skills): уточнена работа помощников координатора
- Зачем: - экономить контекст координатора, сохраняя проверяемость внешних ревью и объемных операций. - Что: - описана механика Luna для шумного вывода, необязательного Opus-ревью и коротких отчетов; - уточнены изоляция контекста помощника, жизненный цикл Claude и передача разрешения и отчетов; - добавлены наблюдения прогона и границы для частоты опроса и приема результатов. - Проверка: - git diff --check; - проверены ссылки и настройки навыка; - quick_validate на нормализованной копии без неподдерживаемого валидатором ключа `disable-model-invocation`.
This commit is contained in:
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` либо более сильную доступную
|
||||
настройку. Повышай глубину, когда не хватило поиска и рассуждения, а модель -
|
||||
когда не хватило качества суждения. Основание должно следовать из задачи, а не
|
||||
из названия роли.
|
||||
|
||||
Не обещай, что запрошенная модель или глубина фактически применились, если
|
||||
инструмент подтверждает лишь принятие параметра. Опирайся на метаданные запуска,
|
||||
|
||||
Reference in new issue
Block a user