From 1f153e43abc0112f7c705ca9f1b0d623d4c63337 Mon Sep 17 00:00:00 2001 From: Shahovalov MIkhail Date: Wed, 27 May 2026 20:41:48 +0300 Subject: [PATCH] =?UTF-8?q?chore:=20=D1=83=D1=81=D0=B8=D0=BB=D0=B8=D1=82?= =?UTF-8?q?=D1=8C=20description=20=D0=B4=D0=B5=D0=BB=D0=B5=D0=B3=D0=B0?= =?UTF-8?q?=D1=82=D0=BE=D0=B2=20=E2=80=94=20=D0=BF=D1=80=D0=BE=D0=B0=D0=BA?= =?UTF-8?q?=D1=82=D0=B8=D0=B2=D0=BD=D1=8B=D0=B5=20=D1=82=D1=80=D0=B8=D0=B3?= =?UTF-8?q?=D0=B3=D0=B5=D1=80=D1=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit kompas-sdk-research и docs-maintainer почти не вызывались (по транскриптам: 2 и 1 раз против 40 у general-purpose). Причина — описания ждали явной реплики пользователя, а в автономном цикле NEXT-SESSION её нет. - Триггеры переписаны на проактивные, от лица Opus, с привязкой к шагу цикла (SDK-лукап — перед кодом; доки — перед коммитом, после реализации). - kompas-sdk-research: «(Sonnet)» → «(Haiku, read-only)» (соответствие model:), снят барьер делегирования (ответ дёшев, перепроверяется рефлексией по interop), добавлены негативные границы (не геометрия, не KsAPI). - docs-maintainer: в охват явно добавлены CLAUDE.md и OPEN_QUESTIONS.md. Co-Authored-By: Claude Opus 4.7 (1M context) --- .claude/agents/docs-maintainer.md | 19 ++++++++++++------- .claude/agents/kompas-sdk-research.md | 22 ++++++++++++++-------- 2 files changed, 26 insertions(+), 15 deletions(-) diff --git a/.claude/agents/docs-maintainer.md b/.claude/agents/docs-maintainer.md index 148121a..fcf3183 100644 --- a/.claude/agents/docs-maintainer.md +++ b/.claude/agents/docs-maintainer.md @@ -1,13 +1,18 @@ --- name: docs-maintainer description: > - Делегируй этому субагенту (Sonnet) синхронизацию документации проекта с - изменениями в коде — README.md, docs/*.md (ARCHITECTURE, OPEN_QUESTIONS), - docs/presentation.html. Используй ВСЕГДА, когда нужно отразить в доках новые - инструменты/классы/функции, переименования, удаления или закрытые вопросы - OPEN_QUESTIONS — не делай это сам, передавай сводку изменений этому субагенту. - Триггеры: «обнови доки», «синхронизируй документацию», «задокументируй - изменения», «обнови README/ARCHITECTURE». + ОБЯЗАТЕЛЬНО делегируй этому субагенту (Sonnet) ВСЮ синхронизацию документации + проекта с кодом — README.md, CLAUDE.md, docs/ARCHITECTURE.md, + docs/OPEN_QUESTIONS.md, docs/presentation.html — НЕ правь эти файлы сам. + Срабатывает ПРОАКТИВНО как обязательный шаг рабочего цикла, а НЕ по явной команде: + как только фича реализована и протестирована, ПЕРЕД коммитом доков передай ему + сводку изменений (новые/переименованные/удалённые инструменты, классы, факты + реализации, закрытые вопросы OPEN_QUESTIONS, новые счётчики инструментов/тестов + для presentation.html). Не жди реплики «обнови доки» — делегируй сам после каждой + завершённой единицы работы. Триггеры (включая ТВОИ внутренние): «фича готова, надо + отразить в доках», «обнови README/ARCHITECTURE/CLAUDE.md/presentation», + «закрыт вопрос в OPEN_QUESTIONS», «синхронизируй документацию», «задокументируй + изменения». Передавай сводку текстом — код/тесты он сам не запускает (Bash нет). tools: Read, Edit, Write, Glob, Grep model: sonnet --- diff --git a/.claude/agents/kompas-sdk-research.md b/.claude/agents/kompas-sdk-research.md index 57940cf..20b9aa2 100644 --- a/.claude/agents/kompas-sdk-research.md +++ b/.claude/agents/kompas-sdk-research.md @@ -1,14 +1,20 @@ --- name: kompas-sdk-research description: > - Делегируй этому субагенту (Sonnet) поиск и чтение справки КОМПАС SDK. - Источник — структурированная MD-база знаний docs/Kompas3D_SDK/ (статьи по - интерфейсам с YAML-тегами, ищется обычным Grep/Read). Используй ВСЕГДА, когда - нужно найти интерфейс/метод/константу COM API КОМПАС, его сигнатуру - (Automation/COM), значения перечисления, единицы измерения или паттерн - использования — не рой справку сам, передавай этому субагенту и получай - готовую выжимку. Триггеры: «найди в справке КОМПАС», «какая сигнатура у…», - «какие значения enum…», «как через API КОМПАС сделать…», «что возвращает <метод>». + ОБЯЗАТЕЛЬНО делегируй этому субагенту (Haiku, read-only) ЛЮБОЙ поиск по справке + COM API КОМПАС в MD-базе docs/Kompas3D_SDK/ — НЕ грепай справку сам. Срабатывает + ПРОАКТИВНО, без явной просьбы пользователя: как только при планировании или + реализации фичи тебе понадобилась сигнатура метода (Automation/COM), значения + перечисления (Obj3dType, ksHoleTypeEnum, ST_MIX_*, стили линий…), нужный + интерфейс под задачу («чем/каким интерфейсом построить X»), единицы измерения + или цепочка вызовов — СНАЧАЛА спроси этого субагента, ПОТОМ пиши код. Это дёшево: + ответ Haiku ты всё равно перепроверяешь рефлексией по libs/kompas-interop/*.dll, + поэтому ошибка стоит мало, а сэкономленный контекст Opus — много. Триггеры (в т.ч. + ТВОИ внутренние, не только реплики пользователя): «нужна сигнатура …», + «какие значения enum …», «каким интерфейсом сделать X через API КОМПАС», + «что возвращает <метод>», «как через COM API построить …», «найди в справке КОМПАС». + НЕ для построения геометрии в КОМПАС (это MCP-инструменты / навык kompas-3d) и + НЕ для KsAPI (Qt/C++ — в MD-базе его нет). tools: Glob, Grep, Read model: haiku ---