Skills-Auslösemechanismus
Skills werden nicht vom Benutzer "aufgerufen"; Claude entscheidet unabhängig, ob er sie verwendet.
Das Verständnis dieses Auslösemechanismus hilft dir, Skills zu schreiben, die leichter und genauer ausgelöst werden.
Wie der Auslösemechanismus funktioniert
Wenn Claude startet, lädt es denNamenund dieBeschreibung aller verfügbaren Skillsin den Kontext.
Nachdem der Benutzer eine Nachricht gesendet hat, entscheidet Claude: Erfordert diese Aufgabe, dass ich einen Skill konsultiere?
Es gibt nur eine Grundlage für diese Entscheidung:Das description-Feld des Skills。
Der Inhalt von SKILL.md nimmt nicht an der Trigger-Auswertung teil. Erst nachdem Claude entschieden hat, einen Skill zu verwenden, liest es den Inhalt.
Trigger-Ablaufdiagramm
Welche Arten von Aufgaben lösen einen Skill aus
Nicht alle Anfragen, die der Beschreibung entsprechen, lösen einen Skill aus.
Claude hat eine interne Einschätzung:Ist diese Aufgabe komplex genug, dass auf spezialisierte Anweisungen zurückgegriffen werden muss?
| Anfragetyp | Beispiel | Ob der Skill ausgelöst wird | Grund |
|---|---|---|---|
| Einfache einschrittige Aufgabe | "Lies diese PDF" | Wird normalerweise nicht ausgelöst | Wenn Claude es direkt übernimmt, ist das effizienter |
| Komplexe mehrstufige Aufgabe | "Tabellen aus dem PDF extrahieren und in Excel umwandeln" | Wird ausgelöst | Erfordert einen spezialisierten Workflow |
| Fachspezifische Operation | "Drei PDFs zusammenführen und ein Wasserzeichen hinzufügen" | Wird ausgelöst | Beinhaltet eine bestimmte Toolchain |
| Die Ausgabe hat klare Formatanforderungen | "Einen Word-Bericht erstellen, der unserer Unternehmensvorlage entspricht" | Wird ausgelöst | Erfordert bestimmte Formatierungsstandards |
Wenn dein Skill selten ausgelöst wird, liegt das normalerweise daran, dass die Aufgabenbeschreibung zu einfach ist oder die Beschreibung nicht präzise genug ist. Verwende beim Testen komplexe, spezifische Nutzeranfragen.
Strategien zur Auslösung über die Beschreibung
Die Beschreibung ist die einzige Voraussetzung für die Auslösung, und ihre Formulierung bestimmt direkt die Auslösegenauigkeit.
Strategie 1: Konkrete Szenarien auflisten
Schreibe nicht nur "was dieser Skill tut"; schreibe auch "in welchen Situationen er verwendet werden sollte".
# 不推荐：只描述功能 description: 处理 Excel 文件。 # 推荐：描述功能 + 触发场景 description: > 处理 Excel 和 CSV 文件，包括：读取数据、清洗格式、生成图表、 计算统计指标、合并多个表格。当用户提到 Excel、xlsx、CSV, 表格数据、数据清洗、财务报表时，应优先使用此 Skill.
Strategie 2: "Handlungsorientierte" Sprache verwenden
Das Skills-System neigt von Natur aus dazu, nur sparsam auszulösen. Das Hinzufügen handlungsorientierter Sprache zur Beschreibung kann die Auslösehäufigkeit erhöhen.
description: > 生成专业的 PowerPoint 演示文稿。当用户需要制作幻灯片、PPT、演讲稿、 汇报材料时，必须使用此 Skill，即使用户没有明确说"用 pptx 格式"。 只要涉及演示文稿的创建或修改，都应触发此 Skill.
Strategie 3: Schlüsselwörter auflisten
Das Anhängen einer Liste von Trigger-Schlüsselwörtern am Ende der Beschreibung ist eine einfache und wirksame ergänzende Maßnahme.
description: > 代码审查助手，分析代码质量、发现潜在 Bug、给出改进建议。 关键词：code review、代码审查、代码分析、bug 检查、 重构建议、代码质量、静态分析。
Auslösekonflikte: Mehrere Skills passen gleichzeitig
Wenn eine Nutzeranfrage zu mehreren Skills passen könnte, wählt Claude den relevantesten basierend auf dem Grad der Übereinstimmung aus.
Um Konflikte zu vermeiden, halte klare Grenzen zwischen den Beschreibungen verschiedener Skills ein.
| Konfliktszenario | Lösung |
|---|---|
| Zwei Skills behandeln beide PDFs | Unterscheiden Sie in der Beschreibung spezifische Operationen, wie z. B. "PDF-Erstellung" vs. "PDF-Lesen" |
| Überschneidung zwischen einem allgemeinen Skill und einem spezialisierten Skill | In der Beschreibung des spezialisierten Skills explizit Szenarien angeben, die es vom allgemeinen Skill unterscheiden |
| Zwei Skills mit ähnlichen Funktionen | Erwägen Sie, sie zu einem Skill zusammenzuführen und verschiedene Fälle durch interne Verzweigungen zu behandeln |
Die Beschreibung eines Skills sollte seine anwendbaren Szenarien in einer "exklusiven" Weise beschreiben und nicht nur beschreiben, was er "kann". Was er kann ≠ wann er verwendet werden sollte.
Verwenden Sie das Description Optimization Tool, um die Auslösung zu testen
Der skill-creator Skill stellt ein Skript zur Beschreibungsoptimierung bereit, das die Auslösegenauigkeit automatisch bewertet.
Beispiel
# --eval-set: Pfad zur Testfalldatei
# --skill-path: Pfad zum zu optimierenden Skill
# --max-iterations: maximale Anzahl an Iterationen
python -m scripts.run_loop \
--eval-set evals/trigger-eval.json \
--skill-path my-skill/ \
--model claude-sonnet-4-20250514 \
--max-iterations 5 \
--verbose
Das Skript führt automatisch Tests aus, bewertet Punktzahlen, ändert die Beschreibung und gibt das beste Ergebnis aus.
Detaillierte Methoden zur Beschreibungsoptimierung finden Sie in Artikel 24:Tipps zur Optimierung von Skill-Beschreibungen。
Andere Erweiterungen