Zum Hauptinhalt springen

Eigene Slash-Befehle

Fortgeschritten

Ein eigener Slash-Befehl verpackt einen Prompt, den du immer wieder neu eintippst, in ein einziges /wort. Einmal definieren, für immer wiederverwenden (und mit deinem Team teilen).

What you'll learn
  • Eigene Befehle sind in Skills aufgegangen. Eine Datei unter .claude/commands/deploy.md und ein Skill unter .claude/skills/deploy/SKILL.md erzeugen beide /deploy und funktionieren gleich — deine bestehenden .claude/commands/-Dateien laufen weiter. Skills ergänzen ein Verzeichnis für Zusatzdateien, Frontmatter zur Aufruf-Steuerung und automatisches Laden bei Relevanz. Für alles jenseits eines Einzeldatei-Prompts nimm einen Skill.
What you'll learn
  • Erklären, was ein eigener Slash-Befehl ist und warum er besser ist als das erneute Eintippen eines Prompts
  • Einen Befehl erstellen, indem du eine Markdown-Datei im richtigen Verzeichnis ablegst
  • Projekt-Befehle von persönlichen Befehlen anhand ihres Speicherorts unterscheiden
  • Die Bausteine nutzen: $ARGUMENTS, eingebettete Bash-Ausgabe, Dateiverweise und Frontmatter
  • Für eine gegebene Aufgabe zwischen Slash-Befehl, Skill und Subagent wählen

Wie sie funktionieren

Ein Befehl ist einfach eine Markdown-Datei. Lege sie in deinem Befehlsverzeichnis ab, und ihr Dateiname wird zum Befehl. Der Inhalt der Datei ist der Prompt, den Claude ausführt, wenn du sie aufrufst.

Der Speicherort der Datei bestimmt ihren Gültigkeitsbereich:

Guided walkthrough1 of 3
  1. Speichere ihn unter .claude/commands/changelog.md → /changelog. Er liegt im Repo, also bekommt ihn das gesamte Team.
Pro tip
  • Der Dateiname — nicht das Frontmatter — wird zum Befehlsnamen. changelog.md ist immer /changelog.

Ein minimales Beispiel

Hier ist eine vollständige Befehlsdatei. Das Frontmatter enthält die description; alles darunter ist der Prompt.

commit.md — einen Conventional Commit entwerfen

---
description: Draft a Conventional Commit message from the staged diff
---

Look at the staged changes with `git diff --cached` and write a single
Conventional Commit message (feat/fix/docs/refactor/chore). Output only the
message, no preamble.

Speichere das als commit.md, und /commit erledigt es jedes Mal. (Nenne es so wie die Datei — derselbe Inhalt als changelog.md gespeichert wäre /changelog.)

Die nützlichen Bausteine

Vier Zutaten machen aus einem statischen Prompt einen flexiblen Befehl:

BausteinWas er tut
$ARGUMENTSFügt ein, was der Nutzer nach dem Befehl eingetippt hat. /review src/auth.ts → der Pfad landet in deinem Prompt.
Bash ausführen und Ausgabe einbettenBefehle können Shell-Ausgabe enthalten (z. B. das aktuelle Diff), damit Claude auf dem aktuellen Stand handelt.
Dateien referenzierenVerweise auf Dateien, um deren Inhalt einzubinden.
Frontmatterdescription (im Menü angezeigt) und weitere Optionen.

Die genaue Syntax für Argumente, Bash und Dateiverweise findest du in der offiziellen Dokumentation.

Befehle, die es wert sind, übernommen zu werden

Ein Starter-Set findest du in unserer Slash-Befehl-Bibliothek: Commit-Nachricht, PR-Beschreibung, Code-Review, Changelog, Komponente scaffolden.

Befehl vs. Skill vs. Subagent

Drei Wege, Arbeit zu verpacken — der Unterschied liegt darin, wer sie auslöst und wie isoliert sie läuft:

  • Slash-Befehldu löst einen bekannten Arbeitsablauf bei Bedarf aus.
  • Skill — Claude lädt Expertise automatisch, wenn sie relevant ist.
  • Subagent — delegiere einen Teil der Arbeit an einen isolierten Agenten.
Drücke Enter oder die Leertaste, um die Karte umzudrehen. Nutze die Pfeiltasten links und rechts, um zwischen den Karten zu wechseln.Begriff angezeigt.
1 / 6

Teste dich selbst

0/4
  1. Wo speicherst du einen Slash-Befehl, damit dein gesamtes Team ihn im Repo bekommt?
  2. Was bestimmt den Namen eines Slash-Befehls?
  3. Was macht $ARGUMENTS in einem Befehl?
  4. Welche Verpackungsoption lädt Claude automatisch, wenn sie relevant ist, statt dass du sie auslöst?

Weiter