Skills schreiben
Eine 4-Phasen-Pipeline: Sammeln → Hinterfragen → Planen → Umsetzen.
Phase 1: Sammeln
Verwende AskUserQuestion mit nach Domänen gebündelten Fragen über 4 Domänen hinweg. Jede Domäne erhält einen Aufruf mit 2–4 Optionen und einer Empfehlung (erste Option = (Empfohlen)).
- Zweck – Welche Aufgabe/Domäne deckt der Skill ab? Wer nutzt ihn?
- Anwendungsfälle – Welche spezifischen Szenarien lösen diesen Skill aus? Welche Schlüsselwörter?
- Struktur – Benötigt er Skripte? Referenzdateien? Einzelne SKILL.md oder mehrere Dateien?
- Werkzeuge – Welche Tools oder anderen Skills soll er aufrufen oder referenzieren?
Phase 2: Hinterfragen
Rufe den Skill grill-me auf und übergib die gesammelten Anforderungen. Weise ihn an, die für den Skill maßgeschneiderten Domänen in skill-grill-domains.md zu verwenden (Absicht, Umfang, Design, Grenzfälle). Überspringe irrelevante Domänen (Datenfluss, Abhängigkeiten, Bereitstellung, Tests).
Fallback (grill-me nicht verfügbar): Führe ein Inline-Mini-Hinterfragen direkt mit AskUserQuestion durch. Für jede Domäne in skill-grill-domains.md bündle 2–4 Fragen pro Aufruf mit Empfehlungen und Optionen.
Phase 3: Planen
Erstelle einen strukturierten Skill-Blueprint unter Verwendung der Vorlage in blueprint-template.md. Präsentiere den Blueprint im Gesprächskontext (nicht auf die Festplatte schreiben). Der Benutzer muss vor dem Fortfahren zustimmen. Wenn der Benutzer Änderungen wünscht, überarbeite und präsentiere erneut.
Phase 4: Umsetzen
Erstelle alle Skill-Dateien gemäß dem genehmigten Blueprint. Vollständig automatisiert – der Agent schreibt alles.
Führe dann Phase 4b: Überprüfung mit den Kriterien aus quality-criteria.md durch:
- Automatische Überprüfung – Überprüfe messbare Kriterien (Zeilenzahl, Beschreibungslänge, Auslöser, Referenztiefe). Behebe alle Fehler, bevor du fortfährst.
- Subjektive Überprüfung – Präsentiere dem Benutzer die Checkliste via
AskUserQuestion. Wenn der Benutzer Probleme meldet, überarbeite und überprüfe erneut.
Skill-Struktur
skill-name/
├── SKILL.md # Hauptanleitung (erforderlich, <100 Zeilen)
├── references/ # Unterstützende Dokumente (falls nötig)
│ └── domain-ref.md
└── scripts/ # Hilfsskripte (falls nötig)
└── helper.sh
Fallback (kein AskUserQuestion)
Wenn AskUserQuestion nicht verfügbar ist, verwende textbasierte Fragen:
[Überschrift] — [Thema] Empfohlen: [Deine Empfehlung und warum] Alternativen: (A) [Option] — [Kompromiss] | (B) [Option] — [Kompromiss]
Qualitätsstandards
Siehe quality-criteria.md für Beschreibungsanforderungen, Kriterien zur automatischen Überprüfung, Checkliste für die subjektive Überprüfung und Hinweise, wann Skripte hinzugefügt oder Dateien aufgeteilt werden sollten.