chore: усилить description делегатов — проактивные триггеры

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) <noreply@anthropic.com>
This commit is contained in:
2026-05-27 20:41:48 +03:00
parent 328e89a6e7
commit 1f153e43ab
2 changed files with 26 additions and 15 deletions
+12 -7
View File
@@ -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
---
+14 -8
View File
@@ -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
---