From cd867fcc1ff57f7cdad09ca99350f38fe780fb32 Mon Sep 17 00:00:00 2001 From: Dmitry Dementev Date: Sun, 6 Sep 2026 13:55:28 -0400 Subject: [PATCH] =?UTF-8?q?docs(skills):=20=D1=83=D1=82=D0=BE=D1=87=D0=BD?= =?UTF-8?q?=D0=B5=D0=BD=D1=8B=20=D0=B2=D1=8B=D0=B1=D0=BE=D1=80=20Luna=20?= =?UTF-8?q?=D0=B8=20=D1=81=D0=BE=D0=BF=D1=80=D0=BE=D0=B2=D0=BE=D0=B6=D0=B4?= =?UTF-8?q?=D0=B5=D0=BD=D0=B8=D0=B5=20=D1=80=D0=B5=D0=B2=D1=8C=D1=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - связать выбор помощника и глубины с фактической ценой ошибки и сохранять контекст координатора. - Что: - уточнен свободный выбор `high` для Luna и выделение отдельного помощника для долгой линии Claude; - описаны события наблюдения, необязательный минутный опрос и прозрачная передача результата; - добавлены подтвержденные факты прямой передачи девяти находок и предпочтения Luna `high`. - Проверка: - `git diff --check`; - проверены только три разрешенных файла и ссылки на комментарии #236:2840 и #236:2845; - ранее пройдены адресные проверки и нормализованный `quick_validate`. --- .../references/claude.md | 17 +++++++++++------ .../references/lessons.md | 17 ++++++++++++++--- .../codex-subagent-playbook/references/roles.md | 5 ++--- 3 files changed, 27 insertions(+), 12 deletions(-) diff --git a/agents/.agents/skills/codex-subagent-playbook/references/claude.md b/agents/.agents/skills/codex-subagent-playbook/references/claude.md index 00d7d3c..b533bbd 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/claude.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/claude.md @@ -52,12 +52,17 @@ 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 149c7a5..7a3918d 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/lessons.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/lessons.md @@ -29,8 +29,19 @@ В работе над лабораторной по сессиям Luna вела Git-механику и возвращала короткие итоги. Полные исследовательские материалы и отчеты при этом часто попадали координатору; он наблюдал перегрузку своего контекста. Измеренной -экономии этот прогон не дал. Общий помощник для журналов Claude и прямой обмен -между ревьюером и исполнителем остаются гипотезами для следующих задач. +экономии этот прогон не дал. + +Для следующего поручения владелец выбрал для 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 шел в свежей сессии, а исправления проверялись в продолжении той же сессии. Устойчивые идентификаторы находок сохранили предмет разговора. @@ -50,7 +61,7 @@ находок. - Снижает ли помощник для Claude расход контекста, если проверяет состояние примерно раз в минуту и сообщает координатору только о существенных - событиях? Эта механика пока не проверена отдельным прогоном. + событиях? Измеренного эффекта пока нет. Эти вопросы уточнены 2026-09-06 для новой редакции. Наблюдай их там, где обычная задача дает материал; отдельные сравнительные прогоны требуют diff --git a/agents/.agents/skills/codex-subagent-playbook/references/roles.md b/agents/.agents/skills/codex-subagent-playbook/references/roles.md index 6be76f5..fe4a2ed 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/roles.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/roles.md @@ -32,9 +32,8 @@ ## Модель и глубина Модель и глубину рассуждения выбирай независимо, если среда открывает обе -ручки. Для Luna отправная точка - `medium`. Повышай ее до `high`, только когда -факты текущей задачи показывают, что `medium` не хватит или уже не хватило. -Обязательного повышения для отдельного класса работ нет. +ручки. Для Luna `medium` часто удобен как стартовый вариант. Можно сразу +выбрать `high` по сложности, цене ошибки или предпочтению пользователя. Для любой роли существенная неопределенность, необратимое решение или высокая цена тихой ошибки могут обосновать `high` либо более сильную доступную