Zum Hauptinhalt springen

Benutzerdefinierte Skills

Skills sind Slash-Befehle, die vollständige Arbeitsabläufe mit Claude Code automatisieren. Wenn du /implement in dein Terminal eingibst, liest Claude Code die Anweisungen der entsprechenden Skill und führt eine vordefinierte Abfolge von Schritten aus: die Aufgabe lesen, Code schreiben, Tests ausführen und das Item in die richtige Spalte verschieben.

Almirant enthält integrierte Skills für die häufigsten Abläufe, aber du kannst eigene Skills erstellen, um sie an die Bedürfnisse deines Teams anzupassen.

Integrierte Skills​

Almirant enthält standardmäßig diese Skills:

SkillBeschreibung
/implementLiest das zugewiesene Work Item, implementiert den erforderlichen Code und verschiebt die Aufgabe in die Spalte Review
/review-taskPrüft die aktuelle Implementierung anhand der Definition des Work Items und seiner Definition of Done
/validateVollständige Validierungspipeline: Code-Review + Testausführung + Screenshots
/test-taskGeneriert automatisierte Tests für die aktuelle Implementierung und führt sie aus
/prErstellt aus dem aktuellen Branch einen Pull Request auf GitHub mit generierter Beschreibung
/ideateStartet eine interaktive Brainstorming-Sitzung und erstellt aus den Ideen Work Items
/create-tasksErstellt gut strukturierte Work Items mit Titel, Beschreibung, Akzeptanzkriterien und Schätzung

So funktioniert jede Skill​

/implement​

  1. Liest das zugewiesene Work Item über MCP aus Almirant
  2. Analysiert Beschreibung, Akzeptanzkriterien und Definition of Done
  3. Untersucht den vorhandenen Code, um den Kontext zu verstehen
  4. Implementiert die erforderlichen Änderungen
  5. Verschiebt das Work Item in die Spalte Review

/review-task​

  1. Ruft das Work Item und seine Definition of Done aus Almirant ab
  2. Liest die im Code implementierten Änderungen
  3. Vergleicht die Implementierung mit den Akzeptanzkriterien
  4. Erstellt einen detaillierten Bericht mit Erkenntnissen und Vorschlägen

/validate​

  1. Führt /review-task aus, um die Implementierung zu prüfen
  2. Führt die Tests des Projekts aus
  3. Wenn es eine Benutzeroberfläche gibt, erstellt Screenshots zur visuellen Prüfung
  4. Erstellt einen konsolidierten Bericht mit dem Ergebnis jedes Schritts

/test-task​

  1. Liest das Work Item, um zu verstehen, was getestet werden soll
  2. Analysiert die aktuelle Implementierung
  3. Erstellt Unit- und/oder Integrationstests
  4. Führt die Tests aus und berichtet die Ergebnisse

/pr​

  1. Analysiert die Commits und Änderungen im aktuellen Branch
  2. Erstellt einen Titel und eine Beschreibung für den Pull Request
  3. Erstellt den PR mit den generierten Informationen auf GitHub

/ideate​

  1. Startet einen interaktiven Dialog, um Ideen zu erkunden
  2. Stellt Fragen, um die Konzepte zu verfeinern
  3. Wandelt die Ideen in strukturierte Work Items in Almirant um

/create-tasks​

  1. Erhält eine übergeordnete Beschreibung dessen, was benötigt wird
  2. Teilt die Arbeit in kleinteilige Aufgaben auf
  3. Erstellt die Work Items in Almirant mit allen erforderlichen Informationen

Benutzerdefinierte Skills erstellen​

Skills werden als Markdown-Dateien im Verzeichnis .claude/skills/ deines Projekts definiert.

Speicherort​

tu-proyecto/
  .claude/
    skills/
      implement.md
      review-task.md
      mi-skill-custom.md    # <-- deine benutzerdefinierte Skill

Struktur einer Skill​

Jede Skill-Datei besteht aus zwei Teilen:

  1. Frontmatter: Metadaten im YAML-Format (Name und Beschreibung)
  2. Anweisungen: Schritte, die Claude Code befolgen soll, in Markdown geschrieben
---
name: mi-skill
description: Kurze Beschreibung der Funktion dieser Skill
---

## Anweisungen für den Agenten

1. Schritt eins: detaillierte Beschreibung
2. Schritt zwei: detaillierte Beschreibung
3. Schritt drei: detaillierte Beschreibung

Beispiel: Bereitstellungs-Skill​

---
name: deploy-staging
description: Stellt den aktuellen Branch in der Staging-Umgebung bereit
---

## Anweisungen

