Communitygithub.com

yingzhengzhang06-sys/requirement-clarifier

Poste de triage à trois modes pour les demandes ambiguës (growme + change + improve). Scénarios natifs chinois, neutre en runtime, table de routage de 30+ compétences.

Qu'est-ce que requirement-clarifier ?

Ce skill agit comme un « poste de triage » pour l'assistant IA. Il ne présuppose aucun domaine d'application ni n'exécute de tâches à la place de l'utilisateur. Au lieu de cela, il transforme des idées floues en exigences structurées, réorganise des piles de tâches en séquences d'exécution avec routage, et transforme des solutions existantes en listes d'améliorations. Il repose sur trois sous-skills : `growme-mode` (clarification des besoins), `change-mode` (triage des tâches) et `improve-mode` (optimisation structurelle). Le processus suit un ordre sériel : clarification d'abord, puis triage, puis amélioration. Le skill ne s'exécute jamais lui-même ; une fois le diagnostic posé, il oriente explicitement vers un autre skill d'exécution. Il est particulièrement utile lorsque l'utilisateur exprime des besoins vagues, des tâches multiples sans ordre, ou des solutions existantes dont il doute de l'optimalité. Il comprend une table de routage de 30+ skills et des mécanismes d'auto-vérification pour éviter les clarifications ou améliorations factices.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add yingzhengzhang06-sys/requirement-clarifier

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Clarification des besoins et triage des tâches (Grow / Change / Improve)

Phrase d'accroche : Ne touchez à rien d'abord — avant d'agir, répondez aux trois questions : « Que veut vraiment l'utilisateur ? Quelle est la complexité ? Par où commencer ? »

C'est le « poste de triage » — il ne présuppose aucun domaine et n'exécute rien à votre place. Il transforme des idées floues en exigences structurées, des piles de tâches en séquences d'exécution avec routage, et des solutions existantes en listes d'améliorations. Puis il indique clairement le prochain skill à utiliser, sans prendre le relais lui-même.

Ce skill est un routeur qui répartit les demandes utilisateur vers trois sous-skills :

  • growme-mode — Clarification des besoins (« Aide-moi à réfléchir »)
  • change-mode — Triage des tâches (« Que faire en premier »)
  • improve-mode — Optimisation structurelle (« Comment améliorer »)

Positionnement central

Toute demande où l'utilisateur n'est « pas sûr de par où commencer » passe d'abord par ce skill une fois. Trois actions :

  1. Clarification (growme) : Transformer une idée floue en exigence exécutable
  2. Triage (change) : Transformer une pile de tâches en ordre d'exécution
  3. Amélioration (improve) : Transformer une solution existante en liste d'optimisations

Répondre aux trois questions fondamentales de l'utilisateur :

  • Que veux-tu vraiment ? (growme produit un « cahier des charges »)
  • Par où commencer ? (change produit un « ordre d'exécution »)
  • Est-ce que c'est correct maintenant ? (improve produit des « points d'amélioration »)

Règles de routage

Après avoir reçu la saisie utilisateur, déterminer d'abord quel(s) mode(s) sont concernés (peut être multiple, peut être sériel) :

Caractéristique utilisateurModeExempleRouté vers
Exprime un résultat mais le chemin est flougrowme« Je veux créer un skill d'IA pédagogique »growme-mode
A plusieurs tâches à ordonner ou choisirchange« J'ai 8 skills à retravailler en détail »change-mode
A déjà une solution mais n'est pas sûr qu'elle soit optimaleimprove« Tu penses que ce SKILL.md est bien écrit ? »improve-mode

