Versionner et deprecier
Semver, changelog, deprecation 90 jours, rollback, et gestion des dependencies entre skills.
Un skill en production evolue. Le versionning semantique, le changelog, et le protocole de deprecation garantissent la stabilite.
Versioning semantique
Ajoute la version dans le frontmatter :
metadata:
version: 1.2.0| Type | Quand | Exemple |
|---|---|---|
| PATCH (0.0.X) | Typo, clarification, reformulation | 1.0.0 vers 1.0.1 |
| MINOR (0.X.0) | Nouvelle regle, nouveau pattern, ajout | 1.0.1 vers 1.1.0 |
| MAJOR (X.0.0) | Restructuration, changement de comportement | 1.1.0 vers 2.0.0 |
Un PATCH ne change pas le comportement. Un MINOR ajoute sans casser. Un MAJOR peut casser la compatibilite.
Changelog
Chaque version a une entree dans le changelog du skill :
### v1.2.0 -- 2026-04-04
- Ajoute : template Reference API
- Modifie : description pour meilleur triggering
- Corrige : formule de scoring dans review| Regle | Detail |
|---|---|
| Date au format ISO 8601 | YYYY-MM-DD |
| 4 categories max | Ajoute, Modifie, Supprime, Corrige |
| 1 ligne par changement | Pas de paragraphes |
| Plus recent en haut | Ordre chronologique inverse |
Protocole de deprecation
Ne supprime jamais un skill sans prevenir
Un skill deprecie reste accessible 90 jours. Les dependances doivent migrer avant la suppression.
| Etape | Action |
|---|---|
| 1 | Ajouter deprecated: true dans le frontmatter |
| 2 | Ajouter en haut du body : "Ce skill est remplace par [X]. Utilise [X] a la place." |
| 3 | Garder le skill 90 jours avant suppression |
| 4 | Mettre a jour les dependances (skills qui referent a celui-ci) |
Rollback
Si une mise a jour casse quelque chose :
git revert [commit-hash]Le skill revient a la version precedente instantanement. Le rollback est toujours preferable a un correctif hasardeux.
Dependencies entre skills
Si un skill requiert un autre skill, documente-le dans le frontmatter :
metadata:
dependencies: [self-improve, doc-writer-agent]Avant de deprecier un skill, verifie qu'aucun autre skill n'en depend. Les dependances cassees sont le premier facteur de regression.
Monitoring post-deploy
Dans les 7 jours suivant un deploy, verifie :
| Check | Question |
|---|---|
| Triggering | Le skill trigger-t-il sur les bonnes queries ? (5 tests manuels) |
| Satisfaction | Le score de satisfaction est-il stable ? |
| Edge cases | Des cas non prevus sont-ils apparus ? |
Lecture liee
- Les 13 pieges a eviter -- erreurs courantes en phase d'evolution
- Lifecycle complet -- ou l'evolution s'inscrit dans le cycle
- Iterer avec 3 agents -- la boucle qui precede l'evolution