Przejdź do głównej zawartości

Własne slash commands w Claude Code

Własne komendy to zwykłe pliki .md:

  • Projektowe: .claude/commands/ - współdzielone przez git.
  • Użytkownika: ~/.claude/commands/ - dostępne we wszystkich projektach.

Nazwa pliku staje się nazwą komendy (deploy.md → /deploy).

Własne komendy zostały scalone ze skillami. Pliki w .claude/commands/ nadal działają - to starszy, prostszy format - a jeśli komenda i skill mają tę samą nazwę, wygrywa skill.

Frontmatter to kilka linijek ustawień na samej górze pliku, między dwiema liniami ---. Wszystkie pola są opcjonalne - plik bez frontmattera też działa.

---
description: Krótki opis (pokazywany w /help)
argument-hint: [message]
allowed-tools: Bash(git add:*), Bash(git commit:*)
model: haiku
disable-model-invocation: false
---
Treść promptu. $ARGUMENTS = wszystko po nazwie; $0, $1 = pozycyjne (od zera).
Wstaw plik przez @ścieżka; uruchom bash i wstaw wynik przez !`komenda`.
  • $ARGUMENTS - cały tekst po nazwie komendy. $0, $1 i kolejne - argumenty pozycyjne liczone od zera: $0 to pierwszy, $1 drugi.
  • !`komenda` - uruchomi komendę w terminalu jeszcze przed wysłaniem promptu i wstawi jej wynik, więc Claude dostaje gotowe dane (wymaga allowed-tools).
  • allowed-tools - narzędzia, których Claude użyje w tej komendzie bez pytania Cię o zgodę. Bash(git add:*) oznacza każdą komendę zaczynającą się od git add.
  • model - model użyty dla tej komendy, np. haiku. Ustawienie działa do końca bieżącej odpowiedzi i nie zmienia Twojej domyślnej konfiguracji.
  • @ścieżka - wstawia zawartość pliku.
  • disable-model-invocation: true - tylko Ty możesz uruchomić komendę. Warto dla komend z efektami ubocznymi, jak /commit czy /deploy.

Conventional Commits to popularna konwencja opisów commitów z przedrostkiem typu zmiany, np. feat: albo fix:. Plik .claude/commands/commit.md:

---
description: Utwórz git commit wg Conventional Commits
allowed-tools: Bash(git add:*), Bash(git commit:*), Bash(git status:*), Bash(git diff:*)
argument-hint: [message]
model: haiku
---
# Kontekst
- Status: !`git status`
- Diff (staged): !`git diff --cached`
Utwórz commit wg Conventional Commits. Jeśli podano $ARGUMENTS, użyj jako wiadomości.
---
description: Napraw issue z GitHub
argument-hint: <issue-number> [priority]
allowed-tools: Bash(gh issue:*), Read, Edit
---
Napraw issue #$0 z priorytetem $1. Najpierw pobierz szczegóły przez `gh issue view $0`,
przeczytaj CONTRIBUTING.md, potem zaproponuj plan i wprowadź poprawkę.
---
description: Wyjaśnij bieżący git diff
allowed-tools: Bash(git status:*), Bash(git diff:*), Bash(git log:*)
---
# Kontekst
- Status: !`git status`
- Diff: !`git diff HEAD`
Wyjaśnij po polsku, co się zmieniło i dlaczego.
---
description: Wygeneruj testy dla wskazanego pliku
argument-hint: [ścieżka]
allowed-tools: Read, Write, Bash
---
Wygeneruj testy jednostkowe dla @$ARGUMENTS. Wykryj framework,
dopasuj konwencje repo, uruchom testy.
---
description: Przegląd PR pod kątem jakości
allowed-tools: Read, Grep, Glob, Bash(git diff:*)
model: opus
---
Przejrzyj zmiany w PR #$0: poprawność, bezpieczeństwo, wydajność, pokrycie testami.
  1. Utwórz plik ~/.claude/commands/ship.md.
  2. Wpisz w nim treść: “Przejrzyj bieżący diff, uruchom testy, jeśli przechodzą - zrób commit”.
  3. Wywołaj /ship w dowolnym projekcie.

Zaliczenie: komenda /ship pojawia się na liście po wpisaniu / i uruchamia się. Masz pierwszy własny skrót do powtarzalnej pracy.

Jeśli nic nie zgrzyta i zostaje czas: dopisz do niej frontmatter z description, allowed-tools i disable-model-invocation: true - komenda robi commit, więc powinna ruszać tylko na Twoje polecenie. Potem porównaj, jak wygląda w /help przed i po.

  • Własna komenda to plik Markdown, a jego nazwa to nazwa komendy.
  • Frontmatter steruje opisem, narzędziami, modelem i tym, czy Claude może ją wywołać sam.
  • Do promptu wstawisz argumenty, zawartość pliku i wynik komendy shell.

Następny krok: CLAUDE.md i pamięć - plik, w którym zapisujesz reguły projektu raz, zamiast powtarzać je w każdej rozmowie.

Częste pytania

Gdzie zapisać własną komendę?

W katalogu .claude/commands/ wewnątrz projektu, jeśli ma być współdzielona przez repozytorium, albo w ~/.claude/commands/, jeśli ma działać we wszystkich projektach. Nazwa pliku staje się nazwą komendy.

Jak przekazać komendzie argumenty?

Zmienna $ARGUMENTS wstawia cały tekst po nazwie komendy, a $0, $1 i kolejne wstawiają argumenty pozycyjne liczone od zera - $0 to pierwszy argument, $1 drugi. Podpowiedź dla użytkownika ustawiasz polem argument-hint we frontmatterze.

Czy Claude może sam wywołać moją komendę?

Domyślnie tak. Jeśli komenda ma efekty uboczne, na przykład commituje albo wdraża, ustaw disable-model-invocation na true - wtedy uruchomisz ją tylko Ty.

made with ❤️ by aitomate.pl - Łukasz Podgórski