From 8fe848a65df40516a1f8362e0b3eb017c5bd8865 Mon Sep 17 00:00:00 2001 From: Dmitry Dementev Date: Sun, 6 Sep 2026 15:38:38 -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=D0=BE=20=D1=81=D0=BE=D0=BF=D1=80=D0=BE=D0=B2=D0=BE?= =?UTF-8?q?=D0=B6=D0=B4=D0=B5=D0=BD=D0=B8=D0=B5=20=D1=81=D1=83=D0=B1=D0=B0?= =?UTF-8?q?=D0=B3=D0=B5=D0=BD=D1=82=D0=BE=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - сократить лишние обращения к координатору при ожидании ревью и передаче материалов. - Что: - уточнены оценка объема Git и трекерных операций, самостоятельное ожидание и прямой файловый обмен. - сохранены предпочтения владельца по отдельному помощнику для Claude и передаче материалов. - добавлено предпочтение Opus для независимого ревью с заменой на Astra при недоступности. - Проверка: - проверены локальные ссылки и git diff --check. - штатный валидатор до и после правок отклоняет существующий ключ disable-model-invocation; режим вызова сохранен. --- .../skills/codex-subagent-playbook/SKILL.md | 5 +++ .../references/claude.md | 31 +++++++++++++------ .../references/prompt-templates.md | 21 +++++++------ .../references/review-and-triage.md | 3 ++ 4 files changed, 41 insertions(+), 19 deletions(-) diff --git a/agents/.agents/skills/codex-subagent-playbook/SKILL.md b/agents/.agents/skills/codex-subagent-playbook/SKILL.md index aecfbd3..25a61b7 100644 --- a/agents/.agents/skills/codex-subagent-playbook/SKILL.md +++ b/agents/.agents/skills/codex-subagent-playbook/SKILL.md @@ -38,6 +38,11 @@ description: "Оптика координатора: делегирование, Короткую команду выполни сам. Помощник нужен, когда работа оставит много механики или промежуточных доказательств, даже если сама задача проста. +Оценивай всю связанную подзадачу: операции с Git и трекером часто требуют +сверки веток, задач и комментариев и дают много промежуточного вывода. +Такую работу полезно поручить помощнику целиком, даже если каждый +отдельный вызов короткий. + Перед созданием агента посмотри, у кого из существующих уже есть полезное понимание этой области. Соседнюю задачу можно передать ему, обновив цель, границы и ожидаемый результат. Свежий агент полезен, когда прежние diff --git a/agents/.agents/skills/codex-subagent-playbook/references/claude.md b/agents/.agents/skills/codex-subagent-playbook/references/claude.md index c79fce9..2099298 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/claude.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/claude.md @@ -14,11 +14,11 @@ Claude - необязательная линия; нативный процес с этим режимом. Внешняя песочница только для чтения обедняет проверку; исходники и постоянное состояние защищает [мандат ревьюера](prompts/review-boilerplate.md). Запуск `claude` передает поручение и выбранные материалы внешнему сервису -Anthropic. Для своей личной конфигурации Дмитрий дал постоянное разрешение -передавать через CLI Claude материалы текущей задачи для ревью: diff, фрагменты -кода, отчеты ревью и разбора находок. При переносе скилла другому владельцу это -не становится его согласием. Фактически действующее разрешение передай точной -границей в поле `TRANSFER` из +Anthropic. +Это согласовано с автором скилла, и согласуется с наличием агента на компьютере (его использование +невозможно без передачи в Antropic анализируемых материалов, аналогично как использование Кодекс +невозможно без передачи в OpenAI) +Фактически действующее разрешение передай точной границей в поле `TRANSFER` из [шаблона поручения](prompt-templates.md#независимое-ревью). Повторно спрашивать о том же канале и тех же материалах не нужно. Посторонние материалы и другие внешние действия отдельно сверяй с действующими разрешениями. При реальной @@ -52,17 +52,28 @@ claude --permission-mode auto --model opus --effort --bg "" путем. Шумный поток CLI сохрани во временном журнале; координатору верни ограниченный индекс и путь к отчету. -Для долгой внешней линии предпочтительно выделить отдельную Luna с `high`. +Для внешней линии предпочтительно выделить отдельную Luna с `high`. Так удобнее +для контроля со стороны партнера и для текущих механик - не блокирует другие фоновые работы. Она запускает ревью, следит за ходом работы, получает отчет и готовит краткие итоги. Для перепроверок продолжает сохраненную сессию до завершения линии. Храни у нее идентификатор сессии и пути к промпту, журналу и отчету. Другой помощник остается свободен для Git, механики и параллельной работы. Партнеру понятно, кто ведет обзор и какого результата ждать. Короткий обзор не требует отдельного агента. -Основной канал наблюдения - события среды. В долгой тишине Luna может -проверять состояние примерно раз в минуту и сообщать координатору о завершении, -застое, ошибке или нужном решении. Для прямого опроса координатором без новых -событий ориентир - один раз в пять минут. +Поручай помощнику сопровождение до готового отчета или сбоя, требующего +решения. Он самостоятельно организует ожидание и продолжает работу после +обычных промежуточных состояний. Основной канал наблюдения - события среды; +если их нет, повторные проверки примерно раз в минуту выполняются средствами +инструментов, без нового рассуждения модели на каждом интервале. Предел +ожидания одного вызова инструмента не задает частоту опроса. Координатор +получает сообщения о существенных изменениях, завершении и вопросах, +требующих его решения. Запускать каждую следующую проверку ему не приходится. + +При назначении назови помощнику исполнителя и пути обмена. Полный отчет +он передает исполнителю файлом, а координатору возвращает вердикт, короткий +индекс находок и вопросы о границах или риске. Разбор находок и новую версию +исполнитель передает помощнику для перепроверки в той же сессии Claude. +Порядок файлового обмена - в [шаблонах поручений](prompt-templates.md#выбор-канала). Перед узкой перепроверкой убедись, что исходный обзор завершен. Если после финального результата его фоновый процесс все еще активен, останови этот 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 d8719d7..c3f5a26 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md @@ -12,8 +12,10 @@ Для файлового обмена выбери общий временный каталог задачи. Дай каждому результату уникальный абсолютный путь с версией артефакта и линией обзора в -имени. Получатель читает исходный файл напрямую; координатор передает путь и -короткую цель, не копирует полный материал в новый промпт. +имени. Полные отчеты и разбор находок остаются в файлах; сообщения между +участниками передают путь, проверяемую версию и следующий шаг. При назначении +назови отправителя и получателя, чтобы они могли продолжать обмен напрямую. +Координатор получает короткий итог и вопросы, требующие его суждения. Постоянные английские блоки находятся в [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), +путь к исходному отчету, путь к резолюциям, границу новой версии, нужные +проверки и новый уникальный путь отчета. Перепроверка продолжается в том же +треде или сессии: здесь прежний контекст ревьюера полезен. В каждом файловом варианте агент возвращает короткий индекс и путь. Полный отчет остается доступен следующему владельцу работы без пересказа координатором. diff --git a/agents/.agents/skills/codex-subagent-playbook/references/review-and-triage.md b/agents/.agents/skills/codex-subagent-playbook/references/review-and-triage.md index 48ec24e..2beb493 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/review-and-triage.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/review-and-triage.md @@ -34,6 +34,9 @@ той же линии без изменения версии или нового основания; точечные исправления проверяются узко. +Автор часто предпочитает Opus для независимой проверки корректности кода и соразмерности изменений. +Если же Opus недоступен - тогда его хорошо заменит Astra. + ## Мандат и независимость Исходный обзор запускается в свежем контексте без истории исполнителя и других