1. Prüfe mit `git status`, dass keine nicht committeten Änderungen vorhanden sind
2. Führe den Linter mit `bun run lint` aus und behebe gegebenenfalls Fehler
3. Führe die Tests mit `bun run test` aus und stelle sicher, dass sie bestehen
4. Pushe den aktuellen Branch nach origin
5. Führe die Bereitstellung in Staging mit `bun run deploy:staging` aus
6. Prüfe anhand der Staging-URL, dass die Bereitstellung erfolgreich war
7. Teile dem Benutzer das Ergebnis mit der URL der Umgebung mit

Beispiel: Dokumentations-Skill​

---
name: document-feature
description: Generiert technische Dokumentation für ein implementiertes Feature
---

## Anweisungen

1. Lies das mit dem Feature verknüpfte Work Item über MCP aus Almirant
2. Ermittle die neuen oder geänderten Dateien der Implementierung
3. Für jede neue Komponente bzw. jedes neue Modul:
   - Generiere ein JSDoc mit Beschreibung, Parametern und Beispielen
   - Wenn es ein Hook ist, dokumentiere die Rückgabewerte
   - Wenn es ein Endpoint ist, dokumentiere Request/Response
4. Aktualisiere die README der Domäne, falls sie existiert
5. Erstelle im Work Item einen Kommentar mit der Zusammenfassung der generierten Dokumentation

Beispiel: Datenbankmigrations-Skill​

---
name: db-migrate
description: Generiert und wendet Datenbankmigrationen sicher an
---

## Anweisungen

1. Lies die ausstehenden Änderungen in den Schema-Dateien (`backend/packages/database/src/schema/`)
2. Generiere die Migration mit `bun run db:generate`
3. Prüfe das generierte SQL im Migrationsverzeichnis
4. Wenn das SQL destruktive Operationen enthält (DROP, ALTER mit Datenverlust),
   warne den Benutzer und warte vor dem Fortfahren auf eine Bestätigung
5. Wende die Migration mit `bun run db:migrate` an
6. Prüfe, ob die Migration korrekt angewendet wurde

Bewährte Praktiken​

Klare und spezifische Anweisungen​

Schreibe Anweisungen, die keinen Raum für Mehrdeutigkeiten lassen. Statt „prüfe den Code“ solltest du festlegen, welche Dateien oder Muster geprüft werden müssen.

# Weniger effektiv
1. Prüfe den Code
2. Nimm die erforderlichen Änderungen vor

# Effektiver
1. Lies alle Dateien in `src/domains/[feature]/`, um die Struktur zu verstehen
2. Prüfe, dass präsentationale Komponenten weder useState noch useEffect enthalten
3. Wenn du Logik in .tsx-Komponenten findest, extrahiere sie in einen Custom Hook in `application/hooks/`

MCP-Tools in Anweisungen verwenden​

Verweise auf die MCP-Tools von Almirant, damit die Skill mit deinem Board interagiert.

1. Verwende das Tool `get_work_item`, um die zugewiesene Aufgabe zu lesen
2. Implementiere die Änderungen gemäß der Beschreibung
3. Verwende `update_work_item`, um die Aufgabe in die Spalte "Review" zu verschieben

Bedingungen und Validierungen einbeziehen​

Lege fest, was die Skill tun soll, wenn etwas fehlschlägt oder besondere Bedingungen vorliegen.

3. Führe die Tests mit `bun run test` aus
   - Wenn Tests fehlschlagen, analysiere die Fehler und versuche, sie zu beheben
   - Wenn du sie nach 2 Versuchen nicht beheben kannst, berichte dem Benutzer die Fehler
4. Wenn das Work Item das Label "needs-review" hat, verschiebe es nicht automatisch nach Done

Skills fokussiert halten​

Jede Skill sollte eine Sache gut erledigen. Wenn du einen komplexen Ablauf benötigst, teile ihn in mehrere Skills auf und kombiniere sie manuell.

Tipp

Beginne damit, eine integrierte Skill zu kopieren und sie für deinen Anwendungsfall anzupassen. Es ist einfacher, etwas Bestehendes anzupassen, als bei null anzufangen.

Wichtig

Skills sind Anweisungen für die KI und keine ausführbaren Skripte. Claude Code interpretiert sie und entscheidet, wie jeder Schritt ausgeführt wird. Formuliere die Anweisungen mit Blick auf eine Entwicklerin oder einen Entwickler, die oder der sie zum ersten Mal liest.

Skills mit deinem Team teilen​

Da Skills in .claude/skills/ liegen, werden sie zusammen mit dem restlichen Projekt mit Git versioniert. Jedes Teammitglied, das das Repository klont, hat Zugriff auf dieselben Skills.

Um Konsistenz zu bewahren:

  1. Dokumentiere jede Skill mit einer klaren Beschreibung im Frontmatter
  2. Verwende einheitliche Namenskonventionen (kebab-case)
  3. Gruppiere verwandte Skills mit Präfixen: deploy-staging.md, deploy-production.md
  4. Prüfe Skills im Code Review wie jede andere Projektdatei