Механизм срабатывания навыков
Навыки не "вызываются" пользователем; Claude самостоятельно решает, использовать ли их.
Понимание этого механизма срабатывания поможет вам писать навыки, которые легче и точнее срабатывают.
Как работает механизм срабатывания
Когда Claude запускается, он загружает все доступные Навыкиnameиdescriptionв контекст.
После того как пользователь отправляет сообщение, Claude определяет: требует ли эта задача обращения к Навыку?
Есть только одна основа для этого решения:поле description Навыка。
Тело SKILL.md не участвует в оценке срабатывания. Только после того, как Claude решит использовать Навык, он читает содержимое тела.
Диаграмма потока срабатывания
Какие типы задач вызывают срабатывание Навыка
Не все запросы, соответствующие description, вызовут срабатывание Навыка.
У Claude есть внутренняя оценка:Достаточно ли сложна эта задача, чтобы потребовалось обратиться к специализированным инструкциям?
| Тип запроса | Пример | Срабатывает ли Навык | Причина |
|---|---|---|---|
| Простая одношаговая задача | "Прочитай этот PDF" | Обычно не срабатывает | Прямая обработка Claude эффективнее |
| Сложная многоэтапная задача | "Извлечь таблицы из PDF и преобразовать их в Excel" | Срабатывает | Требуется специализированный рабочий процесс |
| Операция в профессиональной области | "Объединить три PDF и добавить водяной знак" | Срабатывает | Включает определённую цепочку инструментов |
| Вывод имеет чёткие требования к формату | "Сгенерировать отчёт Word, соответствующий шаблону нашей компании" | Срабатывает | Требует определённых стандартов форматирования |
Если ваш навык срабатывает редко, обычно это потому, что описание задачи слишком простое или недостаточно точное. При тестировании используйте сложные, конкретные пользовательские запросы.
Стратегии срабатывания описания
Описание — единственный критерий срабатывания, и его формулировка напрямую определяет точность срабатывания.
Стратегия 1: перечислите конкретные сценарии
Не просто пишите «что делает этот навык»; также пишите «в каких ситуациях его следует использовать».
# 不推荐：只描述功能 description: 处理 Excel 文件。 # 推荐：描述功能 + 触发场景 description: > 处理 Excel 和 CSV 文件，包括：读取数据、清洗格式、生成图表、 计算统计指标、合并多个表格。当用户提到 Excel、xlsx、CSV, 表格数据、数据清洗、财务报表时，应优先使用此 Skill.
Стратегия 2: используйте язык, ориентированный на действие
Система навыков естественным образом склонна срабатывать редко. Добавление в описание языка, ориентированного на действие, может повысить частоту срабатывания.
description: > 生成专业的 PowerPoint 演示文稿。当用户需要制作幻灯片、PPT、演讲稿、 汇报材料时，必须使用此 Skill，即使用户没有明确说"用 pptx 格式"。 只要涉及演示文稿的创建或修改，都应触发此 Skill.
Стратегия 3: перечислите ключевые слова
Добавление списка ключевых слов-триггеров в конец описания — простая и эффективная дополнительная мера.
description: > 代码审查助手，分析代码质量、发现潜在 Bug、给出改进建议。 关键词：code review、代码审查、代码分析、bug 检查、 重构建议、代码质量、静态分析。
Конфликты срабатывания: несколько навыков совпадают одновременно
Когда запрос пользователя может соответствовать нескольким навыкам, Claude выбирает наиболее релевантный на основе степени совпадения.
Чтобы избежать конфликтов, сохраняйте чёткие границы между описаниями разных навыков.
| Конфликтный сценарий | Решение |
|---|---|
| Два навыка обрабатывают PDF | Различайте конкретные операции в описании, например "создание PDF" в отличие от "чтения PDF" |
| Пересечение между общим навыком и специализированным навыком | В описании специализированного навыка явно укажите сценарии, которые отличают его от общего навыка |
| Два навыка с похожими функциями | Рассмотрите возможность объединения их в один навык и обработки разных случаев через внутреннее ветвление |
Описание навыка должно описывать его применимые сценарии "взаимоисключающим" образом, а не просто описывать, что он "может делать". Что он может делать ≠ когда его следует использовать.
Используйте инструмент оптимизации описания для проверки срабатывания
Навык skill-creator предоставляет скрипт оптимизации описания, который автоматически оценивает точность срабатывания.
Пример
# --eval-set: путь к файлу тестового примера
# --skill-path: путь к навыку для оптимизации
# --max-iterations: максимальное количество итераций
python -m scripts.run_loop \
--eval-set evals/trigger-eval.json \
--skill-path my-skill/ \
--model claude-sonnet-4-20250514 \
--max-iterations 5 \
--verbose
Скрипт автоматически запускает тесты, оценивает баллы, изменяет описание и выводит лучший результат.
Подробные методы оптимизации описания см. в статье 24:Советы по оптимизации описания навыков。
Другие расширения