Benutzerdefinierte Befehle & Skills
Erweitern Sie Ihren KI-Coding-Agenten mit wiederverwendbaren Slash-Befehlen, die komplexe Workflows automatisieren.
Was sind Slash-Befehle?
Slash-Befehle sind Abkuerzungen, die vordefinierte KI-Workflows ausloesen:
/review -> Umfassendes Code-Review ausfuehren
/test -> Tests fuer die aktuelle Datei generieren
/docs -> Dokumentation generieren
/fix -> Aktuellen Fehler analysieren und beheben
/refactor -> Refactoring vorschlagen und anwenden
/security -> Sicherheitsaudit der letzten Aenderungen
Statt jedes Mal einen detaillierten Prompt zu tippen, geben Sie einen kurzen Befehl ein und der Agent fuehrt einen vorgefertigten Workflow aus.
Die Vorteile:
- Konsistente Qualitaet (jedes Mal derselbe Prompt)
- Team-Standardisierung (alle reviewen Code auf dieselbe Weise)
- Geschwindigkeit (ein Befehl statt eines Absatzes an Anweisungen)
- Kompositionsfaehigkeit (Befehle koennen andere Befehle aufrufen)
Einen /review-Befehl bauen
Einen Code-Review-Befehl mit einer SKILL.md-Datei erstellen:
# /review -- Code Review
## System Prompt
You are a senior software engineer performing a thorough code review.
Focus on bugs, security, performance, and maintainability.
## Steps
1. Read the git diff of staged or recent changes
2. For each changed file, analyze:
- Logic errors and potential bugs
- Security vulnerabilities (OWASP Top 10)
- Performance concerns
- Code style and readability
3. Rate overall quality (1-10)
4. List specific issues with severity
## Output Format
### Code Review Summary
- **Quality Score:** X/10
- **Files Reviewed:** N
### Issues Found
For each issue:
- **File:** path/to/file.js:LINE
- **Severity:** Critical | High | Medium | Low
- **Issue:** Description
- **Fix:** Suggested solution
### Positive Highlights
- What's done well (acknowledge good code!)
Einen /test-Befehl bauen
Automatisierte Testgenerierung:
# /test -- Tests generieren
## System Prompt
You are a testing specialist. Generate comprehensive tests
that cover happy paths, error cases, and edge cases.
## Steps
1. Read the target file (current file or specified file)
2. Identify all public functions and methods
3. For each function, generate tests for:
- Happy path (normal input -> expected output)
- Error cases (invalid input -> appropriate error)
- Edge cases (empty, null, boundary values)
- Integration points (mocked dependencies)
4. Use the project's testing framework (read AGENTS.md)
5. Run the tests and fix any failures
## Constraints
- Match existing test patterns in the project
- Use descriptive test names: "should [expected behavior] when [condition]"
- Mock external dependencies, never call real APIs
- Aim for 90%+ coverage of the target file
Einen /docs-Befehl bauen
Dokumentation, die synchron bleibt:
# /docs -- Dokumentation generieren
## System Prompt
You are a technical writer who values clarity and accuracy.
## Modes
### Mode 1: Einzelne Datei (Standard)
- Read the current file
- Generate JSDoc/TSDoc for all exported functions
- Add module-level documentation
### Mode 2: API-Referenz (/docs api)
- Scan all route files
- Generate endpoint documentation
- Include request/response schemas and examples
### Mode 3: Architektur (/docs arch)
- Analyze project structure
- Generate architecture overview
- Include dependency diagram (as ASCII art)
## Output Rules
- Keep descriptions under 2 sentences
- Always include @param, @returns, @throws
- Add @example with realistic usage
- Match existing documentation style in the project
SKILL.md-Plugin-System
Skills sind wiederverwendbare, teilbare Prompt-Pakete:
Verzeichnisstruktur:
.claude/skills/
review/
SKILL.md <- Die Skill-Definition
test/
SKILL.md
docs/
SKILL.md
security-audit/
SKILL.md
deploy-check/
SKILL.md
SKILL.md-Aufbau:
name: Security Audit command: /security description: Run a security audit on recent changes author: your-team version: 1.2.0
Security Audit
Trigger
Run when: manually invoked or on PR creation
System Prompt
[Detaillierte Anweisungen fuer die KI]
Tools Required
- File system (read source code)
- Terminal (run dependency audit)
- Git (read recent changes)
Output
[Erwartetes Format] ```
Befehle komponieren
Befehle werden maechtig, wenn sie verkettet werden:
Der /ship-Befehl -- ein kompletter Pre-Merge-Workflow:
# /ship -- Pre-Merge-Checkliste
## Steps
1. Run /review on all changed files
- If quality score < 7: stop and report issues
2. Run /test to generate missing tests
- If coverage < 80%: stop and report gaps
3. Run /security on all changes
- If any Critical issues: stop immediately
4. Run /docs to update documentation
5. If all checks pass:
- Stage all changes
- Create a commit with a descriptive message
- Report: "Ready to merge! Review Tests Security Docs"
Dieser einzelne Befehl ersetzt eine 30-minuetige manuelle Checkliste.
Skills teamubergreifend teilen
Skills werden zu einer Team-Wissensbasis:
Teamweites Skill-Repository:
company-ai-skills/ <- Gemeinsames Git-Repo
code-review/SKILL.md <- Standardisierte Reviews
test-generation/SKILL.md <- Test-Standards
incident-response/SKILL.md <- Bereitschafts-Playbook
onboarding/SKILL.md <- Neuer-Entwickler-Setup
deploy/SKILL.md <- Deployment-Checkliste
Vorteile:
- Neue Teammitglieder bekommen sofort Experten-Level-KI-Tools
- Best Practices sind kodifiziert, nicht nur dokumentiert
- Updates propagieren automatisch an alle
- Wissen geht nicht verloren, wenn Leute gehen
Installation:
# Team-Skills in Ihr Projekt klonen
git clone company-ai-skills .claude/skills
Skills sind die Bruecke zwischen individueller KI-Expertise und organisationalem Wissen. Eine Person entdeckt den besten Prompt fuer Code-Review -- das ganze Team profitiert.
---quiz question: Was ist der Hauptvorteil von Slash-Befehlen gegenueber dem manuellen Tippen von Prompts? options:
- { text: "Sie verbrauchen weniger API-Tokens", correct: false }
- { text: "Konsistente Qualitaet, Team-Standardisierung und Geschwindigkeit -- jedes Mal derselbe optimierte Workflow", correct: true }
- { text: "Sie funktionieren ohne Internetverbindung", correct: false } feedback: Slash-Befehle kodifizieren Ihre besten Prompts in wiederverwendbare Workflows. Jedes Teammitglied bekommt dieselbe Qualitaet beim Review, dieselben gruendlichen Tests und denselben Dokumentationsstandard -- ohne sich den optimalen Prompt merken zu muessen.
---quiz question: Wie demonstriert der /ship-Befehl Befehlskomposition? options:
- { text: "Er laeuft schneller als einzelne Befehle", correct: false }
- { text: "Er verkettet /review, /test, /security und /docs mit Qualitaets-Gates zwischen jedem Schritt", correct: true }
- { text: "Er ersetzt alle anderen Befehle", correct: false } feedback: Der /ship-Befehl komponiert einzelne Skills zu einem vollstaendigen Pre-Merge-Workflow mit Qualitaets-Gates -- wenn der Review-Score zu niedrig ist, stoppt er. Wenn Tests fehlschlagen, stoppt er. Dies ersetzt eine manuelle 30-minuetige Checkliste durch einen einzelnen Befehl.
---quiz question: Warum sollten Teams Skill-Definitionen in einem gemeinsamen Repository teilen? options:
- { text: "Weil Skills in einzelnen Projekten nicht funktionieren", correct: false }
- { text: "Neue Mitglieder bekommen sofort Experten-Level-Tools, Best Practices propagieren automatisch und Wissen bleibt erhalten, wenn Leute gehen", correct: true }
- { text: "Um die Anzahl der benoetigten API-Keys zu reduzieren", correct: false } feedback: Geteilte Skills kodifizieren organisationales Wissen in wiederverwendbare KI-Workflows. Neue Teammitglieder sind sofort produktiv mit Experten-Level-Tools, und das Wissen bleibt erhalten, auch wenn die Person, die es erstellt hat, das Team verlaesst.