diff --git a/agents/.agents/skills/codex-subagent-playbook/SKILL.md b/agents/.agents/skills/codex-subagent-playbook/SKILL.md index 4aa4e7a..aecfbd3 100644 --- a/agents/.agents/skills/codex-subagent-playbook/SKILL.md +++ b/agents/.agents/skills/codex-subagent-playbook/SKILL.md @@ -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 добавляет взгляд другого семейства; его ## Достаточно ли сделанного -Сопоставь результат с исходной целью и фактическими проверками. Отчет агента -о тестах или состоянии среды оценивай по доказательствам; ключевое для -приемки проверь доступным тебе способом. Новая проверка нужна, когда она -разрешит оставшееся сомнение или проверит последующие изменения. +Сопоставь результат с исходной целью и фактическими проверками. Сам проверь +важные для приемки утверждения и доказательства доступным способом. Повторять +каждую команду помощника не нужно. Для собственной проверки выбирай адресную +команду или сокращай ее вывод до нужных фактов. Новая проверка оправдана, +когда она разрешает оставшееся сомнение или проверяет последующие изменения. После нескольких исправлений полезен проход на вычитание: какие добавления -все еще оправданы задачей? Решение об удалении принимай по нужному поведению -и стоимости поддержки. Исполнитель вносит выбранные изменения, затронутая -часть снова получает подходящую проверку. +все еще оправданы задачей? Каждое удаление взвешивай по нужному поведению и +стоимости поддержки. Ценность прохода измеряй тем, насколько проще понять +результат и действовать по нему, а не числом удаленных строк. Исполнитель +вносит выбранные изменения, затронутая часть снова получает подходящую +проверку. Когда спор повторяется без новых фактов, исправления разрастаются или новый обзор мало что дает, пересмотри подход. Разбор несходимости находится в diff --git a/agents/.agents/skills/codex-subagent-playbook/references/claude.md b/agents/.agents/skills/codex-subagent-playbook/references/claude.md index 3d13333..b533bbd 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/claude.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/claude.md @@ -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 --effort --bg "" +claude --permission-mode auto --model opus --effort --bg "" ``` Большой промпт оставь в общем временном каталоге и передай короткий мандат с путем. Шумный поток CLI сохрани во временном журнале; координатору верни ограниченный индекс и путь к отчету. +Для долгой внешней линии предпочтительно выделить отдельную Luna. Она отвечает +за запуск, наблюдение, получение отчета и продолжение сохраненной сессии до +завершения линии. Храни у нее идентификатор сессии и пути к промпту, журналу и +отчету. Другой помощник остается свободен для Git, механики и параллельной +работы. Партнеру понятно, кто ведет обзор и какого результата ждать. Короткий +обзор не требует отдельного агента. + +Основной канал наблюдения - события среды. В долгой тишине Luna может +проверять состояние примерно раз в минуту и сообщать координатору о завершении, +застое, ошибке или нужном решении. Для прямого опроса координатором без новых +событий ориентир - один раз в пять минут. + Перед узкой перепроверкой убедись, что исходный обзор завершен. Если после финального результата его фоновый процесс все еще активен, останови этот простаивающий процесс; работающий обзор с прогрессом не останавливай. Продолжи diff --git a/agents/.agents/skills/codex-subagent-playbook/references/lessons.md b/agents/.agents/skills/codex-subagent-playbook/references/lessons.md index 181bd7d..7a3918d 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/lessons.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/lessons.md @@ -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 для новой редакции. Наблюдай их там, где обычная задача дает материал; отдельные сравнительные прогоны требуют diff --git a/agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md b/agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md index d837ab1..d8719d7 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md @@ -95,6 +95,12 @@ FINDING PREFIX: unique stable prefix REPORT: unique absolute path ``` +Для внешнего канала после уже полученного разрешения добавь точную границу: + +```text +TRANSFER: +``` + Передай пути к этим параметрам, [мандату ревьюера](prompts/review-boilerplate.md) и [правилу языка](prompts/runtime-language.md) либо механически собери из них полное поручение. diff --git a/agents/.agents/skills/codex-subagent-playbook/references/roles.md b/agents/.agents/skills/codex-subagent-playbook/references/roles.md index a55ee4b..fe4a2ed 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/roles.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/roles.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` либо более сильную доступную +настройку. Повышай глубину, когда не хватило поиска и рассуждения, а модель - +когда не хватило качества суждения. Основание должно следовать из задачи, а не +из названия роли. Не обещай, что запрошенная модель или глубина фактически применились, если инструмент подтверждает лишь принятие параметра. Опирайся на метаданные запуска,