Claude Code Benutzerdefinierte Slash-Befehle
Skills sind der Erweiterungsmechanismus für Claude Code, durch benutzerdefinierte Slash-Befehle (z. B.,/deploy、/explain-code), um Claudes Fähigkeiten zu erweitern.
Jeder benutzerdefinierte Befehl ist im Wesentlichen eine unabhängige Skill-Datei, die komplexe Workflows, Projektkonventionen und gängige Operationen kapseln kann, sodass Sie ihn in jeder Sitzung schnell aufrufen können.
Benutzerdefinierte Befehle wurden in das Skills-System integriert — zu finden unter.claude/commands/deploy.mddie Befehlsdateien und zu finden unter.claude/skills/deploy/SKILL.mddie Skill-Dateien werden alle erstellt/deployBefehle, die auf dieselbe Weise funktionieren.
Im Wesentlichen,.claude/commands/ist die Kurzform von Skills, und die beiden Verzeichnisstrukturen sind vollständig äquivalent.
Warum benutzerdefinierte Slash-Befehle verwenden
Der Kernwert benutzerdefinierter Slash-Befehle liegt inStandardisierung + Wiederverwendung:
- Workflows kodifizieren: Häufige mehrstufige Vorgänge (wie "Bereitstellung in der Produktion") in einen einzigen Befehl kapseln
- Teamkonsistenz sicherstellen: Projektkonventionen (wie "Code-Review-Checkliste") in Befehle kodifizieren, um sicherzustellen, dass Teammitglieder dieselben Standards einhalten
- Kognitive Belastung reduzieren: Kein Auswendiglernen komplexer Befehlskombinationen nötig; ein einziger Satz kann den kompletten Workflow auslösen
- Wiederholte Eingaben reduzieren: Hochfrequente Aufgaben werden von mehrstufigen Vorgängen zu einem einzigen Aufruf
Die Erfahrung des internen Teams von Anthropic ist: Aufgaben, die mehr als zweimal am Tag ausgeführt werden, sollten in Skills umgewandelt werden. Einmal richtig eingerichtet, funktioniert es immer weiter.
Dateistruktur
Jeder Skill ist ein Verzeichnis, das eine erforderlicheSKILL.mdDatei:
my-skill/
├── SKILL.md # 主指令文件(必需)
├── template.md # Claude 填充的模板
├── examples/
│ └── sample.md # 展示预期格式的示例
└── scripts/
└── validate.sh # Claude 可以执行的脚本
Das Dateiformat besteht aus zwei Teilen:
- YAML-Frontmatter(befindet sich
---zwischen den Trennzeichen): wird zum Konfigurieren von Metadaten verwendet - Markdown-Textkörper: die Anweisungen, die Claude bei Aufruf befolgt
Erstellen Sie Ihren ersten benutzerdefinierten Slash-Befehl
1. Erstellen Sie ein Skill-Verzeichnis
Erstellen Sie das Skill-Verzeichnis an einem geeigneten Ort. Der Speicherort bestimmt den Geltungsbereich des Befehls:
mkdir -p ~/.claude/skills/explain-code # 或者在项目中创建 mkdir -p .claude/skills/explain-code
2. Schreiben Sie die Datei SKILL.md
Erstellen Sie im Verzeichnis eine DateiSKILL.md, die YAML-Frontmatter und Anweisungen enthält:
Beispiel
name: explain-code
description: Erklären Sie Code mit visuellen Diagrammen und Analogien. Wenn Sie erklären, wie Code funktioniert,
eine Codebasis erklären oder wenn ein Benutzer fragt"Wie funktioniert das?"verwenden
---
Wenn du Code erklärst, gib immer Folgendes an:
1- **Beginne mit einer Analogie**: Vergleiche den Code mit alltäglichen Dingen
2- **Zeichne ein Diagramm**: Verwende ASCII-Kunst, um den Ablauf, die Struktur oder die Beziehungen zu zeigen
3- **Gehe den Code Schritt für Schritt durch**: Erkläre Schritt für Schritt, was passiert
4- **Weise auf einen Fallstrick hin**: Was sind die häufigen Fehler oder Missverständnisse?
3. Verwende den benutzerdefinierten Befehl
Rufe ihn direkt in Claude Code auf:
/explain-code src/auth/login.ts
Claude findet automatisch einen Skill, der zur Beschreibung passt, oder du kannst ihn explizit aufrufen.
Konfigurationsfelder erklärt
| Feld | Beschreibung |
|---|---|
name |
Anzeigename; wird zu einem Slash-Befehl (Format: Kleinbuchstaben, Zahlen, Bindestriche, bis zu 64 Zeichen) |
description
|
Skill-Funktion und wann er verwendet werden sollte (Ausfüllen empfohlen; Claudes automatischer Aufruf hängt von diesem Feld ab) |
argument-hint |
Prompt, der während der Autovervollständigung angezeigt wird (z. B.[filename] [format]) |
disable-model-invocation |
Setzen auftruewenn gesetzt, verhindert, dass Claude automatisch aufruft; wird nur wirksam, wenn du es explizit aufrufst |
user-invocable |
Setzen auffalsewenn gesetzt, von/im Menü ausgeblendet; nur Claude kann es aufrufen |
allowed-tools |
Liste der Tools, die Claude ohne Nachfrage verwenden kann |
context |
Setzen aufforkwenn gesetzt, läuft in einem Branch-Subagenten |
agent |
Setcontext: forkder Subagent-Typ, der verwendet wird, wenn gesetzt |
paths |
Liste von Glob-Mustern, die den Dateibereich für die Skill-Aktivierung einschränken |
Aufrufsteuerung
Steuere über Frontmatter, wer den Skill aufrufen kann:
| Konfiguration | Du kannst aufrufen | Claude kann aufrufen |
|---|---|---|
| (Standard) | Ja | Ja |
disable-model-invocation: true |
Ja | nein |
user-invocable: false |
nein | Ja |
Variablensubstitution
Verwende Variablen im Skill-Inhalt, und Claude ersetzt sie automatisch:
| Variable | Beschreibung |
|---|---|
$ARGUMENTS |
Alle beim Aufruf übergebenen Argumente |
$ARGUMENTS[N] |
Zugriff auf einen bestimmten Parameter über einen 0-basierten Index |
$N |
$ARGUMENTS[N]Kurzform für |
${CLAUDE_SESSION_ID} |
Aktuelle Sitzungs-ID |
${CLAUDE_SKILL_DIR} |
Verzeichnis, in dem sich die SKILL.md-Datei des Skills befindet |
Speicherorte für Skills
Skills können an mehreren Orten mit unterschiedlichen Geltungsbereichen gespeichert werden:
| Ort | Pfad | Geltungsbereich |
|---|---|---|
| Enterprise-Ebene | Festgelegt durch verwaltete Einstellungen | Alle Benutzer in der Organisation |
| Persönlich | ~/.claude/skills/<skill-name>/SKILL.md |
Alle Projekte |
| Projekt | .claude/skills/<skill-name>/SKILL.md |
Nur aktuelles Projekt |
| Plugin | <plugin>/skills/<skill-name>/SKILL.md |
Innerhalb des aktivierten Geltungsbereichs des Plugins |
.claude/commands/Dateien darin sind weiterhin gültig und unterstützen dasselbe Frontmatter. Wenn ein Skill und ein Befehl denselben Namen haben, hat der Skill Vorrang.
Erweiterte Beispiele
Beispiel 1: Deployment-Befehl (nur manueller Aufruf)
Beispiel
name: deploy
description: Stelle die Anwendung in der Produktionsumgebung bereit
disable-model-invocation: true
---
Stelle $ARGUMENTS in der Produktionsumgebung bereit:
1. Führe die Testsuite aus
2. Die Anwendung erstellen
3. Zum Bereitstellungsziel pushen
Beispiel 2: Komponentenmigrationsbefehl mit Argumenten
Beispiel
name: migrate-component
description: Eine Komponente von einem Framework zu einem anderen migrieren
---
Migrieren Sie die Komponente $0 von $1 nach $2.
Das gesamte bestehende Verhalten und alle Tests beibehalten.
Verwendung: /migrate-component SearchBar React Vue
Beispiel 3: PR-Zusammenfassungsbefehl mit dynamischem Kontext
Beispiel
name: pr-summary
description: Die Änderungen eines Pull Requests zusammenfassen
context: fork
agent: Explore
allowed-tools: Bash(gh *)
---
## Pull-Request-Kontext
- PR-Diff: !`gh pr diff`
- PR-Kommentare: !`gh pr view --comments`
- Geänderte Dateien: !`gh pr diff --name-only`
## Deine Aufgabe
Diesen Pull-Request zusammenfassen...
Integrierte Slash-Befehle
Claude Code bietet einige integrierte Befehle, die sofort einsatzbereit sind:
| Befehl | Funktion |
|---|---|
/batch <instruction> |
Orchestriere groß angelegte Änderungen in der gesamten Codebasis |
/claude-api |
Lade API-Referenzmaterialien |
/debug [description] |
Debug-Logging aktivieren |
/loop [interval] <prompt> |
Prompts in Intervallen wiederholt ausführen |
/simplify [focus] |
Probleme mit der Codequalität überprüfen |
Best Practices
1. Wie man description schreibt
Die description ist die Grundlage für Claudes automatische Aufrufung, also formuliere sie unbedingt klar:
- Trigger-Zeitpunkt klären:
Call when the user requests review / analysis / inspection of code quality - Vorbedingungen angeben:
Use after the specification document has been confirmed - Klare Grenzen ziehen: Fälle, in denen es nicht aufgerufen werden sollte
2. Single-Responsibility-Prinzip
Jeder Skill sollte nur eine Sache tun, mit klaren Ein- und Ausgaben:
/deploy: nur für die Bereitstellung zuständig/test: nur für die Ausführung von Tests zuständig/review: nur für Code-Reviews zuständig
3. Aufrufberechtigungen nach Bedarf festlegen
- Gefährliche Vorgänge (deploy, delete): Einstellungen
disable-model-invocation: true - Claude-Hilfsaufgaben: Einstellungen
user-invocable: false - Allgemeiner Arbeitsablauf: Standardkonfiguration verwenden
4. allowed-tools verwenden, um Berechtigungen einzuschränken
Minimale Berechtigungen für sicherheitskritische Vorgänge festlegen:
Beispiel
name: read-only-analyzer
description: Schreibgeschützte Codeanalyse zum Überprüfen und Verstehen von Code
allowed-tools: Read, Grep, Glob, Bash(gh *) # Nur diese Tools zulassen
---
Schreibgeschützte Codeanalyse ausführen...
Team-Sharing-Strategie
Projektweite Skills in Git committen, um sie im Team zu teilen:
my-project/ ├── .claude/ │ ├── skills/ │ │ ├── deploy/ │ │ │ └── SKILL.md │ │ ├── test/ │ │ │ └── SKILL.md │ │ └── review/ │ │ └── SKILL.md │ └── commands/ # 也可以用 commands/ 目录 └── CLAUDE.md
Projektspezifische Skills in CLAUDE.md referenzieren und erläutern:
## 自定义斜杠命令 本项目提供以下自定义斜杠命令: - `/deploy [env]` — 部署到指定环境(dev/staging/prod) - `/test [module]` — 运行测试套件或指定模块 - `/review` — 执行标准代码审查 详细使用说明请参考 @.claude/skills/README.md
FAQ
F: Was ist der Unterschied zwischen Skills und dem commands-Verzeichnis?
Im Wesentlichen kein Unterschied..claude/commands/Ja.claude/skills/Kurzform, beide Formate funktionieren einwandfrei. Wenn sie denselben Namen haben, haben Skills Vorrang.
F: Wie übergebe ich mehrere Parameter beim Aufruf?
Verwenden Sie Anführungszeichen, um mehrere Parameter einzuschließen:/migrate SearchBar "from:React to:Vue", dann verwenden Sie es im Skill$ARGUMENTSum die vollständige Zeichenkette zu erhalten.
F: Können Skills in Sub-Agenten verwendet werden?
Ja. Durch Festlegen descontext: forkundagentFeldes können Sub-Agenten Skills in einem unabhängigen Kontext ausführen.
F: Wie bringe ich Claude dazu, sich häufig verwendete Fähigkeiten zu merken?
Listen Sie alle verfügbaren benutzerdefinierten Befehle und ihre Anwendungsszenarien in CLAUDE.md auf, und Claude ordnet automatisch die passende Fähigkeit anhand der Beschreibungen zu.
Weitere Erweiterungen