@

chore: добавить навык docs-delegate в репозиторий Навык делегирует обновление документации субагенту Sonnet. В таблицу файлов добавлены docs/presentation.html (синхронизировать всегда) и CLAUDE.md — закрыт пробел: ранее навык не упоминал презентацию, которую нужно держать актуальной. .claude/settings.local.json остаётся в .gitignore. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com> @
2026-05-26 10:52:40 +03:00
parent 7087c4fd53
commit 9003b7d529
1 changed files with 89 additions and 0 deletions
@@ -0,0 +1,89 @@
+---
+name: docs-delegate
+description: >
+  Делегирует обновление документации субагенту на модели Sonnet.
+  Используй ВСЕГДА, когда нужно синхронизировать README.md или docs/*.md
+  (ARCHITECTURE, OPEN_QUESTIONS) с изменениями в коде — не делай это сам,
+  передавай Sonnet. Триггер: «обнови доки», «синхронизируй документацию»,
+  «пусть Sonnet обновит README/ARCHITECTURE», «задокументируй изменения».
+---
+
+# docs-delegate — делегирование документации Sonnet
+
+Этот навык позволяет Opus (основной модели) не тратить контекст на рутинное
+обновление документации: нужно только описать, что изменилось, — Sonnet
+сделает остальное.
+
+## Шаги выполнения
+
+### 1. Составь сводку изменений
+
+Перед вызовом агента сформируй краткий список:
+- Что добавлено (новые инструменты, классы, функции)
+- Что изменилось (переименования, рефакторинг, изменение поведения)
+- Что удалено или устарело
+- Какие вопросы из OPEN_QUESTIONS теперь закрыты
+
+### 2. Запусти Agent с моделью Sonnet
+
+Используй инструмент `Agent` со следующими параметрами:
+
+```
+subagent_type: "general-purpose"
+model: "sonnet"
+description: "Обновление документации: <одна строка что изменилось>"
+prompt: <см. шаблон ниже>
+```
+
+### 3. Шаблон промпта для Sonnet
+
+Заполни `<СВОДКА_ИЗМЕНЕНИЙ>` и передай Sonnet:
+
+---
+
+Ты — помощник по документации проекта **kompas3d-mcp** (MCP-сервер для
+автоматизации CAD-системы КОМПАС-3D через COM API, .NET 8, C#).
+
+**Задача:** обнови документацию так, чтобы она точно отражала текущее состояние
+проекта. Вот что изменилось:
+
+```
+<СВОДКА_ИЗМЕНЕНИЙ>
+```
+
+**Файлы для обновления** (трогай только те, которых касаются изменения):
+
+| Файл | Что содержит |
+|------|-------------|
+| `docs/presentation.html` | **Презентация проекта — синхронизируй ВСЕГДА.** Счётчики (число инструментов, тестов), бейдж статуса, прогресс-бар, панель инструментов, дорожная карта |
+| `README.md` | Обзор проекта, список возможностей, команды сборки/запуска |
+| `CLAUDE.md` | Гайд для агента: «Current state», ключевые факты реализации, что не сделано |
+| `docs/ARCHITECTURE.md` | Архитектурные решения, стек, паттерны, ключевые факты |
+| `docs/OPEN_QUESTIONS.md` | Нерешённые вопросы и ограничения |
+
+**Правила:**
+
+1. Прочитай каждый файл перед правкой — не угадывай содержимое.
+2. Обновляй только секции, которые реально затронуты изменениями.
+   Не переписывай то, что остаётся актуальным.
+3. Если изменение закрывает вопрос из `OPEN_QUESTIONS.md` — удали его
+   или перенеси в раздел «Решено» (если такой есть).
+4. Сохраняй стиль, структуру и тон существующих документов.
+5. Будь лаконичен: одно предложение вместо абзаца, если смысл не теряется.
+6. Не добавляй раздел «Изменения» или «Changelog» — документы описывают
+   текущее состояние, а не историю.
+
+После правок кратко сообщи, что именно было изменено в каждом файле.
+
+---
+
+## Пример вызова
+
+```
+Запусти docs-delegate со следующей сводкой:
+- Добавлен инструмент get_part_info (масса, объём, материал)
+- QueryTools.cs перенесён в отдельный файл
+- Закрыт вопрос из OPEN_QUESTIONS про get_part_info
+```
+
+Или короче: «обнови доки — добавил get_part_info».