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
@@ -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 добавляет взгляд другого семейства; его
|
||||
|
||||
## Достаточно ли сделанного
|
||||
|
||||
Сопоставь результат с исходной целью и фактическими проверками. Отчет агента
|
||||
о тестах или состоянии среды оценивай по доказательствам; ключевое для
|
||||
приемки проверь доступным тебе способом. Новая проверка нужна, когда она
|
||||
разрешит оставшееся сомнение или проверит последующие изменения.
|
||||
Сопоставь результат с исходной целью и фактическими проверками. Сам проверь
|
||||
важные для приемки утверждения и доказательства доступным способом. Повторять
|
||||
каждую команду помощника не нужно. Для собственной проверки выбирай адресную
|
||||
команду или сокращай ее вывод до нужных фактов. Новая проверка оправдана,
|
||||
когда она разрешает оставшееся сомнение или проверяет последующие изменения.
|
||||
|
||||
После нескольких исправлений полезен проход на вычитание: какие добавления
|
||||
все еще оправданы задачей? Решение об удалении принимай по нужному поведению
|
||||
и стоимости поддержки. Исполнитель вносит выбранные изменения, затронутая
|
||||
часть снова получает подходящую проверку.
|
||||
все еще оправданы задачей? Каждое удаление взвешивай по нужному поведению и
|
||||
стоимости поддержки. Ценность прохода измеряй тем, насколько проще понять
|
||||
результат и действовать по нему, а не числом удаленных строк. Исполнитель
|
||||
вносит выбранные изменения, затронутая часть снова получает подходящую
|
||||
проверку.
|
||||
|
||||
Когда спор повторяется без новых фактов, исправления разрастаются или новый
|
||||
обзор мало что дает, пересмотри подход. Разбор несходимости находится в
|
||||
|
||||
Reference in new issue
Block a user