# Issue Triage > Issue Triage - Skill: `florianbruniaux-ccboard/issue-triage-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add florianbruniaux-ccboard/issue-triage-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/florianbruniaux-ccboard/issue-triage-2/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: FlorianBruniaux (https://skillmd.com/u/florianbruniaux-ccboard) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/florianbruniaux-ccboard/issue-triage-2 --- # Issue Triage ## Quand utiliser | Skill | Usage | Output | |-------|-------|--------| | `/issue-triage` | Trier, analyser, commenter les issues | Tableaux d'action + deep analysis + commentaires postés | **Declencheurs** : - Manuellement : `/issue-triage` ou `/issue-triage all` ou `/issue-triage 42 57` - Proactivement : quand >10 issues ouvertes sans triage, ou issue stale >30j detectee --- ## Langue - Verifier l'argument passe au skill - Si `en` ou `english` -> tableaux et resume en anglais - Si `fr`, `french`, ou pas d'argument -> francais (defaut) - Note : les commentaires GitHub (Phase 3) restent TOUJOURS en anglais (audience internationale) --- Workflow en 3 phases : audit automatique -> deep analysis opt-in -> commentaires avec validation obligatoire. ## Preconditions ```bash git rev-parse --is-inside-work-tree gh auth status ``` Si l'un echoue, stop et expliquer ce qui manque. --- ## Phase 1 -- Audit (toujours executee) ### Data Gathering (commandes en parallele) ```bash # Identite du repo gh repo view --json nameWithOwner -q .nameWithOwner # Issues ouvertes avec metadonnees completes gh issue list --state open --limit 100 \ --json number,title,author,createdAt,updatedAt,labels,assignees,body,comments # PRs ouvertes (pour cross-reference) gh pr list --state open --limit 50 --json number,title,body # Issues fermees recemment (pour detection doublons) gh issue list --state closed --limit 20 \ --json number,title,labels,closedAt # Collaborateurs (pour proteger les issues des mainteneurs) gh api "repos/{owner}/{repo}/collaborators" --jq '.[].login' ``` **Fallback collaborateurs** : si `gh api .../collaborators` echoue (403/404) : ```bash gh pr list --state merged --limit 10 --json author --jq '.[].author.login' | sort -u ``` Si toujours ambigu, demander a l'utilisateur via `AskUserQuestion`. **Note** : `author` est un objet `{login: "..."}` -- toujours extraire `.author.login`. ### Analyse -- 6 dimensions **1. Categorisation** (labels existants > inference titre/body) : - **Bug** : mots-cles `crash`, `error`, `fail`, `broken`, `regression`, `wrong`, `unexpected`, `panic`, `404`, `404` - **Feature** : `add`, `implement`, `support`, `new`, `feat:` - **Enhancement** : `improve`, `optimize`, `better`, `enhance`, `refactor` - **Question/Support** : `how`, `why`, `help`, `unclear`, `docs`, `documentation` - **Duplicate Candidate** : voir dimension 3 ci-dessous **2. Cross-ref PRs** : - Scanner `body` de chaque PR ouverte pour `fixes #N`, `closes #N`, `resolves #N` (case-insensitive, regex) - Construire un map : `issue_number -> [PR numbers]` - Une issue liee a une PR mergee -> recommander fermeture **3. Detection doublons** : - Normaliser les titres : lowercase, strip prefixes (`bug:`, `feat:`, `[bug]`, `[feature]`, etc.) - **Jaccard sur mots des titres** : si score > 60% entre deux issues -> candidat doublon - **Keywords body overlap** > 50% -> renforcement du signal - Comparer aussi avec issues fermees recentes (20 dernieres) - Un faux positif peut etre confirme/ecarte en Phase 2 **4. Classification risque** : - **Rouge** : mots-cles `CVE`, `vulnerability`, `injection`, `auth bypass`, `security`, `exploit`, `unsafe`, `credentials`, `leak`, `RCE`, `XSS`, `panic`, `data loss` - **Jaune** : `breaking change`, `migration`, `deprecation`, `remove API`, `breaking`, `incompatible`, `regression` - **Vert** : tout le reste **5. Staleness** : - >30j sans activite (updatedAt) -> **Stale** - >90j sans activite -> **Very Stale** - Calculer depuis la date actuelle **6. Recommandations d'action** : - `Accept & Prioritize` : issue claire, reproducible, dans scope - `Label needed` : issue sans label - `Comment needed` : info manquante, body insuffisant - `Linked to PR` : une PR ouverte reference cette issue - `Duplicate candidate` : candidat doublon identifie (preciser avec `#N`) - `Close candidate` : stale + aucune activite recente, ou hors scope (jamais si auteur est collaborateur) - `PR merged -> close` : PR liee est mergee, issue encore ouverte ### Output -- 5 tableaux ``` ## Issues ouvertes ({count}) ### Critiques (risque rouge) | # | Titre | Auteur | Age | Labels | Action | | - | ----- | ------ | --- | ------ | ------ | ### Liees a une PR | # | Titre | Auteur | PR(s) liee(s) | Status PR | Action | | - | ----- | ------ | ------------- | --------- | ------ | ### Actives | # | Titre | Auteur | Categorie | Age | Labels | Action | | - | ----- | ------ | --------- | --- | ------ | ------ | ### Doublons candidats | # | Titre | Doublon de | Similarite | Action | | - | ----- | ---------- | ---------- | ------ | ### Stale | # | Titre | Auteur | Derniere activite | Action | | - | ----- | ------ | ----------------- | ------ | ### Resume - Total : {N} issues ouvertes - Critiques : {N} (risque securite ou breaking) - Liees a PR : {N} - Doublons candidats : {N} - Stale (>30j) : {N} | Very Stale (>90j) : {N} - Sans labels : {N} - Quick wins (a fermer ou labeler rapidement) : {liste} ``` 0 issues -> afficher `Aucune issue ouverte.` et terminer. **Note** : `Age` = jours depuis `createdAt`, format `{N}j`. Si >30j, afficher en **gras**. ### Copie automatique Apres affichage du tableau de triage, copier dans le presse-papier : ```bash pbcopy <<'EOF' {tableau de triage complet} EOF ``` Confirmer : `Tableau copie dans le presse-papier.` (FR) / `Triage table copied to clipboard.` (EN) --- ## Phase 2 -- Deep Analysis (opt-in) ### Selection des issues **Si argument passe** : - `"all"` -> toutes les issues ouvertes - Numeros (`"42 57"`) -> uniquement ces issues - Pas d'argument -> proposer via `AskUserQuestion` **Si pas d'argument**, afficher : ``` question: "Quelles issues voulez-vous analyser en profondeur ?" header: "Deep Analysis" multiSelect: true options: - label: "Toutes ({N} issues)" description: "Analyse approfondie de toutes les issues avec agents en parallele" - label: "Critiques uniquement" description: "Focus sur les {M} issues a risque rouge/jaune" - label: "Doublons candidats" description: "Confirmer ou ecarter les {K} doublons detectes" - label: "Stale uniquement" description: "Decision close/keep sur les {J} issues stale" - label: "Passer" description: "Terminer ici -- juste l'audit" ``` Si "Passer" -> fin du workflow. ### Execution de l'analyse Pour chaque issue selectionnee, lancer un agent via **Task tool en parallele** : ``` subagent_type: general-purpose model: sonnet prompt: | Analyze GitHub issue #{num}: "{title}" by @{author} **Metadata**: Created {createdAt}, last updated {updatedAt}, labels: {labels} **Body**: {body} **Existing comments** ({comments_count} total, showing last 5): {last_5_comments} **Context**: - Linked PRs: {linked_prs or "none"} - Duplicate candidate of: {duplicate_of or "none"} - Risk classification: {risk_color} Analyze this issue and return a structured report: ### Scope Assessment What is this issue actually asking for? Is it clearly defined? ### Missing Information What's needed to act on this? (reproduction steps, ccboard version, OS, install method used) ### Risk & Impact Security risk? Breaking change? Who's affected? Does it touch ~/.claude data? ### Effort Estimate XS (<1h) / S (1-4h) / M (1-2d) / L (3-5d) / XL (>1 week) ### Priority P0 (critical, act now) / P1 (high, this sprint) / P2 (medium, backlog) / P3 (low, someday) ### Recommended Action One of: Accept & Prioritize, Request More Info, Mark Duplicate (#N), Close (Stale), Close (Out of Scope), Link to Existing PR ### Draft Comment Draft a GitHub comment in English using the appropriate template from templates/issue-comment.md. Be specific, helpful, and constructive. ``` Si issue a >50 commentaires, resumer les 5 derniers uniquement. Agreger tous les rapports. Afficher un resume apres toutes les analyses. --- ## Phase 3 -- Actions (validation obligatoire) ### Types d'actions possibles - **Commenter** : `gh issue comment {num} --body-file -` - **Labeler** : `gh issue edit {num} --add-label "{label}"` (skip si label deja present) - **Fermer** : `gh issue close {num} --reason "not planned"` (jamais sans validation) ### Generation des drafts Pour chaque issue analysee, generer les actions (commentaire + labels + fermeture si applicable) en utilisant `templates/issue-comment.md`. **Regles** : - Langue des commentaires : **anglais** (audience internationale) - Ton : professionnel, constructif, factuel - Ne jamais re-labeler une issue qui a deja ce label - Ne jamais proposer "close" pour une issue d'un collaborateur - Toujours afficher le draft AVANT tout `gh issue comment` ### Affichage et validation **Afficher TOUS les drafts** au format : ``` --- ### Draft -- Issue #{num}: {title} **Actions proposees** : {Commentaire | Label: "bug" | Fermeture} **Commentaire** : {commentaire complet} --- ``` Puis demander validation via `AskUserQuestion` : ``` question: "Ces actions sont pretes. Lesquelles voulez-vous executer ?" header: "Executer" multiSelect: true options: - label: "Toutes ({N} actions)" description: "Commenter + labeler + fermer selon les drafts" - label: "Issue #{x} -- {title_truncated}" description: "Executer uniquement les actions pour cette issue" - label: "Aucune" description: "Annuler -- ne rien faire" ``` (Generer une option par issue + "Toutes" + "Aucune") ### Execution Pour chaque action validee, executer dans l'ordre : commenter -> labeler -> fermer. ```bash # Commenter gh issue comment {num} --body-file - <<'COMMENT_EOF' {commentaire} COMMENT_EOF # Labeler (si applicable) gh issue edit {num} --add-label "{label}" # Fermer (si applicable) gh issue close {num} --reason "not planned" ``` Confirmer chaque action : `Commentaire poste sur issue #{num}: {title}` Si "Aucune" -> `Aucune action executee. Workflow termine.` --- ## Gestion des cas limites | Situation | Comportement | |-----------|--------------| | 0 issues ouvertes | `Aucune issue ouverte.` + terminer | | Issue sans body | Categoriser par titre, recommander `Comment needed` | | >50 commentaires | Resumer les 5 derniers uniquement | | Faux positif doublon | Phase 2 confirme/ecarte -- ne pas agir sur suspicion seule | | Labels deja presents | Ne pas re-labeler, signaler "label deja applique" | | Issue d'un collaborateur | Jamais `close candidate` automatique | | Rate limit GitHub API | Reduire `--limit`, notifier l'utilisateur | | PR mergee liee a issue ouverte | Recommander fermeture de l'issue | | Issue sans activite >90j | Very Stale -- proposer fermeture avec message bienveillant | | Duplicate confirmed in Phase 2 | Poster commentaire + fermer en faveur de l'issue originale | --- ## Notes - Toujours deriver owner/repo via `gh repo view`, jamais hardcoder - Utiliser `gh` CLI (pas `curl` GitHub API) sauf pour la liste des collaborateurs - `updatedAt` peut etre null sur certaines issues -> traiter comme `createdAt` - Ne jamais poster ou fermer sans validation explicite de l'utilisateur dans le chat - Les commentaires draftes doivent etre visibles AVANT tout `gh issue comment` - Similarite Jaccard = |intersection mots| / |union mots| (exclure stop words : a, the, is, in, of, for, to, with, on, at, by)