Contrat d'activation
Utilisez cette compétence après avoir installé, supprimé, créé, déplacé ou renommé des compétences, ou lorsqu'un délégateur a besoin d'un index de compétences frais.
Règles strictes
- Le registre est un index, pas un compilateur ou un résumé.
SKILL.mdreste la source de vérité. - Ne générez pas et n'injectez pas de règles compactes par défaut ; préservez l'intention de l'auteur en passant les chemins exacts des compétences aux sous-agents.
- Écrivez toujours
.atl/skill-registry.mdquel que soit le mode de persistance SDD. - Sauvegardez le registre dans l'Engram avec
topic_key: skill-registrylorsque disponible, aveccapture_prompt: false. - Ignorez
sdd-*,_sharedetskill-registry; dédupliquez par nom de compétence, en privilégiant les compétences de niveau projet par rapport aux compétences de niveau utilisateur. - Ajoutez
.atl/à.gitignorelorsque possible, sauf si explicitement désactivé.
Portes de décision
| Situation | Action |
|---|---|
| Même compétence existe au niveau global et dans le projet | Conserver la compétence de niveau projet |
| Même compétence existe à plusieurs emplacements globaux | Conserver la première source dans l'ordre de scan |
| Aucune compétence trouvée | Écrire un registre vide pour que les agents cessent de chercher aveuglément |
| L'agent va déléguer du travail | Sélectionner les lignes correspondantes dans le registre et passer leurs chemins SKILL.md |
Étapes d'exécution
- Scanner tous les répertoires de compétences utilisateur et projet connus pour
*/SKILL.md. - Lire uniquement le frontmatter si nécessaire pour extraire le texte de déclencheur
nameetdescription. - Générer
.atl/skill-registry.mdavec les sources scannées, le contrat du registre, le nom de la compétence, le déclencheur/description, la portée et le chemin exact. - Persister dans l'Engram lorsque disponible avec
title: skill-registry,topic_key: skill-registry,type: configetcapture_prompt: false. - Retourner le chemin du registre, le nombre de compétences, l'état du cache et si l'Engram a été mis à jour.
Contrat de sortie
Retourner :
- Le nom du projet et le chemin
.atl/skill-registry.md. - Le nombre de compétences indexées.
- Indiquer si le cache a été utilisé ou régénéré.
- Toute compétence ignorée ou en double, le cas échéant.
Références
docs/skill-style-guide.md— comment les compétences doivent être rédigées avant l'indexation.skills/_shared/skill-resolver.md— comment les délégateurs utilisent l'index.