Rapport d'avancement
Le reporting est une projection déterministe. Ne jamais générer, conserver, envoyer un message ou interroger un agent uniquement pour le maintenir. Enregistrez uniquement les faits d'assignation, de décision ou de blocage manquants.
Exécutez le CLI depuis la racine du dépôt : progress ci-dessous signifie python <répertoire du skill>/scripts/progress.py
(.claude/skills/progress-report, .agents/skills/progress-report, ou $CLAUDE_PLUGIN_ROOT/skills/progress-report).
Tapez la commande complète à chaque fois. Les verbes affichent une ligne (refresh n'affiche rien) ; relayez-la.
Quand l'utiliser
- Un fichier plan (Markdown avec éléments
- [ ]/- [x]) pilote le travail : mode plan, pas besoin de Spec Kit. - Une fonctionnalité Spec Kit a
specs/<fonctionnalité>/tasks.md: mode fonctionnalité ; les fichiers Workflow sont collectés lorsqu'ils sont présents.
Démarrage rapide en mode plan
progress hooks install --host claude(oucodex; ajoutez--scope userpour une installation de plugin) une fois, pour le modèle, l'effort, le contexte et les agents enfants. Ignorez-le et les tâches seront toujours suivies.progress init --plan docs/plan.mdcrée.progress/plan/(voir--name,--dir) et affichebind=<nonce>; le prochain hook se lie (hooks installen affiche un si un rapport existe).- Cochez les éléments dans le fichier plan ; le rapport suit. Progress n'écrit jamais le plan.
progress statusdonne l'état en une ligne ; la vue est.progress/plan/.view/index.html.
Les éléments conservent un identifiant écrit (T001) ; les autres reçoivent des identifiants stables P001... Avec un plan ou une fonctionnalité actif, aucun indicateur de cible n'est nécessaire ; sinon, passez --plan NOM ou --feature RÉP.
Verbes
| Besoin | Commande |
|---|---|
| Créer un rapport | progress init --plan CHEMIN [--name N] [--dir D] ou progress init (Spec Kit) |
| État en une ligne | progress status |
| Assigner une voie | progress lane L1 --tasks P001-P004 --owner ID --harness H --model M --effort E |
| Fermer une voie | progress lane L1 --close |
| Blocage | progress block P007 --by L2 (ou P003, ext:"texte") ; progress unblock B4 |
| Décision | progress decide ask "question" --options a,b ; progress decide made D2 b --by user |
| Note | progress note "texte" --target P005 |
| Exportation | progress export --format md |
| Hooks | `progress hooks install |
Règles
- Enregistrez une voie lorsque vous assignez du travail (
L#; les enfants hôteC#apparaissent d'eux-mêmes). Les démarrages, achèvements et tentatives n'ont besoin d'aucune commande. - Ne mettez jamais de secrets, chemins absolus ou texte de transcription dans une note (200 caractères maximum).
- Les valeurs inconnues restent inconnues. N'estimez pas le modèle, l'effort, le contexte ou le temps.
- Les erreurs s'affichent
progress: error CODE; corrigez la cause, ne réessayez pas en boucle.
Détails : references/verbs.md ; contrat docs/contracts.md ; indicateurs docs/commands.md.