Verwenden Sie diese Fähigkeit, wenn neue Funktionen, Workflows oder Tooling hinzugefügt werden.

Basis-Spezifikation - Die autoritative Basis-Spezifikation für die Wartung von Fähigkeiten ist Agent Skills Specification. - Wenn lokale Richtlinien und die Spezifikation abweichen, richten Sie die Fähigkeit anhand der Spezifikation aus, es sei denn, das Repository hat eine explizite, dokumentierte Ausnahme.

Wartungsregeln

1. Aktualisieren Sie eine bestehende Fähigkeit, wenn sich Verhaltensweisen oder Muster innerhalb des Domänenbereichs der Fähigkeit ändern.
2. Fügen Sie eine neue Fähigkeit nur hinzu, wenn die Änderung ein neues, nicht von bestehenden Fähigkeiten abgedecktes Domänenfeld einführt (z. B. ein neuer Tooltyp, Dateiformat oder Workflow-Paradigma).
3. Halten Sie die Frontmatter von SKILL.md gültig und passend zum Verzeichnisnamen.
4. Halten Sie die Anweisungen für die Fähigkeit prägnant und aufgabenorientiert.
5. Vermeiden Sie die Duplizierung von AGENTS.md; verweisen Sie darauf, wenn erforderlich.
6. Befolgen Sie die Richtlinien von AGENTS.md für designorientiertes, SOLID/DRY- und minimal-changes-orientiertes Vorgehen.
7. Bevorziehen Sie Single-Source-Referenzen: - package.json für Befehle/Einstellungen - AGENTS.md für gemeinsame Konventionen - README.md für benutzerorientiertes Verhalten - Verwenden Sie skill-lokale references/-Dokumente für domänen-spezifische Schemas und Beispiele (z. B. custom-views.md).
8. Denken und entwerfen Sie zunächst, bevor Sie die Dokumentation der Fähigkeit bearbeiten: definieren Sie Struktur und Besitz vorher.
9. Alle Quell-Datei- und Dokumentations-Referenzen in Markdown-Dokumenten/Skills müssen Markdown-Links verwenden.
10. Halten Sie die Struktur und Frontmatter der Fähigkeit kompatibel mit Agent Skills Specification (Name/Beschreibung-Einschränkungen, optionale Felder und Verzeichnis-Konventionen).
11. Bevorziehen Sie progressive Offenlegung aus der Spezifikation: halten Sie SKILL.md prägnant und platzieren Sie detailliertes Material in references/, wenn erforderlich.
12. Verwenden Sie relative Pfade für in-skill-Datei-Links, wie in File references definiert.

Konsistenz-Checkliste

• Fähigkeitsname: kleingeschrieben, durch Bindestriche getrennt, 1-64 Zeichen.
• Beschreibung: klare Anweisungen zum Einsatz (1-1024 Zeichen).
• Kompatibilität: nur, wenn Umgebungsbeschränkungen wichtig sind.
• Struktur: .claude/skills/<skill-name>/SKILL.md.

Aktualisierungsauslöser

• Neue Build-Test-Befehle.
• Neue Komponenten/Module mit einzigartigen Workflows.
• Neue repo-spezifische Muster oder Beschränkungen.

Qualitäts-Tore

• Keine veralteten Pfade oder Befehle.
• Anweisungen stimmen mit den aktuellen Codebase-Konventionen überein.
• Fähigkeiten vermeiden schwere Refaktorisierungen und halten Schritte minimal.
• Fähigkeiten bleiben kompatibel mit Agent Skills Specification.
• Prinzipien werden nicht über mehrere Fähigkeiten hinweg kopiert, wenn sie bereits in AGENTS.md existieren.