git-pr

Configuration Initiale

Authentification GitHub

Ce skill nécessite une authentification GitHub avec des scopes spécifiques.

Scopes Requis

| Scope | Description | Usage | |-------|-------------|-------| | repo | Accès complet aux repos | Création PR, lecture commits, gestion branches | | read:org | Lecture infos organisation | Récupération infos repository organisation | | read:project | Lecture projets GitHub | Liste et lecture des projets | | project | Écriture aux projets | Assignation PR aux projets | | gist | Gestion gists | Partage extraits de code si nécessaire |

Configuration Automatique (Recommandé)

bash scripts/gh_auth_setup.sh

Ce script configure automatiquement TOUS les scopes requis.

Configuration Manuelle

gh auth refresh --hostname github.com \
  -s repo \
  -s read:org \
  -s read:project \
  -s project \
  -s gist

Vérification

gh auth status

Sortie attendue:

Token scopes: 'gist', 'project', 'read:org', 'repo'

⚠️ Note: read:project n'apparaît pas toujours explicitement mais est inclus avec project.

Protection Contre les Oublis

Le skill vérifie automatiquement les scopes au démarrage (Étape 1.5).

Si un scope manque :

• ❌ Arrêt immédiat avec message d'erreur
• 📋 Liste des scopes manquants affichée
• 🔄 Commande de renouvellement suggérée

Format du Titre (Conventional Commits)

Le titre de la PR respecte le format Conventional Commits avec emoji, conforme à git/commands/commit.md.

Format Généré

emoji type(scope): description

Détection Automatique

| Nom de branche | Titre généré | |----------------|--------------| | feat/add-login | ✨ feat: add login | | fix/123-button-bug | 🐛 fix: [titre issue #123] | | feat/auth/oauth-support | ✨ feat(auth): oauth support | | refactor/api/cleanup | ♻️ refactor(api): cleanup | | random-branch | 🔧 chore: random branch |

Types et Emojis

Le mapping type → emoji utilise le script centralisé ${CLAUDE_PLUGIN_ROOT}/scripts/commit-emoji.sh.

Voir la documentation complète dans le README principal.

Scope Optionnel

Le scope est détecté si la branche suit le format type/scope/description :

• feat/auth/login → ✨ feat(auth): login
• fix/api/endpoint → 🐛 fix(api): endpoint

Utilisation

Via Slash Command

/git:pr <branche-base> [milestone] [projet] [--delete] [--no-review]

Via Skill Direct

ARGUMENTS="develop 1.0.0 TMA --delete" skill dev:git-pr

Dépannage

Erreur: "Scopes manquants"

❌ Scopes GitHub manquants: read:project project

Solution: Relancer gh_auth_setup.sh

Erreur: "Impossible de récupérer les projets"

Vérifier authentification:

gh auth status

Si scopes corrects mais erreur persiste:

# Forcer renouvellement
gh auth logout
bash scripts/gh_auth_setup.sh

Erreur: "your authentication token is missing required scopes"

Cause: Token obsolète ou scopes révoqués

Solution:

bash scripts/gh_auth_setup.sh

Cache Persistant

Le skill utilise un système de cache pour optimiser les performances.

Cache Milestones

Fichier: .claude/cache/git-milestones.json

Fonctionnalités:

• Stockage des milestones GitHub
• Recherche par titre exact ou alias
• Normalisation semver automatique (26 → 26.0.0)
• Génération d'aliases depuis titres (26.0.0 (Hotfix) → alias 26.0.0)

Refresh: Automatique si milestone introuvable

Cache Projets

Fichier: .claude/cache/git-projects.json

Fonctionnalités:

• Stockage des projets GitHub
• Recherche case-insensitive par titre ou alias
• Génération d'aliases depuis mots-clés (Bug Tracking → ["bug", "tracking"])

Refresh: Automatique si projet introuvable

Commandes Utiles

# Vider cache milestones
rm .claude/cache/git-milestones.json

# Vider cache projets
rm .claude/cache/git-projects.json

# Vider tout le cache
rm -rf .claude/cache/

Architecture

git-pr/
├── SKILL.md              # Définition du skill et workflow
├── README.md             # Cette documentation
├── scripts/
│   ├── gh_auth_setup.sh          # Configuration automatique auth
│   ├── verify_pr_template.sh
│   ├── smart_qa.sh
│   ├── analyze_changes.sh
│   ├── confirm_base_branch.py
│   ├── safe_push_pr.sh
│   ├── assign_milestone.py       # Assignation milestone avec cache
│   ├── milestone_cache.py        # Module cache milestones
│   ├── assign_project.py         # Assignation projet avec cache
│   ├── project_cache.py          # Module cache projets
│   └── cleanup_branch.sh
└── tests/
    ├── run_tests.sh              # Lance tous les tests
    ├── test_milestone_cache.py   # Tests unitaires milestones
    └── test_project_cache.py     # Tests unitaires projets

Maintenance

Ajout d'un Nouveau Scope

1. Modifier gh_auth_setup.sh:

   REQUIRED_SCOPES=(
       # ... scopes existants
       "nouveau_scope"  # Description
   )
   

2. Modifier SKILL.md section "Scopes Requis"

3. Mettre à jour ce README

Tests Unitaires

# Lancer tous les tests
bash tests/run_tests.sh

# Lancer un test spécifique
cd tests
python3 test_milestone_cache.py -v
python3 test_project_cache.py -v

Test de Consistance

Après modification:

# Tester le script
bash scripts/gh_auth_setup.sh

# Vérifier
gh auth status

# Tester assignation projet
python3 scripts/assign_project.py <pr-number> --project <nom>