Agent-Modus mit Skills erweitern

Mit Skills können Sie die Funktionen des Agent-Modus mit Fachwissen und benutzerdefinierten Workflows erweitern. Sie basieren auf dem offenen Standard Agent Skills.

Im Gegensatz zu AGENTS.md-Dateien stellen Skills On-Demand-Fachwissen dar. Diese Struktur ermöglicht es dem Agent-Modus, eine große Anzahl spezialisierter Funktionen beizubehalten, z. B. die Migration zwischen bestimmten Bibliotheksversionen oder die Anpassung eines Composables an verschiedene Bildschirmgrößen, ohne das unmittelbare Kontextfenster des Modells zu überladen.

Das Modell entscheidet autonom, wann ein Skill auf Grundlage Ihrer Anfrage und der Beschreibung des Skills eingesetzt werden soll. Wenn eine relevante Skill erkannt wird, ruft das Modell dynamisch die vollständigen Anweisungen und Ressourcen ab, die zum Ausführen der Aufgabe erforderlich sind.

Wenn Sie einen Skill auf Abruf aktivieren möchten, bitten Sie den Agent, eine Aufgabe auszuführen, die für den Skill relevant ist. Sie können auch @ in das Eingabefeld eingeben, um einen bestimmten Skill auszulösen.

Hauptvorteile

  • Gemeinsames Fachwissen: Packen Sie komplexe Workflows (z. B. den Pull-Request-Überprüfungsprozess eines bestimmten Teams) in einen dedizierten Ordner, den jeder verwenden kann.
  • Wiederholbare Workflows:Sorgen Sie dafür, dass komplexe, mehrstufige Aufgaben konsistent ausgeführt werden, indem Sie Standardanweisungen bereitstellen.
  • Ressourcen bündeln:Fügen Sie Skripts, Vorlagen oder Beispieldaten zusammen mit Ihrer Anleitung hinzu, damit der Agent alles, was er benötigt, an einem Ort hat.
  • Effiziente Nutzung des Kontextfensters:Um Kontext-Tokens zu sparen, werden anfangs nur die Metadaten des Skills (Name und Beschreibung) geladen. Die vollständige SKILL.md-Datei wird erst bei der Aktivierung geladen. Unterstützende Dateien in den Verzeichnissen references/, scripts/ oder assets/ werden nur in den Kontext geladen, wenn der Agent sie explizit benötigt.

Eigene Skills erstellen

Der Agent sucht nach Skills, beginnend mit den Verzeichnissen .skills/ oder .agent/skills/ im Stammverzeichnis Ihres Projekts. So erstellen Sie einen benutzerdefinierten Skill:

  1. Erstellen Sie ein Verzeichnis für Ihren Skill (z. B. my-new-skill/).
  2. Erstellen Sie eineSKILL.md-Datei (Groß-/Kleinschreibung beachten) im neuen Verzeichnis.

Skills müssen die folgenden Regeln einhalten:

  • Ein Verzeichnis pro Skill:Jeder Skill muss ein eigenes Verzeichnis haben, das eine SKILL.md-Datei und alle zusätzlichen Ressourcen enthält.
  • Verschachtelung:Alle Skills müssen sich im Verzeichnis .skills/ oder .agent/skills/ im Stammverzeichnis des Projekts befinden. Sie können jedoch Unterverzeichnisse verwenden, um die Organisation zu verbessern, z. B. skills/ui-flows/<skill name>/SKILL.md oder skills/testing/<skill name>/SKILL.md.
  • Umfang:Derzeit werden nur Skills unterstützt, die sich im Code des Projekts befinden.

In der Datei SKILL.md wird ein YAML-Block für Metadaten und Standard-Markdown für die Anleitung verwendet.

  • name: Eine eindeutige Kennung für den Skill. Dieser sollte mit dem Verzeichnisnamen übereinstimmen.
  • description: Eine klare Erklärung der Funktion des Skills und wann der Agent ihn verwenden sollte.
  • Body:Der Markdown-Text unter dem YAML-Block enthält die Anweisungen, die das Verhalten des Agents steuern, wenn der Skill aktiv ist.
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill content

Formatierungsrichtlinien

  • Name:Maximal 64 Zeichen (nur Kleinbuchstaben, Ziffern und Bindestriche).
  • Beschreibung:maximal 1.024 Zeichen
  • Hauptinhalt:10.000 bis 20.000 Zeichen (ca. 2.500 bis 5.000 Tokens). Wenn Ihre Anleitung diese Grenze überschreitet, sollten Sie die detaillierte Dokumentation in eine Ressourcendatei verschieben, wie unter Optionale Skill-Verzeichnisse beschrieben.

Optionale Skill-Verzeichnisse

Damit Ihre SKILL.md-Datei übersichtlich und modular bleibt, können Sie zusätzliche Ressourcen in den folgenden optionalen Verzeichnissen im Ordner Ihres Skills einfügen:

  • scripts/: Enthält ausführbaren Code (z. B. Python oder Bash), den der Agent ausführen kann.
  • references/: Enthält detaillierte technische Dokumentation, API-Referenzen oder domänenspezifische Anleitungen.
  • assets/: Enthält statische Ressourcen wie Dokumentvorlagen, UI-Diagramme oder JSON-Schemas.

Wenn Sie in Ihren SKILL.md-Anweisungen auf diese Dateien verweisen, verwenden Sie relative Pfade vom Skill-Stammverzeichnis aus. Beispiel: Run the script at scripts/cleanup.py.