docs(skills): уточнено сопровождение субагентов

- Зачем:
  - сократить лишние обращения к координатору при ожидании ревью и передаче материалов.
- Что:
  - уточнены оценка объема Git и трекерных операций, самостоятельное ожидание и прямой файловый обмен.
  - сохранены предпочтения владельца по отдельному помощнику для Claude и передаче материалов.
  - добавлено предпочтение Opus для независимого ревью с заменой на Astra при недоступности.
- Проверка:
  - проверены локальные ссылки и git diff --check.
  - штатный валидатор до и после правок отклоняет существующий ключ disable-model-invocation; режим вызова сохранен.
This commit is contained in:
ddadmin committed 2026-09-06 15:38:38 -04:00
1 parent cbdbedb53c
commit 8fe848a65d
4 files changed
+41 -19

No files matched your search

@@ -38,6 +38,11 @@ description: "Оптика координатора: делегирование,
Короткую команду выполни сам. Помощник нужен, когда работа оставит много Короткую команду выполни сам. Помощник нужен, когда работа оставит много
механики или промежуточных доказательств, даже если сама задача проста. механики или промежуточных доказательств, даже если сама задача проста.
Оценивай всю связанную подзадачу: операции с Git и трекером часто требуют
сверки веток, задач и комментариев и дают много промежуточного вывода.
Такую работу полезно поручить помощнику целиком, даже если каждый
отдельный вызов короткий.
Перед созданием агента посмотри, у кого из существующих уже есть полезное Перед созданием агента посмотри, у кого из существующих уже есть полезное
понимание этой области. Соседнюю задачу можно передать ему, обновив цель, понимание этой области. Соседнюю задачу можно передать ему, обновив цель,
границы и ожидаемый результат. Свежий агент полезен, когда прежние границы и ожидаемый результат. Свежий агент полезен, когда прежние
@@ -14,11 +14,11 @@ Claude - необязательная линия; нативный процес
с этим режимом. Внешняя песочница только для чтения обедняет проверку; исходники с этим режимом. Внешняя песочница только для чтения обедняет проверку; исходники
и постоянное состояние защищает [мандат ревьюера](prompts/review-boilerplate.md). и постоянное состояние защищает [мандат ревьюера](prompts/review-boilerplate.md).
Запуск `claude` передает поручение и выбранные материалы внешнему сервису Запуск `claude` передает поручение и выбранные материалы внешнему сервису
Anthropic. Для своей личной конфигурации Дмитрий дал постоянное разрешение Anthropic.
передавать через CLI Claude материалы текущей задачи для ревью: diff, фрагменты Это согласовано с автором скилла, и согласуется с наличием агента на компьютере (его использование
кода, отчеты ревью и разбора находок. При переносе скилла другому владельцу это невозможно без передачи в Antropic анализируемых материалов, аналогично как использование Кодекс
не становится его согласием. Фактически действующее разрешение передай точной невозможно без передачи в OpenAI)
границей в поле `TRANSFER` из Фактически действующее разрешение передай точной границей в поле `TRANSFER` из
[шаблона поручения](prompt-templates.md#независимое-ревью). Повторно спрашивать [шаблона поручения](prompt-templates.md#независимое-ревью). Повторно спрашивать
о том же канале и тех же материалах не нужно. Посторонние материалы и другие о том же канале и тех же материалах не нужно. Посторонние материалы и другие
внешние действия отдельно сверяй с действующими разрешениями. При реальной внешние действия отдельно сверяй с действующими разрешениями. При реальной
@@ -52,17 +52,28 @@ claude --permission-mode auto --model opus --effort <level> --bg "<mandate>"
путем. Шумный поток CLI сохрани во временном журнале; координатору верни путем. Шумный поток CLI сохрани во временном журнале; координатору верни
ограниченный индекс и путь к отчету. ограниченный индекс и путь к отчету.
Для долгой внешней линии предпочтительно выделить отдельную Luna с `high`. Для внешней линии предпочтительно выделить отдельную Luna с `high`. Так удобнее
для контроля со стороны партнера и для текущих механик - не блокирует другие фоновые работы.
Она запускает ревью, следит за ходом работы, получает отчет и готовит краткие Она запускает ревью, следит за ходом работы, получает отчет и готовит краткие
итоги. Для перепроверок продолжает сохраненную сессию до завершения линии. итоги. Для перепроверок продолжает сохраненную сессию до завершения линии.
Храни у нее идентификатор сессии и пути к промпту, журналу и отчету. Другой помощник остается свободен для Git, механики и параллельной Храни у нее идентификатор сессии и пути к промпту, журналу и отчету. Другой помощник остается свободен для Git, механики и параллельной
работы. Партнеру понятно, кто ведет обзор и какого результата ждать. Короткий работы. Партнеру понятно, кто ведет обзор и какого результата ждать. Короткий
обзор не требует отдельного агента. обзор не требует отдельного агента.
Основной канал наблюдения - события среды. В долгой тишине Luna может Поручай помощнику сопровождение до готового отчета или сбоя, требующего
проверять состояние примерно раз в минуту и сообщать координатору о завершении, решения. Он самостоятельно организует ожидание и продолжает работу после
застое, ошибке или нужном решении. Для прямого опроса координатором без новых обычных промежуточных состояний. Основной канал наблюдения - события среды;
событий ориентир - один раз в пять минут. если их нет, повторные проверки примерно раз в минуту выполняются средствами
инструментов, без нового рассуждения модели на каждом интервале. Предел
ожидания одного вызова инструмента не задает частоту опроса. Координатор
получает сообщения о существенных изменениях, завершении и вопросах,
требующих его решения. Запускать каждую следующую проверку ему не приходится.
При назначении назови помощнику исполнителя и пути обмена. Полный отчет
он передает исполнителю файлом, а координатору возвращает вердикт, короткий
индекс находок и вопросы о границах или риске. Разбор находок и новую версию
исполнитель передает помощнику для перепроверки в той же сессии Claude.
Порядок файлового обмена - в [шаблонах поручений](prompt-templates.md#выбор-канала).
Перед узкой перепроверкой убедись, что исходный обзор завершен. Если после Перед узкой перепроверкой убедись, что исходный обзор завершен. Если после
финального результата его фоновый процесс все еще активен, останови этот финального результата его фоновый процесс все еще активен, останови этот
@@ -12,8 +12,10 @@
Для файлового обмена выбери общий временный каталог задачи. Дай каждому Для файлового обмена выбери общий временный каталог задачи. Дай каждому
результату уникальный абсолютный путь с версией артефакта и линией обзора в результату уникальный абсолютный путь с версией артефакта и линией обзора в
имени. Получатель читает исходный файл напрямую; координатор передает путь и имени. Полные отчеты и разбор находок остаются в файлах; сообщения между
короткую цель, не копирует полный материал в новый промпт. участниками передают путь, проверяемую версию и следующий шаг. При назначении
назови отправителя и получателя, чтобы они могли продолжать обмен напрямую.
Координатор получает короткий итог и вопросы, требующие его суждения.
Постоянные английские блоки находятся в [prompts/](prompts/): Постоянные английские блоки находятся в [prompts/](prompts/):
@@ -134,15 +136,16 @@ judge the proposed remedy against those costs and the task's scope.
## Разбор и перепроверка ## Разбор и перепроверка
Исполнитель разбирает реализацию по Исполнитель разбирает реализацию по
[triage-header.md](prompts/triage-header.md). Передай ему пути к подробным [triage-header.md](prompts/triage-header.md). Ревьюер или сопровождающий его
отчетам без изменений, решения координатора и уникальный путь резолюций. помощник передает исполнителю пути к полным отчетам и уникальный путь
резолюций; координатор добавляет свои решения, когда они нужны.
Короткая сводка ревьюера не заменяет исходные доказательства. Короткая сводка ревьюера не заменяет исходные доказательства.
Исходному ревьюеру для узкой перепроверки передай Для узкой перепроверки исполнитель передает исходному ревьюеру напрямую
[recheck-header.md](prompts/recheck-header.md), путь к его исходному отчету, или через его помощника [recheck-header.md](prompts/recheck-header.md),
путь к резолюциям, границу новой версии, нужные проверки и новый уникальный путь к исходному отчету, путь к резолюциям, границу новой версии, нужные
путь отчета. Продолжи тот же тред или сессию: здесь его прежний контекст проверки и новый уникальный путь отчета. Перепроверка продолжается в том же
полезен. треде или сессии: здесь прежний контекст ревьюера полезен.
В каждом файловом варианте агент возвращает короткий индекс и путь. Полный В каждом файловом варианте агент возвращает короткий индекс и путь. Полный
отчет остается доступен следующему владельцу работы без пересказа координатором. отчет остается доступен следующему владельцу работы без пересказа координатором.
@@ -34,6 +34,9 @@
той же линии без изменения версии или нового основания; точечные исправления той же линии без изменения версии или нового основания; точечные исправления
проверяются узко. проверяются узко.
Автор часто предпочитает Opus для независимой проверки корректности кода и соразмерности изменений.
Если же Opus недоступен - тогда его хорошо заменит Astra.
## Мандат и независимость ## Мандат и независимость
Исходный обзор запускается в свежем контексте без истории исполнителя и других Исходный обзор запускается в свежем контексте без истории исполнителя и других