VS Code: Skill erstellen und verwenden
Dieses Tutorial führt Sie durch das Erstellen eines Agent Skills von Grund auf und das tatsächliche Ausführen in VS Code + GitHub Copilot.
Wir erstellen einen Würfel-Skill, der dem Agenten beibringt, Zufallszahlen über Terminalbefehle zu generieren.
Vorbereitung
Umgebungsanforderungen
InstallationVS Code
- InstallationGitHub Copilot-Erweiterung
Dieses Tutorial verwendet VS Code, aber Agent Skills ist ein offenes Format. Derselbe Skill kann auch in kompatiblen Tools wie Claude Code, OpenCode, OpenAI Codex usw. verwendet werden.
Weitere VS Code-Inhalte findest du unter:VS Code Tutorial。
Skill-Verzeichnis und Dateien erstellen
VS Code sucht standardmäßig im Verzeichnis.agents/skills/des Projekts nach Skills.
Erstelle zunächst die folgende Verzeichnisstruktur in deinem Projekt:
Verzeichnisstruktur erstellen
mkdir -p .agents/skills/roll-dice
Erstelle dann die folgenden Dateien in.agents/skills/roll-dice/SKILL.md:
Beispiel: Vollständiger SKILL.md-Inhalt
name: roll-dice
description:Würfle mit einem Zufallszahlengenerator. Verwende dies, wenn der Benutzer darum bittet, zu würfeln (d6, d20 usw.) oder zufällige Würfelergebnisse zu generieren.
---
# Würfelmethode
Verwende den folgenden Shell-Befehl, um1eine Zufallszahl zwischen 1 und der angegebenen Anzahl von Seiten zu erzeugen:
## macOS / Linux
```bash
echo $((RANDOM % <sides> + 1))
```
## Windows PowerShell
```powershell
Get-Random -Minimum 1 -Maximum (<sides> + 1)
```
**Anleitung:**
Ersetze `<sides>` durch die vom Benutzer angegebene Anzahl der Würfelseiten:
-d6: Ersetze `<sides>` durch6
-d20: Ersetze `<sides>` durch20
-Andere Seitenzahlen folgen demselben Muster
**Ausgabe:**Gib einfach die Zufallsergebniszahl direkt zurück, keine zusätzliche Erklärung nötig.
Eine Datei mit weniger als 20 Zeilen erledigt einen vollständigen Skill.
Dateistrukturanalyse
Lassen Sie uns den Zweck dieser Datei Teil für Teil verstehen.
YAML-Header (Frontmatter)
| Feld | Zweck | Beschreibung |
|---|---|---|
| name | Eindeutige Kennung des Skills | Muss exakt dem Ordnernamen entsprechen, wobei Kleinbuchstaben und Bindestriche verwendet werden |
| description | Beschreibung der Auslösebedingung | Teilt dem Agenten mit, wann er diesen Skill verwenden sollte; dies ist das Schlüsselfeld, anhand dessen der Agent entscheidet, ob er ihn aktiviert |
Hauptteil (Markdown-Hauptteil)
Der Hauptteil enthält die Anweisungen, die der Agent nach der Aktivierung des Skills tatsächlich befolgt.
Hier sagen wir dem Agenten: Wenn der Benutzer darum bittet, Würfel zu werfen, verwende den Zufallszahlenbefehl des Betriebssystems und übergib die Anzahl der Würfelseiten an den Befehl.
Wir stellen außerdem Befehle sowohl für macOS/Linux- als auch für Windows-Plattformen bereit, und der Agent wählt automatisch basierend auf der aktuellen Umgebung aus.
Testen Sie Ihren Skill
Nachdem Sie die Datei erstellt haben, überprüfen Sie sie anhand der folgenden Schritte:
Öffnen Sie Ihr Projekt mit VS Code
Öffnen Sie das Copilot Chat-Panel (Tastenkürzel Ctrl+Shift+I oder Cmd+Shift+I) oder klicken Sie auf die Schaltfläche in der oberen rechten Ecke:
- Wählen Sie unten im Chat-Panel denAgent-Modus aus
Geben Sie den/skills-Befehl ein und bestätigen Sie, dass roll-dice in der Skill-Liste erscheint
Sie können sehen, dass die Skill-Liste roll-dice enthält:
Wenn Sie roll-dice nicht in der /skills-Liste sehen, prüfen Sie, ob der Dateipfad korrekt ist:.agents/skills/roll-dice/SKILL.md. Beachten Sie, dass SKILL.md in Großbuchstaben geschrieben werden muss.
Nachdem Sie bestätigt haben, dass der Skill geladen ist, geben Sie im Chat Folgendes ein:
Roll a d20
Der Agent sollte den roll-dice-Skill automatisch aktivieren, den Terminal-Befehl ausführen und eine Zufallszahl zwischen 1 und 20 zurückgeben.
Der Arbeitsprozess dahinter
Wenn Sie diesen Skill in Copilot Chat verwenden, laufen im Hintergrund drei Schritte ab:
Schritt 1: Entdeckung
Wenn die Chat-Sitzung startet, scannt der Agent das Standard-Skill-Verzeichnis (.agents/skills/) und findet roll-dice.
Er liest nur den Namen und die Beschreibung und erkennt: „Dieser Skill ist für das Würfeln.“
Schritt 2: Aktivierung
Wenn Sie „Roll a d20“ eingeben, gleicht der Agent Ihre Frage mit der Beschreibung von roll-dice ab.
Nach einem erfolgreichen Abgleich lädt der Agent den vollständigen Inhalt von SKILL.md in den Kontext.
Schritt 3: Ausführung
Der Agent folgt den Anweisungen im Inhalt, erkennt, dass Sie macOS (oder Linux) verwenden, und wählt den bash-Befehl aus.
Er setzt die 20, die d20 entspricht, in den Befehl ein und führtecho $((RANDOM % 20 + 1))aus, dann gibt er Ihnen das Ergebnis zurück.
Allgemeine Fehlerbehebung
| Problem | Mögliche Ursache | Lösung |
|---|---|---|
| /skills list ist leer | Der Pfad der SKILL.md-Datei ist falsch | Bestätige, dass sich die Datei im Verzeichnis .agents/skills/roll-dice/ des Projekts befindet |
| Der Agent hat den Befehl nicht ausgeführt | Unterschiede bei der Zuverlässigkeit von Modell-Tool-Aufrufen | Versuche, das Modell zu wechseln, oder sage expliziter "hilf mir, einen d20 zu würfeln" |
| Befehlsausführung fehlgeschlagen | Unterschiede in der Shell-Umgebung | Bestätige, dass der Befehl $RANDOM im macOS/Linux-Terminal korrekt ausgeführt wird |
Tipps zur toolübergreifenden Nutzung
Obwohl dieses Tutorial VS Code verwendet, kann der Skill auch in anderen Tools verwendet werden:
| Tool | Speicherort für Skills |
|---|---|
| VS Code + Copilot | .agents/skills/ oder .github/copilot/ |
| Claude Code | .claude/skills/ oder ~/.claude/skills/ |
| OpenAI Codex | .codex/skills/ |
Verschiedene Tools können unterschiedliche Standardverzeichnisse verwenden, aber das Skill-Format und die Dateistruktur selbst sind universell.
Andere Erweiterungen