traduction
This commit is contained in:
@@ -0,0 +1,136 @@
|
||||
---
|
||||
description: Suivre les changements du rapport des sous-agents Claude Code et trouver ce qui doit être mis à jour
|
||||
argument-hint: [number of versions to check, default 10]
|
||||
---
|
||||
|
||||
# Workflow Changelog — Rapport Subagents
|
||||
|
||||
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 **Subagents Reference** (`best-practice/claude-subagents.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. **Sous-agents officiels** — tout agent intégré ajouté ou supprimé
|
||||
|
||||
**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-subagents-agent` avec ce prompt :
|
||||
|
||||
> Research the claude-code-best-practice project for subagents report drift. Check the last $ARGUMENTS versions (default: 10).
|
||||
>
|
||||
> Fetch these 2 external sources:
|
||||
> 1. Sub-agents Reference: https://code.claude.com/docs/en/sub-agents
|
||||
> 2. Changelog: https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
|
||||
>
|
||||
> Then read the local report (`best-practice/claude-subagents.md`).
|
||||
>
|
||||
> Check for exactly two things:
|
||||
> 1. **Frontmatter fields**: Compare the official docs' supported frontmatter fields table against the report's Frontmatter Fields table. Flag any fields that were added or removed.
|
||||
> 2. **Official sub-agents**: Compare the official docs' built-in subagents list against the report's official agents table. Flag any agents 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-subagents/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 Sub-agent Changes** — Agents intégrés ajoutés ou supprimés 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: <date>)` ou `RESOLVED` :
|
||||
|
||||
```markdown
|
||||
Priority Actions:
|
||||
# | Type | Action | Status
|
||||
1 | New Field | Add <field> to frontmatter table | NEW
|
||||
2 | Removed Field | Remove <field> from table | RECURRING (first seen: <date>)
|
||||
3 | New Agent | Add <agent> to official agents table | NEW
|
||||
4 | Removed Agent | Remove <agent> 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-subagents/changelog.md` existant, puis **ajoute** (ne remplace PAS) une nouvelle entrée à la fin. Le format de l’entrée doit être exactement :
|
||||
|
||||
```markdown
|
||||
---
|
||||
|
||||
## [<YYYY-MM-DD HH:MM AM/PM PKT>] Claude Code v<VERSION>
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH/MED/LOW | <type> | <action description> | <status> |
|
||||
| ... | ... | ... | ... | ... |
|
||||
```
|
||||
|
||||
**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-subagents/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-subagents.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
|
||||
- **Nouveaux agents** : ajouter au tableau des agents officiels avec #, nom, modèle, outils et description corrects
|
||||
- **Agents supprimés** : confirmer avec l’utilisateur avant suppression
|
||||
|
||||
---
|
||||
|
||||
## 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 d’agents** — le nombre d’agents 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.
|
||||
Reference in New Issue
Block a user