Was macht Agent-Fähigkeit schreiben?
Zielsetzung
Ein ausführbares Anleitungspaket für einen Agenten für eine einzige, kohärente und wiederverwendbare Aufgabe liefern. Verankern Sie es in der Aufgabe des Benutzers, in Beispielen, der Werkzeugumgebung, vorhandenen Artefakten und Korrekturen. Wenn keine realen Beispiele verfügbar sind, kennzeichnen Sie Annahmen und entwerfen Sie minimal testbare Anweisungen, anstatt produktspezifische APIs zu erfinden. Vervollständigen und präsentieren Sie die tatsächlich angeforderte Fähigkeit, nicht nur einen Plan, einen Fortschrittsbericht oder eine Kritik.
Vertrag definieren
- Geben Sie den Auslöser an: die Aufgabe und Eingabe, die diese Fähigkeit aktivieren sollte, sowie angrenzende Anfragen, die dies nicht sollten. Schreiben Sie die
descriptionals präzise Routing-Regel, die angibt, was sie tut und wann sie verwendet werden soll. - Geben Sie die erforderlichen und optionalen Eingaben, die zulässige Autorität des Agenten, die beabsichtigte Ausgabe und die Definition von „erledigt“ an. Lösen Sie Überschneidungen mit benachbarten Fähigkeiten an der Übergabestelle auf; führen Sie nicht unterschiedliche Stufen nur aufgrund eines gemeinsamen Themas zusammen.
- Kennzeichnen Sie, welche Verhaltensweisen obligatorische Sicherheits- oder Korrektheitsgates sind, welche Standardheuristiken sind und welche optionale Erweiterungen sind. Anweisungen können keine Laufzeitberechtigungen erzwingen: Verwenden Sie Plattformkontrollen für Dateisystem-, Netzwerk- und Werkzeugzugriff.
SKILL.md entwerfen
Verwenden Sie YAML-Frontmatter mit einem in Kleinbuchstaben und mit Bindestrich geschriebenen name, der dem Ordner entspricht, und einer spezifischen description. Folgen Sie dem Format und den Fähigkeiten der Host-Plattform; gehen Sie nicht von optionalen Metadaten aus oder dass allowed-tools plattformübergreifend den Zugriff erzwingt.
Halten Sie den Körper schlank: Aufgabe und Grenzen, Eingaben, Entscheidungsverfahren, Stopp-/Fehlerbehandlung, Ausgabevertrag und nicht offensichtliche Fallstricke. Geben Sie einen Standardpfad anstelle eines Menüs mit gleichwertigen Alternativen. Geben Sie genaue Schritte für fragile Operationen an; lassen Sie Raum für begründetes Urteilsvermögen bei der Kontextauswahl. Vermeiden Sie es, dasselbe Verbot in jedem Abschnitt zu wiederholen oder die Antwort einer einmaligen Aufgabe als allgemeines Verfahren einzubetten.
Verschieben Sie umfangreiche Domain-Referenzen in fokussierte references/-Dateien und teilen Sie dem Agenten genau mit, wann er sie lesen soll. Fügen Sie wiederverwendbare Skripte für sich wiederholende deterministische Arbeiten nur hinzu, nachdem Sie deren Laufzeitabhängigkeiten und Validierungsverhalten bestätigt haben. Halten Sie Referenzen direkt von SKILL.md aus erreichbar und behaupten Sie nicht, dass ein Entwurf installiert, ausgeführt oder validiert wurde, wenn dies nicht der Fall ist.
Testen und überarbeiten
Beginnen Sie mit 2–3 repräsentativen Fällen, darunter einem Grenzfall; fügen Sie Fälle mit negativem Auslöser und adversariale Fälle hinzu, wenn die Fähigkeit auf nicht vertrauenswürdigen Inhalten reagiert oder wichtige Grenzen hat. Führen Sie neue Sitzungen mit und ohne die Fähigkeit oder im Vergleich zum vorherigen Entwurf durch. Bewerten Sie beobachtbare Ausgaben und Werkzeugverhalten, nicht wie ausgefeilt die Anweisungen klingen. Untersuchen Sie Traces auf unnötige Schritte, übersehene Beweise, Fehlaktivierungen und Scope Creep. Verwenden Sie Code für mechanische Überprüfungen; lassen Sie Menschen substanzielle Urteile überprüfen. Entfernen Sie Anweisungen, die Kosten verursachen, ohne einen echten Fehler zu verhindern.
Abnahmeprüfung
Bevor Sie antworten, vergewissern Sie sich, dass das vollständige angeforderte Artefakt tatsächlich vorhanden und in sich konsistent ist. Wenn der Benutzer das vollständige Markdown anfordert, liefern Sie die gesamte aktuelle SKILL.md, keine Patch-Fragmente. Wenn Sie eine Datei erstellen, vergewissern Sie sich, dass sie existiert und den vollständigen Entwurf enthält; melden Sie den ungetesteten Status ehrlich. Geben Sie kurz an, was sich geändert hat und welche Validierungsanforderungen noch bestehen. Verwenden Sie eine Anfrage für eine Fähigkeit nicht ohne klare Aufforderung in eine nicht zusammenhängende Suite.