diff --git a/.claude/skills/docs-delegate/SKILL.md b/.claude/skills/docs-delegate/SKILL.md new file mode 100644 index 0000000..522f600 --- /dev/null +++ b/.claude/skills/docs-delegate/SKILL.md @@ -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».