Configuration de sortie

IMPORTANT : Cette commande génère un résumé de compréhension structuré et nécessite un format de sortie spécifique.

Lis le frontmatter de cette commande. Si un champ output-style est présent, exécute immédiatement :

/output-style <valeur-du-champ>

Note : Une fois que le champ output-style sera supporté nativement par Claude Code, cette instruction pourra être supprimée.

Objectif

Phase 1 du workflow automatisé : comprendre le besoin utilisateur SANS interaction.

Feature demandée (depuis Issue GitHub)

Récupérée depuis .claude/data/workflows/issue-${issue_number}-dev-workflow-state.json (Phase 0)

Titre : issue.title Description : issue.description Labels : issue.labels

Mode automatique (zéro checkpoint)

Ce skill exécute la phase 0 en mode AUTOMATIQUE :

• Pas de demande de confirmation
• Validation auto de la clarté
• FAIL si ambiguïté critique

Instructions

1. Analyser la demande

Déterminer le chemin du workflow state :

# Récupérer issue_number depuis le workflow state créé en Phase 0
# Note: si issue_number est disponible en contexte, l'utiliser directement
workflow_state_file=".claude/data/workflows/issue-${issue_number}-dev-workflow-state.json"

• Lire le workflow state
• Récupérer issue.title et issue.description
• Évaluer la clarté et la complétude du contenu de l'issue
• Si la demande est claire → continuer
• Si la demande contient une ambiguïté critique (ex: "Ajouter auth" sans préciser OAuth/Basic/JWT) → FAIL immédiatement avec message explicite :

  ❌ Description de l'issue trop ambiguë pour mode auto.
  
  Issue #123 : "Ajouter auth"
  
  Précise le contexte manquant dans l'issue GitHub :
  - Authentification ? (OAuth? JWT? Basic Auth?)
  - Intégration? (Quel service? Quel provider?)
  - Scope? (Utilisateurs? Admin? Tous?)
  
  Édite l'issue et relance le workflow.
  

  Exit code: 1

2. Explorer le contexte

• Chercher si des fichiers similaires existent déjà dans le projet
• Lire CLAUDE.md et .ai/ pour comprendre les conventions
• Identifier les patterns architecturaux utilisés

3. Résumer la compréhension

Présenter un résumé structuré basé sur l'issue GitHub :

📋 Résumé de la demande

**Issue :** #123 : {issue.title}

**Problème résolu :**
{résumé de issue.description}

**Labels :** {issue.labels}

**Contexte technique :**
- {pattern existant pertinent}
- {fichiers existants liés}

4. Validation automatique

✅ PAS de checkpoint utilisateur - valider automatiquement et continuer

Mise à jour du workflow state

Le fichier .claude/data/workflows/issue-${issue_number}-dev-workflow-state.json a été créé en Phase 0 avec les infos de l'issue.

Mettre à jour la section phases pour enregistrer la complétion de Phase 1 :

{
  "mode": "auto",
  "issue": {
    "number": {issue number},
    "title": "{issue.title}",
    "description": "{issue.description}",
    "labels": "{issue.labels}",
    "state": "OPEN",
    "fetchedAt": "{ISO timestamp}"
  },
  "feature": "{issue.title}",
  "status": "in_progress",
  "currentPhase": 1,
  "phases": {
    "0": {
      "status": "completed",
      "completedAt": "{Phase 0 timestamp}",
      "durationMs": {Phase 0 duration}
    },
    "1": {
      "status": "completed",
      "completedAt": "{ISO timestamp}",
      "durationMs": {durée}
    }
  }
}

Règles

• ❌ Pas de checkpoint utilisateur
• ✅ Fail fast si ambiguïté critique
• ✅ Valider automatiquement si description claire
• ❌ Ne PAS proposer d'architecture
• ✅ Se concentrer sur la COMPRÉHENSION du besoin