Aktivierungsvertrag
Verwende diesen Skill, nachdem Skills installiert, entfernt, erstellt, verschoben oder umbenannt wurden, oder wenn ein Delegator einen frischen Skill‑Index benötigt.
Harte Regeln
- Die Registrierung ist ein Index, keine Kompilation oder Zusammenfassung.
SKILL.mdbleibt die Quelle der Wahrheit. - Keine kompakten Regeln standardmäßig erzeugen oder einfügen; bewahre die Absicht des Autors, indem du genaue Skill‑Pfade an Unteragenten weitergibst.
.atl/skill-registry.mdimmer schreiben, unabhängig vom SDD-Persistenzmodus.- Die Registrierung in Engram als
topic_key: skill-registryspeichern, wenn verfügbar, mitcapture_prompt: false. sdd-*,_sharedundskill-registryüberspringen; nach Skill‑Namen deduplizieren, wobei Projekt‑Skills Vorrang vor Benutzer‑Skills haben..atl/zu.gitignorehinzufügen, wenn möglich, es sei denn, es ist ausdrücklich deaktiviert.
Entscheidungstabelle
| Situation | Aktion |
|---|---|
| Gleicher Skill existiert global und im Projekt | Behalte den Skill auf Projektebene |
| Gleicher Skill existiert an mehreren globalen Orten | Behalte die erste Quelle in der Scan‑Reihenfolge |
| Keine Skills gefunden | Schreibe eine leere Registrierung, damit Agenten nicht blind weitersuchen |
| Agent wird Arbeit delegieren | Wähle passende Registrierungszeilen aus und übergib ihre SKILL.md-Pfade |
Ausführungsschritte
- Scanne alle bekannten Benutzer‑ und Projekt‑Skill‑Verzeichnisse nach
*/SKILL.md. - Lese nur bei Bedarf das Frontmatter, um Name und Beschreibung als Auslösetext zu extrahieren.
- Erstelle
.atl/skill-registry.mdmit den gescannten Quellen, dem Registrierungsvertrag, Skill‑Name, Auslöser/Beschreibung, Bereich und exaktem Pfad. - Persistiere in Engram, wenn verfügbar, mit
title: skill-registry,topic_key: skill-registry,type: configundcapture_prompt: false. - Gib den Registrierungspfad, die Anzahl der Skills, den Cache‑Status und zurück, ob Engram aktualisiert wurde.
Ausgabevertrag
Gib zurück:
- Projektname und Pfad zu
.atl/skill-registry.md. - Anzahl der indizierten Skills.
- Ob der Cache getroffen oder neu erstellt wurde.
- Alle übersprungenen oder doppelten Skills, falls relevant.
Referenzen
docs/skill-style-guide.md– wie Skills vor der Indizierung verfasst werden sollten.skills/_shared/skill-resolver.md– wie Delegatoren den Index verwenden.