diagnostiquer-probleme-azd

Imported from charlescstpierr/azdone (skills/diagnostiquer-probleme-azd/SKILL.md). Install upstream with npx skills add charlescstpierr/azdone --skill diagnostiquer-probleme-azd. Copyright stays with the author.

Étape 04 · Diagnostiquer le problème

Reproduire, isoler, prouver, puis s'arrêter au diagnostic.

Quick start

$diagnostiquer-probleme-azd "Le test checkout_cache_flaky échoue parfois en CI"

Artefact attendu: diagnosis.verdict: diagnose-only | blocked | failed, reproduction minimale, hypothesis ledger et root cause soutenue.

Utiliser quand

• un bug, incident, flaky test ou échec incertain existe;
• la cause n'est pas encore prouvée;
• une reproduction doit précéder toute correction.

Procédure

1. Reproduire (reproduce) l'échec avec le plus petit cas utile: commande, seed/env, input, expected, actual, timestamp et artifact.
2. Tenir un diagnosis_ledger reproductible où chaque tentative garde command, exit/status, output digest et lien artifact.
3. Tenir un hypothesis ledger avec au moins deux hypothèses concurrentes quand possible: prediction, falsification test, evidence et status open | falsified | supported | blocked.
4. Isoler (isolate) la root cause suspectée en changeant une variable à la fois et marquer explicitement les hypothèses falsifiées.
5. Obtenir de la fresh evidence pour chaque affirmation et séparer author_evidence de toute reviewer_evidence.
6. Séparer l'auteur du diagnostic et le reviewer éventuel, sans modifier le candidate code.
7. Si délégué à un sous-agent, suivre skills/azd/references/context-packet.md et model-routing.md pour le rôle correspondant.
8. Lier la cause aux nœuds affectés du Project Decision Graph et identifier la première hypothèse invalidée.
9. Rendre un verdict diagnose-only: reproduction, root cause prouvée ou cause la mieux soutenue, confiance, impact causal et blockers.

Sortie

Le skill rend diagnosis (diagnosis-output.md) avec les champs author_id, reviewer_id, reproduction, diagnosis_ledger, hypothesis_ledger, author_evidence, reviewer_evidence, root_cause, invalidated_assumption, graph_impact, confidence, evidence, verdict.

Arrêt et interdits

• Arrêter quand une cause est suffisamment prouvée pour être transférée à $planifier-travail-azd ou $construire-solution-azd, ou blocked si elle ne peut pas l'être.
• Ne pas corriger, refactorer ou planifier la remédiation dans ce skill. Ne pas produire de patch, fix-forward ou remediation steps; le transfert sortant est un paquet de diagnostic seulement.
• Fail closed si la reproduction est absente et que la cause n'est pas autrement prouvée.
• Fail closed si aucune hypothèse concurrente n'est falsifiée ou si l'auteur et le reviewer partagent la même evidence sans observation indépendante.
• Rapid : 0 sous-agent sauf justification écrite.

Répondre dans la langue de l'utilisateur. Commandes, chemins, identifiants, gates et verdicts restent identiques en français et en anglais.