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): Einstellungendisable-model-invocation: true
  • Claude-Hilfsaufgaben: Einstellungenuser-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