# Cpn Pr Triage

> À utiliser quand vous triez une PR existante de cloud-pi-native/console : labels, assignee, jalon, reviewers, lien issue.

- Skill: `shikanime-labs/cpn-pr-triage` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add shikanime-labs/cpn-pr-triage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shikanime-labs/cpn-pr-triage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- License: Apache-2.0
- Author: shikanime-labs (https://skillmd.com/u/shikanime-labs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/shikanime-labs/cpn-pr-triage

---


# CPN PR Triage

Renseigner les champs **vides** et **déterminables du contenu** (FR). Ne jamais
inventer ; ne jamais fermer de PR.

## Prerequisites

- `gh` collaborateur du dépôt, ne PAS `gh auth switch`.
- Dépôt : `cloud-pi-native/console`. `N` = n° PR, `R` = ce dépôt (défaut).

## 1. Récupérer

```bash
gh pr view "$N" --repo "$R" --json number,title,body,labels,assignees,milestone,reviewRequests
```

## 2. Métadonnées dispo (source de vérité)

```bash
gh label list --repo "$R" --limit 200 --json name,description
gh api repos/"$R"/milestones?state=open --jq '.[] | "\(.number)\t\(.title)"'
gh project list --owner cloud-pi-native
gh api repos/"$R"/assignees --jq '.[].login'
```

## 3. Décider (si vide + valeur existante)

- **labels** — titre/corps : défaut→`bug`, capacité→`enhancement`,
  doc→`documentation`. Type via template ; zone depuis chemins si existant ;
  écarter les absents de l'étape 2.
- **assignee** — si aucun : `ASSIGNEE=$(gh api user --jq .login)`.
- **jalon** — bug→patch le plus haut de la ligne mineure courante (max `Z`) ;
  enhancement→mineure/majeure suivante.
- **projet** — `--add-project <number>` si boardé et pas boardé ; sinon sauter.
- **reviewers** — un reviewer parmi collaborateurs/équipe si aucune demande ;
  sinon sauter.

## 4. Appliquer

```bash
gh pr edit "$N" --repo "$R" --add-label "bug" --add-label "area/..."
# --add-label, jamais --label
gh pr edit "$N" --repo "$R" --add-assignee "$ASSIGNEE"
gh pr edit "$N" --repo "$R" --milestone <num>
gh pr edit "$N" --repo "$R" --add-reviewer <login>
```

## 5. Lier issue ↔ PR

Si `#M` (issue ouverte, pas liée) est référencée, garantir `Issues liées: #M`
dans le corps (éditer, préfixer si absent).

## 6. Vérifier

```bash
gh pr view "$N" --repo "$R" --json number,title,labels,assignees,milestone,reviewRequests
```

## 7. Reword / reconciliation corps↔diff

Quand on demande de **reformuler** le titre ou le corps d'une PR (après
force-push, changement de périmètre, ou « reword it based on new changes »), ne
pas recopier le corps existant avec des retouches : il dérive du code.

1. `gh pr diff "$N" --repo "$R"` — le diff réel (source de vérité du
   comportement).
2. `gh api repos/"$R"/pulls/"$N"/files --jq '.[] | "\(.filename)\tadd=\(.additions)\tdel=\(.deletions)"'`
   — comptes par fichier.
3. Recomparer chaque affirmation du corps contre le diff :
   - **Claim absent** du diff → supprimer (ex. « j'ai ajouté `max-parallel: 2` »
     alors que `strategy`/`matrix` n'a pas changé).
   - **Correctif réel minimisé** (ex. « simple typo d'hygiène » alors que le
     diff change aussi le port `8080`→`9000`, le vrai fix d'une issue) → élever
     et lier l'issue concernée (#M).
4. `gh pr edit "$N" --repo "$R" --title "..." --body-file /tmp/pr_body.md`.

Détail et exemple de trap : `references/pr-body-reconciliation.md`.

## Pitfalls

- Inventer des labels — filtrer contre `gh label list`.
- Écrasement — `--add-label` / `--add-assignee` (additif), jamais `--label`.
- Jalon — bug→patch courant, feature→release suivante.
- Fermer une PR — interdit ; PR parasite → `cpn-pr` ou retour auteur.
- Auto-close issue↔PR — interdit ; fermer délibérément après N-sur-N.
- Corps hors-diff — un corps de PR dérive du code (claim absent du diff, ou
  correctif réel minimisé en « typo/hygiene »). Toujours recomparer contre
  `gh pr diff` avant de rééditer un titre/corps. Voir étape 7.

## See also

- `cpn-pr` — création + liaison (français).