>_

Best Practices

Richtlinien für die Erstellung effektiver, wartbarer Agent Skills.

Überblick

Gut gestaltete Skills machen den Unterschied zwischen einem hilfreichen KI-Assistenten und einem frustrierenden aus. Befolgen Sie diese Best Practices, um Skills zu erstellen, die zuverlässig funktionieren.

Grundprinzipien

1. Seien Sie spezifisch, nicht vage

Gut:

"Verwenden Sie Satzformat für Überschriften. Schreiben Sie nur das erste Wort und Eigennamen groß."

Schlecht:

"Verwenden Sie angemessene Groß- und Kleinschreibung."

2. Geben Sie Beispiele

Zeigen Sie, erzählen Sie nicht nur. Fügen Sie konkrete Beispiele für erwartetes Verhalten ein.

Gut:

Bei der Formatierung von Daten: - Schreiben Sie: "15. Januar 2024" - Schreiben Sie nicht: "15.01.24" oder "15 Jan 2024"

3. Definieren Sie den Umfang klar

Geben Sie explizit an, was der Skill abdeckt und was nicht.

Gut:

Dieser Skill deckt ab: - React-Komponenten-Design - Zustandsverwaltung - Leistungsoptimierung Dieser Skill deckt NICHT ab: - Backend-API-Design - Datenbankschema - DevOps/Deployment

4. Verwenden Sie eine konsistente Struktur

Organisieren Sie Inhalte vorhersehbar, damit die KI Informationen schnell finden kann.

Empfohlene Abschnitte:

  1. Kontext/Überblick
  2. Richtlinien
  3. Dos und Don'ts
  4. Beispiele
  5. Referenzen

5. Bleiben Sie fokussiert

Ein Skill = ein Bereich. Versuchen Sie nicht, alles abzudecken.

Gut: "React-Komponenten-Richtlinien" Schlecht: "Vollständiger Web-Entwicklungs-Leitfaden"

Häufige Fehler

Überengineering

Fügen Sie keine Komplexität hinzu, die keinen Wert bietet:

  • Zu viele Regeln, die sich widersprechen
  • Grenzfälle, die selten auftreten
  • Redundante Informationen

Unterspezifikation

Lassen Sie wichtige Details nicht mehrdeutig:

  • Fehlende Beispiele für Schlüsselkonzepte
  • Vage Formulierungen wie "wie angemessen"
  • Keine Anleitung für Grenzfälle

Widersprüchliche Anweisungen

Stellen Sie sicher, dass Ihre Richtlinien sich nicht widersprechen:

Problem:

"Halten Sie Antworten kurz" und "Geben Sie detaillierte Erklärungen"

Lösung:

"Halten Sie Antworten kurz. Geben Sie bei komplexen Themen detaillierte Erklärungen in erweiterbaren Abschnitten."

Dokumentation

Verwandt

Diese Seite auf GitHub bearbeiten