LEÇON 10 / 06/11/2026
Objectif de cette leçon : vous saurez Numéro de version, journal des modifications, matrice de compatibilité et conditions de restauration Ajouté au dépôt Skill reference/liste-de-vérification-de-la-version.md, plutôt que de dire dans la discussion « je l'enverrai ce soir ». Dans la leçon précédente, vous avez déjà rédigé le contrat de coordination « computer-use » et défini les limites de « Harness » :https://school.myshirtai.com/?p=4478. Ce cours, qui va au-delà du contrat, traite deGestion des publications——Qui a modifié quoi, est-ce que ça fonctionne, comment procéder en cas de dysfonctionnement. Le format est celui d'un cours (documentation + exercices) ; comme l'exécution ne s'effectue pas localement mais via CI / Skills API, je ne vais pas écrire à la première personne pour indiquer que les chiffres fonctionnent.
S'il manque une liste de publication dans le référentiel, le système en ligne utilisera par défaut
dernière: N'importe qui peut remplacer la compétence utilisée par votre agent de production.
Prérequis et objectifs vérifiables
Veuillez d'abord terminer la leçon n° 9 intitulée « Intégrer les coordonnées du contrat d'utilisation de l'ordinateur et les limites de Harness dans la compétence » :https://school.myshirtai.com/?p=4478. Il faut au moins disposer : d'une compétence cible pouvant être chargée,référence/ Droits d'écriture ou possibilité de soumettre un PR, hook d'évaluation de la leçon 6 (les exemples d'échec peuvent être intégrés dans la régression). Pour revoir les bases antérieures, voir : leçon 1 https://school.myshirtai.com/archives/3378; Leçon n° 2 https://school.myshirtai.com/archives/3462; Leçon n° 3 https://school.myshirtai.com/archives/3521; Leçon n° 4 https://school.myshirtai.com/archives/3661; Leçon n° 5 https://school.myshirtai.com/?p=3948; Leçon n° 6 https://school.myshirtai.com/?p=4048; Leçon n° 7 https://school.myshirtai.com/?p=4191; Leçon n° 8 https://school.myshirtai.com/?p=4331.
Ce soir, je ne dispose que de 90 minutes pourUn Ajoutez la liste des publications à Skill, sans pour autant refondre l'ensemble des scripts.
- Objectif A :Envoyer
reference/liste-de-vérification-de-la-version.md(comprenant quatre volets : version, modifications, compatibilité et restauration). - Objectif B :Voici deux exemples d'échecs — omission du champ « version » et omission de la condition de rollback — qui peuvent être signalés par le hook d'évaluation de la leçon 6.
- Objectif C :Précisez dans la liste si « les références de production sont liées à un identifiant de version fixe / s'il est interdit de suivre automatiquement la dernière version ». Si l'API n'a pas été testée, il suffit d'indiquer « CI non exécuté en local ».
Concept : que faut-il préciser dans une liste de publication ?
Le cours n° 9 garantit l'exactitude des coordonnées des points. Le cours n° 10 précise que dès qu'une compétence (Skill) est placée dans un répertoire partagé ou dans l'API Skills, en cas d'absence de version ou de restauration, c'est « celui qui a effectué le dernier téléchargement qui a le dernier mot ». Dans la documentation publique, les compétences d'agent (Agent Skills) sont accompagnées de SKILL.md dossier ; lorsque la version est créée côté API, les téléchargements ultérieurs doivent conserver le même identifiant immuable nom, les versions sont identifiées par un identifiant unique ; il est également possible d'utiliser des littéraux dernière——C'est précisément là que la production nécessite une prise de décision explicite.
Cette liste n'est pas un énième article sur mes impressions concernant le fichier README, mais plutôt une liste de vérification avant la publication. Je recommande d'y inclure au moins quatre points :
- Version :Étiquettes d'entrepôt /
SKILL.mdChamp « Version interne » / « ID de version de l'API » : comment ces trois éléments s'alignent-ils ? - Journal des modifications :Cette modification concerne-t-elle la description, le script ou le contrat ? Quelles phrases déclencheuses sont concernées ?
- Compatibilité :Version du Claude Code / de l'API / du Harness / du contrat de coordonnées utilisée ; existe-t-il un conflit avec la déclaration « computer-use » de la leçon 9 ?
- Restauration :Quels sont les signaux d'échec, vers quel identifiant de version ou quelle balise Git faut-il revenir, et qui est autorisé à effectuer cette opération ?

Exercice : rédigez une liste de publication prête à être copiée-collée
Créer un nouvel élément sous la compétence ciblée reference/liste-de-vérification-de-la-version.md. Vous pouvez copier-coller directement le modèle ci-dessous, puis modifier les champs entre crochets ; ce bloc de code est uniquement destiné à un exercice de documentation et n'a pas été testé en environnement de production.
# Liste de contrôle de publication —
## Version
- balise Git :
- champ « version » du fichier SKILL.md :
- identifiant API « skill_id » / identifiant de version (si téléchargé) :
- identifiant de production : identifiant de version | dernière version (par défaut : identifiant PIN)
## Journal des modifications
- déclencheurs / description :
- scripts / référence :
- rupture de compatibilité ? oui/non — migration :
## Compatibilité
- Claude Code / interface API :
- Harness / contrat d’utilisation de l’ordinateur (leçon 9) :
- identifiant de la suite d’évaluation (leçon 6) :
## Retour en arrière
- signaux d’échec :
- retour en arrière vers :
- propriétaire / délai :
- s’arrêter si :
Liste des éléments à fournir : droits d'écriture ou PR ; ajout de deux cas d'utilisation de « contrôle d'accès à la publication » à l'ensemble d'évaluations de la leçon 6 ; insertion du résultat de la liste à cocher dans la description du PR. En l'absence d'incident réel en production, utilisez des exemples fictifs : modification de la description sans mise à jour de la version, la production continue de suivre dernière.

- Copier le modèle dans
reference/liste-de-vérification-de-la-version.md, remplir le champ « Skill » avec le caractère « 真 ». - Définir par défaut la « broche de production » sur un identifiant de version ou une balise Git spécifique, et interdire d'indiquer uniquement « latest ».
- Ajouter deux exemples d'échecs dans le répertoire d'évaluation de la leçon 6 (voir la section suivante).
- Cochez la liste des messages de relations publiques ; lors de l'évaluation, vérifiez uniquement si les quatre cases sont vides.
Exemples d'échecs et hook d'évaluation de la leçon 6
Les évaluations ne sont pas facultatives. La leçon n° 6 a déjà abordé l'utilisation d'un ensemble d'évaluations pour la régression ; cette leçon exige que la publication d'un contrôle d'accès puisse également être déclenchée par le même hook. Préparez-en au moins deux.devrait échouerExemple :
| Exemple | Qu'est-ce qui manque ? | Résultats attendus de l'évaluation |
|---|---|---|
| Version manquante | Pas de balise Git / Pas de champ « version » / Pas de pin | Feu rouge au contrôle d'accès, interdiction de s'insérer dans la file |
| Rétrocession en cas de fuite | Il existe un journal des modifications, mais aucun signal d'échec / retour en arrière vers | Feu rouge au contrôle d'accès, interdiction de s'insérer dans la file |
| Espace de compatibilité | Modification de « computer-use » sans référence au contrat de la leçon 9 | Avertissement ou feu rouge (à définir par l'équipe) |

Insérez le nom du fichier d'exemple dans la ligne « eval suite id » de la liste, par exemple evals/release-missing-version.md. Ainsi, le « hook » de la leçon 6 et le contrôle d'accès de la leçon 10 partagent les mêmes conventions de chemin d'accès, ce qui évite que les deux répertoires ne divergent.
Remarque :Cet article ne crée pas de version via l'API Skills sur la machine locale et n'exécute pas non plus le CI du dépôt. Les critères d'acceptation de l'exercice sont les suivants : « fichier de liste de contrôle + deux exemples d'échec + cases cochées dans la pull request » ; ne rédigez pas l'exercice de documentation en indiquant « déjà déployé en production ».
Aperçu de la prochaine leçon
Aperçu de la prochaine leçon (à confirmer) : Déploiement progressif et liste blanche MCP — Comment intégrer un identifiant de version fixe dans le trafic de déploiement progressif, et comment ajouter les appels d’outils à haut risque à la liste blanche et leur attribuer une période d’observation. Dans cette leçon, nous allons d’abord nous assurer que la liste des déploiements hors ligne et les signaux d’alerte d’évaluation fonctionnent correctement ; en l’absence de conditions de retour en arrière, le déploiement progressif ne ferait qu’aggraver l’ampleur des incidents.
Sommaire de cette série
- Leçon n° 1 : Créer en 30 minutes votre première compétence Claude Agent à déclenchement automatique — https://school.myshirtai.com/archives/3378
- Leçon n° 2 : Ajouter une référence à Skill / Boucle de vérification « rédiger le document de planification avant l'exécution » — https://school.myshirtai.com/archives/3462
- Leçon n° 3 : Skills avec script et audit de sécurité — https://school.myshirtai.com/archives/3521
- Leçon n° 4 : itération à partir de cas réels d'échec description — https://school.myshirtai.com/archives/3661
- Leçon n° 5 : Intégrer Skill au dépôt CI réel / au répertoire partagé de l'équipe — https://school.myshirtai.com/?p=3948
- Leçon n° 6 : Réalisation d'une régression pour une compétence à l'aide d'un ensemble d'évaluation — https://school.myshirtai.com/?p=4048
- Leçon n° 7 : Programmation multi-Skill : décomposition et fusion des limites, et arbitrage des conflits de déclenchement — https://school.myshirtai.com/?p=4191
- Leçon n° 8 : Intégrer le modèle « Task/sous-agent » dans une Skill : limites du parallélisme et isolation du contexte — https://school.myshirtai.com/?p=4331
- Leçon n° 9 : Intégrer le contrat de coordonnées « computer-use » et les limites « Harness » dans « Skill » — https://school.myshirtai.com/?p=4478
- Leçon n° 10 : Intégrer la liste de publication des Skill dans le dépôt : versions, journal des modifications, compatibilité et restauration (cet article)
Notre analyse :L'intérêt de publier une liste ne réside pas dans le fait qu'il s'agisse « d'un Markdown de plus », mais dans le fait qu'elle vous oblige à répondre aux questions relatives à la version, à la compatibilité et à la restauration avant la fusion. Fixer un identifiant de version et y joindre l'exemple d'échec de la leçon 6 est plus facile à valider que de dire simplement « attention à la dernière version ».
Liens utiles
- Claude Code Docs : Étendre les capacités de Claude
- Présentation des compétences des agents (normes ouvertes)
- GitHub : anthropics/skills
- Documentation de l'API Claude : versions des compétences
- Leçon n° 9 : Contrat de coordonnées « computer-use » et Harness
- Leçon n° 6 : Réalisation d'une régression pour « Skill » à l'aide d'un ensemble d'évaluation


评论列表 (0条):
加载更多评论 Chargement...