Communitygithub.com

NickMoignard/okf-domain-elicit

Compétence d'agent : entretiens structurés et reprenables d'élicitation de domaine produisant un bundle de connaissances OKF (glossaire, événements tri-temporels, règles, carte de contexte).

Qu'est-ce que okf-domain-elicit ?

Cette compétence permet à un agent IA de mener un entretien d'élicitation de domaine qui survit aux limites de fenêtre de contexte et aux sessions discontinues. Elle repose sur trois principes directeurs : la saturation (une question n'est terminée que lorsqu'elle obtient une réponse concrète, bornée, exemplifiée et testée contre les exceptions), la file d'attente de branches (chaque cas inexploré est mis en file d'attente sur disque et traité jusqu'à épuisement), et le tri-temporel (chaque fait temporel enregistre quand il s'est produit, quand l'organisation l'a reçu et quand il a été saisi). La compétence définit une machine d'état complète (Cadrage → Narration → Forage → Ramification → Définition → Réflexion) et un réflexe de sondage systématique pour traiter chaque réponse, garantissant qu'aucune abstraction ou règle non vérifiée ne passe. Le résultat est un bundle OKF (fichiers index.md, glossary.md, events.md, rules.md, context-map.md) écrit en continu, qui peut être remis à d'autres compétences (par exemple /to-prd ou /to-issues) pour une transformation ultérieure. Supporté par tout agent capable d'exécuter des commandes shell, de lire/écrire des fichiers et de suivre une machine d'état structurée.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add NickMoignard/okf-domain-elicit

Demander à votre IA préférée

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

Documentation

Élicitation de domaine OKF

Menez un entretien de domaine qui survit aux sessions et émet un bundle OKF au fur et à mesure. Trois mots directeurs gouvernent chaque exécution :

  • saturation — une ligne de questionnement n'est terminée que lorsqu'elle devient saturée : une réponse concrète, bornée, exemplifiée et testée contre les exceptions, ne générant aucun nouveau fil.
  • file d'attente de branches — chaque cas inexploré est poussé dans une file d'attente sur disque et travaillé jusqu'à épuisement. Parcours en profondeur, suivi en largeur ; rien n'est abandonné.
  • tri-temporel — chaque fait porteur de temps enregistre quand il s'est produit, quand l'organisation l'a reçu et quand il a été saisi. Voir TRI-TEMPORAL.md.

Cette compétence fournit la structure et les artefacts ; associez-la à une posture d'entretien implacable (par ex. /grilling) pour la persistance.

Espace de travail de session — reprendre avant de demander quoi que ce soit

Tout l'état vit sur disque pour que l'entretien survive aux limites de fenêtre de contexte et de session. À l'invocation :

  1. Déterminez le slug du sujet (demandez le sujet à l'utilisateur s'il n'est pas défini).
  2. Cherchez .interview/<slug>/. S'il existe, LISEZ state.json et queue.jsonl, reprenez à partir de l'état enregistré et du fil actif, et annoncez où vous reprenez.
  3. S'il n'existe pas, créez-le :
.interview/<slug>/
  state.json      # {state, active_thread, topic, temporal_relevance}
  queue.jsonl     # une branche par ligne : {id, prompt, status, parent}
  index.md        # racine du bundle OKF        — voir BUNDLE-FORMAT.md
  glossary.md     # langage ubiquitaire         — voir GLOSSARY-FORMAT.md
  events.md       # chronologie des événements  — voir EVENTS-FORMAT.md
  rules.md        # règles métier               — voir RULES-FORMAT.md
  context-map.md  # contextes bornés            — voir CONTEXT-MAP-FORMAT.md

Persistez après chaque fait capturé et chaque transition d'état. Ne conservez jamais la file d'attente ou les faits capturés uniquement en contexte — le disque est la source de vérité.

Machine d'état

Parcourez ces états. Le moteur est la boucle NARRATION → FORAGE → RAMIFICATION, dépilant la file d'attente de branches vers NARRATION jusqu'à ce que la condition d'arrêt soit satisfaite. Prompts complets : QUESTION-BANKS.md.

  • S0 Cadrage — périmètre, objectif, acteurs aux limites. Définissez temporal_relevance (jour calendaire ? seconde d'horloge ?) dans state.json.
  • S1 Narration — suscitez une histoire concrète sous forme de chronologie d'événements ; ajoutez les événements à events.md.
  • S2 Forage — pour chaque événement, extrayez déclencheur · acteur · donnée d'entrée · règle · résultat · timing · identité, ainsi que ses états tri-temporels (voir TRI-TEMPORAL.md).
  • S3 Ramification — « que peut-il se passer d'autre ici ? » Poussez chaque exception / alternative / échec dans queue.jsonl en tant que pending.
  • S4 Définition — fixez les termes (chacun avec un contre-exemple), les cardinalités et les limites ; écrivez dans glossary.md et context-map.md.
  • S5 Réflexion — rejouez le modèle dans les mots de la partie prenante ; capturez les corrections.

Réflexe de sondage

Appliquez-le à CHAQUE réponse, dans chaque état — c'est le cœur implacable :

quantificateur vague (« généralement », « quelques-uns », « normalement ») → demandez la limite
abstraction sans exemple                      → exigez une instance concrète
règle affirmée (« on fait toujours X »)        → traquez l'exception
nouveau terme                                  → écrivez dans glossary.md AVEC un contre-exemple
nouvel acteur ou événement                     → poussez dans queue.jsonl
fait porteur de temps                          → capturez les trois états tri-temporels
sinon (concret, borné, exemplifié, testé contre exceptions)
                                               → marquez le fil saturé ; dépilez la prochaine branche pending

Protocole de la file d'attente de branches

  • Une branche est {id, prompt, status: pending|active|saturated, parent} — un objet JSON par ligne, en ajout seul.
  • Pour travailler une branche : passez-la en active dans state.json, exécutez S1→S3 dessus, puis ajoutez une ligne la marquant saturated.
  • Dépilez la prochaine branche pending uniquement lorsque le fil actif est saturé.
  • À la reprise, la file d'attente est la source de vérité de ce qui reste — lisez-la, ne la reconstruisez jamais de mémoire.

Critères d'achèvement

Arrêtez-vous seulement lorsque TOUS sont remplis. Ils sont vérifiables — ne déclarez pas terminé trop tôt :

  • queue.jsonl n'a aucune branche pending.
  • Chaque terme dans glossary.md a à la fois une définition et un contre-exemple.
  • Chaque événement dans events.md porte les trois états tri-temporels, ou un n/a — {raison} explicite.
  • La relecture S5 n'a produit aucune correction matérielle.
  • Les nouvelles questions ne produisent que des reformulations de faits connus.

Émission

Écrivez OKF au fur et à mesure — ne traitez jamais par lots à la fin. Chaque artefact suit son *-FORMAT.md ; ensemble, ils forment un bundle OKF dont la racine est index.md. Gardez index.md à jour à mesure que les artefacts gagnent du contenu. Le bundle est le livrable — remettez-le (par ex. à /to-prd ou /to-issues) dès que les critères d'achèvement sont remplis.

Skills associés