Principe de décision :

  • La plupart des demandes commencent par growme (clarification), avant de décider d'enchaîner avec change/improve
  • Ordre sériel : growme → change → improve (d'abord clarifier le besoin, puis ordonner, puis examiner la solution)
  • Indiquer clairement à l'utilisateur le mode détecté et lui demander confirmation ou correction
  • Si aucun triage n'est nécessaire, dire directement « pas besoin », ne pas utiliser le skill pour le plaisir
  • Une même conversation peut impliquer plusieurs modes — les appeler en série selon les besoins

Ne pas se router vers soi-même : après le triage, le skill doit pointer vers un autre skill d'exécution. Il est interdit de dire « après avoir fait A, utilise à nouveau requirement-clarifier pour clarifier ».


Scénarios de déclenchement

Déclenchement fort (appel direct) :

  • « Aide-moi à réfléchir / Comment faire ça / J'ai une idée » → growme-mode
  • « Comment ordonner ces tâches / Que faire en premier / Quels chemins de réalisation / Aide-moi à trier » → change-mode
  • « Comment optimiser / Quels problèmes reste-t-il / Regarde cette solution / Fais une revue » → improve-mode

Déclenchement faible (appel lorsque le contexte contient une sémantique d'incertitude) :

  • Une demande en une phrase sans critères d'acceptation
  • Une pile de tâches sans dépendances précisées
  • Une solution existante + l'utilisateur exprime « un sentiment que quelque chose ne va pas »
  • Plusieurs membres d'une équipe ont des descriptions différentes du même objectif

Non déclenchement (limites claires) :

  • Informations déjà complètement claires → passer directement à l'exécution, ne pas utiliser le skill pour le plaisir
  • Une seule petite question précise (« Comment utiliser X ? ») → utiliser AskUserQuestion directement
  • Déjà une question de domaine spécifique (« Comment écrire un bouton front-end ? ») → router vers frontend-design / ui-ux-pro-max ou autre skill de domaine
  • Pure écriture / pure traduction / pure génération → router vers original-writing / humanizer / content-rewrite

Format de sortie (vue routeur)

Mode détecté : growme / change / improve (combinable)

【growme】 → Charger growme-mode (exécuter la clarification des besoins)
【change】  → Charger change-mode (exécuter le triage des tâches)
【improve】 → Charger improve-mode (exécuter l'optimisation structurelle)

Prochaine étape suggérée : [Router spécifiquement vers XX skill / Exécuter directement / Clarifier davantage]

Structure des fichiers (ce kit)

requirement-clarifier/             ← Routeur (vous êtes ici)
├── SKILL.md                       ← Ce fichier : routage + déclenchement + limites
├── growme-mode/                   ← Sous-skill 1 : clarification des besoins
│   ├── SKILL.md
│   └── references/
│       ├── seven-dimensions.md    ← 7 dimensions de questionnement
│       ├── ask-question-toolkit.md ← Astuces d'utilisation de AskUserQuestion
│       └── red-flags.md           ← Contre-exemples de fausse clarification
├── change-mode/                   ← Sous-skill 2 : triage des tâches
│   ├── SKILL.md
│   └── references/
│       ├── complexity-rubric.md   ← Grille d'évaluation de la complexité
│       ├── priority-matrix.md     ← Matrice P0/P1/P2/P3
│       ├── routing-table.md       ← Table de correspondance 30+ skills
│       └── parallel-dependency.md ← Dépendances et parallélisation
├── improve-mode/                  ← Sous-skill 3 : optimisation structurelle
│   ├── SKILL.md
│   └── references/
│       ├── seven-leverage-points.md ← 7 types de points d'amélioration
│       ├── smart-criteria.md      ← Principes SMART
│       └── red-flags.md           ← Contre-exemples de fausse amélioration
├── examples/                      ← Cas réels
│   ├── fake-clarification.md      ← Échantillon de fausse clarification
│   ├── fake-triage.md             ← Échantillon de faux triage
│   └── fake-improve.md            ← Échantillon de fausse amélioration
├── test-prompts.json              ← 6 échantillons de test vivants + questions d'auto-vérification
├── README.md                      ← Façade du kit (template house-style)
├── LICENSE                        ← MIT
└── .claude-plugin/
    └── marketplace.json           ← Plugin double canal

Le rapport de polissage a été déplacé vers 精修skills/13-元skill与治理/打磨报告/requirement-clarifier-打磨报告.md (archivé centralement pour faciliter la consultation de tous les rapports de polissage des skills).


Gotchas (couche routeur)

❌ Choses à ne pas faire

  1. Ne pas « exécuter à la place » — ce skill est un « poste de triage », pas une « salle d'opération ». Après clarification et triage, pointer explicitement vers le prochain skill d'exécution
  2. Ne pas « utiliser pour le plaisir » — si la saisie utilisateur est déjà suffisamment claire, il suffit de confirmer
  3. Ne pas « présupposer un domaine » — ne pas supposer de domaine front-end, back-end, contenu, commercial, etc.
  4. Ne pas « se router vers soi-même » — après le triage, ne pas pointer vers requirement-clarifier, mais former une boucle « triage → exécution → validation »
  5. Ne pas « sauter growme pour aller directement à change » — une pile de tâches présuppose que « le besoin est déjà clair », sinon clarifier d'abord
  6. Ne pas poser plus de 5 questions à la fois — plus de 5 = vous ne saisissez pas l'essentiel
  7. Ne pas lister plus de 7 points d'amélioration — plus de 7 = vous ne triez pas, vous énumérez

✅ Critères de complétude

Avant de produire la sortie, demandez-vous :

« L'utilisateur peut-il commencer à exécuter directement avec cette sortie ? »

  • Oui → Terminé
  • Non → Quelle étape manque-t-elle ? Revenir en arrière pour la compléter
  • Incertain → Mentionner « Nécessite confirmation de l'utilisateur sur XX avant de commencer »

Quand charger les sous-skills

  • Requêtes liées à growme → Charger growme-mode/SKILL.md + references/seven-dimensions.md
  • Requêtes liées à change → Charger change-mode/SKILL.md + references/priority-matrix.md + references/routing-table.md
  • Requêtes liées à improve → Charger improve-mode/SKILL.md + references/seven-leverage-points.md
  • Auto-vérification de complétude → Lire la section Gotchas de ce fichier

Nombre de lignes et structure

  • SKILL.md principal (routeur) : ≤ 200 lignes (actuellement ~150 lignes, conforme)
  • SKILL.md des sous-skills : ≤ 250 lignes
  • references/ des sous-skills : chargées à la demande, ne pas bourrer le contexte principal
  • Nombre total de fichiers squelette : ≤ 20

Skills associés