[[Claude Skills — Гайд|← К оглавлению]] · [[Claude Skills - 04. Распространение|← Распространение]] --- # Паттерны и решение проблем Эти паттерны выросли из опыта первых пользователей и внутренних команд Anthropic. Не догмы — берите то, что подходит. ## 5 рабочих паттернов ### 1. Последовательный процесс **Когда:** нужно пройти несколько шагов строго по порядку, каждый зависит от предыдущего. ```markdown ### Шаг 1: Создать аккаунт MCP-вызов: create_customer ### Шаг 2: Подключить оплату MCP-вызов: setup_payment_method Ждём: подтверждения платёжного метода ### Шаг 3: Оформить подписку MCP-вызов: create_subscription Параметры: plan_id, customer_id (из шага 1) ``` Чёткий порядок, явные зависимости, проверка на каждом этапе. --- ### 2. Координация нескольких MCP **Когда:** процесс затрагивает несколько разных сервисов. ```markdown ### Фаза 1: Экспорт (Figma MCP) ### Фаза 2: Сохранение (Drive MCP) ### Фаза 3: Постановка задач (Linear MCP) ### Фаза 4: Оповещение (Slack MCP) ``` Чёткое разделение по фазам, передача данных между серверами, единая обработка ошибок. --- ### 3. Итеративная доработка **Когда:** результат становится лучше с каждым проходом. ```markdown ### Черновик → Проверка → Цикл доработки → Финализация ``` Нужны чёткие критерии «хорошо/плохо» и скрипты для автоматической проверки. --- ### 4. Выбор инструмента по ситуации **Когда:** цель одна, но способ зависит от контекста. ```markdown ### Дерево решений - Большие файлы (>10 МБ) → облачное хранилище MCP - Совместные документы → Notion/Docs MCP - Исходный код → GitHub MCP ``` Однозначные критерии выбора, запасной вариант на каждый случай. --- ### 5. Встроенная предметная экспертиза **Когда:** skill несёт в себе знания, которых нет ни в инструментах, ни у пользователя. ```markdown ### До обработки: проверка комплаенса ЕСЛИ пройдена → провести платёж ИНАЧЕ → пометить для ручного ревью ### Аудиторский след: записать все решения ``` Экспертиза зашита в логику, проверка идёт до действия, каждый шаг документируется. --- ## Типичные проблемы и решения ### Skill не загружается **`Could not find SKILL.md`** — файл назван не так. Переименуй ровно в `SKILL.md`, регистр важен. **`Invalid frontmatter`** — косяк в YAML. Проверь, что шапка обрамлена `---` с обеих сторон, кавычки закрыты. **`Invalid skill name`** — в имени пробелы или заглавные буквы. Только `my-cool-skill`. ### Skill не подключается Описание слишком абстрактное? «Помогает с проектами» — Claude такое не зацепит. **Лайфхак:** спроси Claude напрямую: «Когда бы ты подключил skill [имя]?» Он процитирует описание, и сразу будет видно, чего не хватает. ### Skill подключается к чему попало Три способа починить: 1. **Антитриггеры:** «НЕ подключать для простого просмотра данных» 2. **Уточнение:** вместо «Обрабатывает документы» — «Разбирает юридические PDF для ревью контрактов» 3. **Границы:** «Только для онлайн-платежей, не для общих финансовых вопросов» ### MCP-вызовы падают 1. MCP-сервер подключён? Settings → Extensions → Connected 2. Аутентификация в порядке? API-ключи не протухли? 3. MCP работает без skill? Попробуй напрямую: «Используй [Сервис] MCP, покажи мои проекты» 4. Имена инструментов совпадают? Имена регистрозависимы ### Claude игнорирует инструкции - Простыня текста — пиши кратко, детали в `references/` - Главное закопано в середине — критическое всегда наверх - Размытые формулировки — не «проверьте корректность», а конкретная инструкция с примерами - Перегруз skills — проверь, не включено ли 20-50 skills одновременно --- Дальше: [[Claude Skills - 06. Ресурсы|📚 06. Ресурсы и справочники →]] [[Claude Skills — Гайд|← К оглавлению]]