[[Claude Skills — Гайд|← К оглавлению]] · [[Claude Skills - 01. Основы|← Основы]] --- # Планирование и дизайн ## Начни со сценариев, не с кода Прежде чем что-то писать, сформулируй 2-3 конкретных сценария, которые skill должен закрывать. **Пример хорошо описанного сценария:** > **Сценарий:** Планирование спринта > **Когда срабатывает:** пользователь пишет «помоги спланировать спринт» > **Что происходит:** забирает статус проекта из Linear → анализирует загрузку команды → предлагает приоритизацию → создаёт задачи с нужными метками > **Итог:** полностью спланированный спринт, задачи уже в трекере Ответь себе на четыре вопроса: 1. Какую задачу хочет решить пользователь? 2. Из каких шагов складывается процесс? 3. Какие инструменты понадобятся — встроенные или через MCP? 4. Какую предметную экспертизу стоит зашить в skill? ## Три категории skills ### 1. Генерация документов и ресурсов Для стабильного качественного результата: документы, презентации, дизайны, код. Характерные приёмы: зашитые стайл-гайды, шаблоны для единообразия, чеклисты качества, внешние инструменты не нужны. ### 2. Автоматизация рабочих процессов Для многоэтапных процессов, где важна единая методология, в том числе координация между MCP-серверами. Характерные приёмы: пошаговый процесс с контрольными точками, готовые шаблоны, цикл «сделал — проверил — доработал». ### 3. Усиление MCP-интеграции Добавить слой экспертизы поверх инструментов, которые даёт MCP-сервер. Характерные приёмы: цепочка из нескольких MCP-вызовов в нужном порядке, предметная экспертиза вшита в логику, обработка типичных ошибок MCP. ## Как написать хорошее описание Формула: **[Что делает] + [Когда подключать] + [Ключевые возможности]** ✅ Хорошо — конкретно, с триггерами: > Управляет проектами в Linear: планирование спринтов, создание задач, трекинг статусов. Подключать, когда пользователь упоминает «спринт», «задачи Linear», «планирование проекта» или просит «создать тикеты». ❌ Плохо — абстрактно, без триггеров: > Помогает с проектами. ## Как понять, что skill работает **По цифрам:** - Подключается в 90%+ подходящих запросов - Ни одного сбойного API-вызова за весь процесс **По ощущениям:** - Пользователю не приходится подсказывать Claude, что делать дальше - Результаты воспроизводимы от сессии к сессии - Процесс доходит до конца без ручных правок --- Дальше: [[Claude Skills - 03. Тестирование и итерации|🧪 03. Тестирование и итерации →]] [[Claude Skills — Гайд|← К оглавлению]]