--- description: Suivre les changements du rapport des skills Claude Code et trouver ce qui doit être mis à jour argument-hint: [number of versions to check, default 10] --- # Workflow Changelog — Rapport Skills Tu es un coordinateur pour le projet claude-code-best-practice. Ta mission consiste à lancer un agent de recherche, attendre ses résultats et présenter un rapport sur la dérive du rapport **Skills Reference** (`best-practice/claude-skills.md`). Ce workflow vérifie exactement **deux types de dérive** : 1. **Champs de frontmatter** — tout champ ajouté ou supprimé dans la documentation officielle 2. **Skills officielles intégrées** — toute skill intégrée ajoutée ou supprimée **Versions à vérifier :** `$ARGUMENTS` (par défaut : 10 si vide ou non numérique) Il s’agit d’un workflow **lire puis rapporter**. Lance l’agent, fusionne les constats et produis un rapport. N’agis que si l’utilisateur approuve. --- ## Phase 1 : lancer l’agent de recherche Lance `workflow-claude-skills-agent` avec ce prompt : > Research the claude-code-best-practice project for skills report drift. Check the last $ARGUMENTS versions (default: 10). > > Fetch these 2 external sources: > 1. Skills Reference: https://code.claude.com/docs/en/skills > 2. Changelog: https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md > > Then read the local report (`best-practice/claude-skills.md`). > > Check for exactly two things: > 1. **Frontmatter fields**: Compare the official docs' supported skill frontmatter fields against the report's Frontmatter Fields table. Flag any fields that were added or removed. > 2. **Official bundled skills**: Compare the official docs' bundled skills list (and any new bundled skills mentioned in the changelog) against the report's official skills table. Flag any skills that were added or removed. --- ## Phase 2 : lire les entrées précédentes du changelog **Pendant que l’agent s’exécute**, lis `changelog/best-practice/claude-skills/changelog.md` pour obtenir les 25 dernières entrées. Analyse les actions prioritaires afin d’identifier : - **Éléments récurrents** — problèmes déjà apparus et encore non résolus - **Nouveaux éléments** — problèmes apparaissant pour la première fois - **Éléments résolus** — problèmes signalés précédemment et désormais corrigés --- ## Phase 3 : générer le rapport **Attends que l’agent termine.** Produis un rapport avec ces sections : 1. **Frontmatter Field Changes** — Champs ajoutés ou supprimés dans la documentation officielle par rapport à notre rapport 2. **Official Bundled Skill Changes** — Skills intégrées ajoutées ou supprimées par rapport à notre tableau Termine par un tableau récapitulatif priorisé **Action Items**. Chaque élément doit inclure une colonne `Status` indiquant `NEW`, `RECURRING (first seen: )` ou `RESOLVED` : ```markdown Priority Actions: # | Type | Action | Status 1 | New Field | Add to frontmatter table | NEW 2 | Removed Field | Remove from table | RECURRING (first seen: ) 3 | New Skill | Add to official skills table | NEW 4 | Removed Skill | Remove from table | NEW ``` Inclus aussi une section **Resolved Since Last Run** listant les éléments des exécutions précédentes qui ne sont plus des problèmes. --- ## Phase 3.5 : ajouter le résumé au changelog **Cette phase est OBLIGATOIRE — exécute-la toujours avant de présenter le rapport à l’utilisateur.** Lis le fichier `changelog/best-practice/claude-skills/changelog.md` existant, puis **ajoute** (ne remplace PAS) une nouvelle entrée à la fin. Le format de l’entrée doit être exactement : ```markdown --- ## [] Claude Code v | # | Priority | Type | Action | Status | |---|----------|------|--------|--------| | 1 | HIGH/MED/LOW | | | | | ... | ... | ... | ... | ... | ``` **Format de statut — DOIT utiliser l’un de ces trois formats :** - `COMPLETE (reason)` — l’action a été réalisée et résolue avec succès - `INVALID (reason)` — le constat était incorrect, non applicable ou intentionnel - `ON HOLD (reason)` — action différée, en attente d’une dépendance externe ou d’une décision utilisateur Le `(reason)` est obligatoire et doit expliquer brièvement ce qui a été fait ou pourquoi. **Règles d’ajout :** - Toujours ajouter — ne jamais écraser ou remplacer les entrées précédentes - La date et l’heure correspondent à l’exécution de la commande en Pakistan Standard Time (PKT, UTC+5) ; obtiens-les avec `TZ=Asia/Karachi date "+%Y-%m-%d %I:%M %p PKT"`. La version vient des constats de l’agent - Si `changelog/best-practice/claude-skills/changelog.md` n’existe pas ou est vide, crée-le avec le tableau Status Legend (voir le haut du fichier), puis la première entrée - Chaque entrée est séparée par `---` - **Inclure uniquement les éléments de priorité HIGH, MEDIUM ou LOW** — omettre les éléments de priorité NONE --- ## Phase 3.6 : mettre à jour le badge Last Updated **Cette phase est OBLIGATOIRE — exécute-la toujours immédiatement après la Phase 3.5, avant de présenter le rapport.** Mets à jour le badge "Last Updated" en haut de `best-practice/claude-skills.md`. Exécute `TZ=Asia/Karachi date "+%b %d, %Y %-I:%M %p PKT"` pour obtenir l’heure, encode-la pour URL (espaces en `%20`, virgules en `%2C`) et remplace la portion date du badge. Mets aussi à jour la version Claude Code dans le badge si elle a changé. **Ne journalise PAS les mises à jour de badge comme action items dans le changelog ou le rapport.** La synchronisation du badge est une routine de chaque exécution, pas un constat. --- ## Phase 4 : proposer d’agir Après avoir présenté le rapport (et confirmé que le changelog et le badge ont été mis à jour), demande à l’utilisateur : 1. **Execute all actions** — Appliquer tous les changements 2. **Execute specific actions** — L’utilisateur choisit les numéros à exécuter 3. **Just save the report** — Aucun changement Pendant l’exécution : - **Nouveaux champs** : ajouter au tableau Frontmatter Fields avec le type, le statut obligatoire et la description corrects depuis la documentation officielle - **Champs supprimés** : confirmer avec l’utilisateur avant suppression - **Nouvelles skills** : ajouter au tableau des skills officielles avec #, nom de skill et description corrects - **Skills supprimées** : confirmer avec l’utilisateur avant suppression - Après tout ajout ou suppression, mettre à jour le nombre dans les titres `## Frontmatter Fields (N)` et `## ![Official](...) **(N)**` --- ## Règles critiques 1. **Ne jamais deviner** les versions ou dates — utiliser les données de l’agent 2. **Croiser les nombres de champs** — le nombre de champs du rapport doit correspondre à la documentation officielle 3. **Croiser les nombres de skills** — le nombre de skills du rapport doit correspondre à la documentation officielle 4. **Ne pas auto-exécuter** — toujours présenter le rapport d’abord 5. **TOUJOURS ajouter au changelog** — la Phase 3.5 est obligatoire. Ne jamais la sauter. Ne jamais écraser les entrées précédentes. 6. **TOUJOURS mettre à jour le badge Last Updated** — la Phase 3.6 est obligatoire. Ne jamais la sauter. 7. **Comparer avec les exécutions précédentes** — lire les 25 dernières entrées du changelog et marquer chaque action item comme NEW, RECURRING ou RESOLVED. 8. **Distinguer intégré d’installable** — suivre uniquement les skills fournies avec Claude Code (intégrées). Ne pas suivre les skills de l’Official Skills Repository (github.com/anthropics/skills) — elles sont installables, pas intégrées.