Objectif
Produire un plan pour une compétence simple, élaboré avec l'utilisateur et prêt à être construit dans Claude, ChatGPT ou Copilot. Vérifier chaque question, ligne de projet et correction par rapport à ceci : est-ce que cela aide l'utilisateur à obtenir la compétence la plus simple qui fait le travail ?
Étapes
Les nouvelles compétences et les audits suivent les mêmes étapes. Poser au maximum deux séries de questions (étapes 1 et 4). Les arrêts aux étapes 2 et 5 ne demandent qu'un oui ou une modification. À chaque question ou arrêt, donner votre recommandation et pourquoi, afin que l'utilisateur puisse simplement être d'accord ou modifier. Rédiger tôt, pour que l'utilisateur réagisse à quelque chose de concret au lieu de répondre à des questions dans l'abstrait.
- Comprendre la tâche. Poser une question ouverte qui détermine ce que l'utilisateur essaie d'accomplir, à quoi ressemble un bon résultat pour lui et quel outil IA il utilise. Pour un audit, demander la compétence. Ignorer tout ce que la conversation a déjà répondu.
- Décider de la structure. Une compétence ou plusieurs, et étapes, un standard ou les deux (voir « Deux types de compétence »). Décider sur la base de l'objectif, pas des entrées : un objectif correspond à une compétence, quelles que soient les entrées, et deux objectifs signifient deux compétences. Si les étapes changent pour la plupart des entrées, chercher un deuxième objectif caché. Recommander une structure, puis s'arrêter et confirmer.
- Rédiger le plan. Rédiger les sept parties à partir de ce que vous avez, et marquer chaque supposition comme une hypothèse. Pour un audit, marquer chaque partie comme présente ou manquante. Considérer si une bonne pratique reconnue dans le domaine (principe pyramidal de Minto pour les scénarios, ASD-STE100 pour la rédaction technique simple) ou un persona (un sous-rédacteur en chef expérimenté pour une compétence qui resserre un texte) permettrait de focaliser la compétence, car en nommer un oriente le LLM vers un ensemble de pratiques qu'il connaît déjà et qui peut remplacer plusieurs règles. N'en ajouter un que lorsqu'il change ce que le LLM ferait, et associer un persona à ce que cette personne fait différemment, car un rôle seul modifie surtout le ton. Le lister comme une hypothèse avec la raison, afin que l'utilisateur puisse l'accepter, l'échanger ou le supprimer.
- Combler les lacunes. En un seul message, poser jusqu'à trois questions sur les hypothèses qui modifieraient le plus la compétence. C'est la dernière série ; tout ce qui reste inconnu reste une hypothèse listée.
- Vérifier, puis demander l'approbation. Vérifier d'abord le plan par rapport à ce que l'utilisateur essaie d'accomplir (étape 1), puis par rapport à « À quoi ressemble une bonne compétence », et corriger ce qui échoue. Montrer le plan et demander : « Approuvez tel quel, modifiez quelque chose, ou abandonnez ? » (audit : « Quelles corrections sont retenues ? »). Ne créer ou modifier une compétence qu'après l'approbation de l'utilisateur.
À quoi ressemble une bonne compétence
Deux types de compétence
- Étapes : un processus dans l'ordre, comme transformer n'importe quel transcript en un même résumé.
- Standard : des règles que le résultat doit respecter, dans n'importe quel ordre, comme écrire sur le ton de quelqu'un. Dans une compétence standard, le standard est la Méthode ; dans une compétence par étapes, le standard pour la qualité va dans le Contexte.
- De nombreuses compétences utilisent les deux : des étapes qui se terminent par une vérification par rapport à un standard.
Les sept parties
« Le LLM » désigne le modèle IA qui exécutera la compétence. La troisième colonne donne le premier principe derrière chaque partie : une limite du LLM. Couvrir les sept. Par défaut, donner à chaque partie son propre sous-titre. Si l'utilisateur dit que quelque chose compte le plus, utiliser votre jugement (son propre sous-titre, ou parties fusionnées), tant que chaque question ci-dessous est répondue.
| Partie | Question à poser | Parce que le LLM... |
|---|---|---|
| Objectif | Dit-elle, en une ou deux phrases, ce que la compétence résout, et indique-t-elle au LLM de vérifier chaque étape et le résultat par rapport à cet objectif ? | se rabat sur l'objectif lorsqu'un cas n'est pas couvert, donc l'objectif doit être assez court pour être rappelé à chaque étape |
| Déclencheur | La description dit-elle, en une phrase précise, ce que fait la compétence et quand l'utiliser ? | ne voit que cela jusqu'au début de la compétence, et lit la description de chaque compétence dans chaque conversation |
| Entrée | Dit-elle ce que l'utilisateur doit fournir, quand il y en a assez pour commencer, et ce qui change pour chaque type d'entrée ? Un changement dans la façon dont le travail est effectué va dans la Méthode comme « si ceci, alors cela ». | fait des suppositions partout où il y a une lacune |
| Méthode | Dit-elle ce que fait le LLM : des étapes dans l'ordre, avec un arrêt se terminant par une question avant tout ce qui est difficile à annuler et partout où le jugement revient à l'utilisateur, un standard, ou les deux ? | a tendance à agir et à finir, donc il ne s'arrêtera pas sauf si on lui dit où |
| Contexte | Donne-t-il le contexte que le LLM ne connaîtrait pas déjà, comme des définitions, des sources, toute bonne pratique ou persona auquel il se conforme, et pour qui le résultat est destiné ? | ne connaît que ce qui est devant lui |
| Directives et vérification | Nomme-t-elle les quelques erreurs qui ruineraient le résultat, chacune avec quoi faire à la place, et incite-t-elle le LLM à vérifier ses conclusions par rapport à quelque chose (la source, une citation, les mots de l'utilisateur) à sa manière ? | évoque une chose interdite et peut sembler sûr tout en devinant |
| Sortie | Décrit-elle le résultat et où il va, donne-t-elle un exemple qui correspond aux personnes qui l'utilisent, et dit-elle ce que signifie « terminé » ? | copie les exemples de près et s'arrête quand il pense avoir terminé |
Peut-elle être suivie ?
Demander pour chaque ligne :
- Une personne novice dans la tâche pourrait-elle la suivre sans demander ce que cela signifie ?
- Répète-t-elle ou contredit-elle une autre ligne n'importe où dans la compétence, y compris toute ligne qui vient d'être ajoutée ou modifiée ?
Règles de rédaction
Simplifier le langage en utilisant ASD-STE100 (English Technique Simplifié) comme guide, afin que chaque ligne ait une seule signification que le LLM ne peut pas mal interpréter.
- Briefé : rédigez comme vous brieferiez un collègue compétent : pourquoi les choses clés comptent, le contexte dont il a besoin et les questions à poser pour atteindre l'objectif. Assez pour raisonner, et pas plus, car le LLM applique les règles strictement et une raison lui permet de traiter des cas que la compétence n'a pas listés.
- Concis : moins c'est plus. Garder les lignes qui font l'essentiel du travail (80/20) et couper le reste, même les lignes qui sont vraies et utiles, car chaque ligne supplémentaire entre en compétition pour l'attention du LLM. Couper le préambule. Environ 1 000 mots est un guide approximatif, pas une limite. Mettre les règles clés en haut et en bas, car le LLM prête le moins d'attention au milieu d'un texte long. Si le contexte commence à peser plus que les instructions, suggérer de le déplacer dans un fichier de référence et laisser l'utilisateur décider.
- Précis : utiliser le seul mot qui obtient le mieux le résultat dont l'objectif a besoin. Précis signifie le mot exact, et généralement moins d'entre eux.
- Vérifiable : commencer chaque instruction par un verbe, et rendre les instructions et les lignes de fin vérifiables par le LLM (« court » devient « moins de 100 mots »). Laisser les jugements de valeur à l'objectif.
- Balisé : utiliser des sous-titres pour organiser les instructions, et envelopper uniquement le matériel qui n'est pas une instruction, comme un exemple, un modèle ou un texte que l'utilisateur colle, dans une balise XML nommée pour ce qu'il est (
<exemple>). La balise montre au LLM où ce bloc commence et se termine et qu'il s'agit d'un échantillon, pas d'un ordre. Garder les balises dans le corps, car le nom et la description ne peuvent pas les contenir. Lister chaque balise ajoutée avec vos hypothèses, avec la raison, afin que l'utilisateur puisse la conserver ou la supprimer.
Directives et vérification
- Lors de la modification d'une compétence, le LLM a tendance à corriger chaque lacune en ajoutant une ligne, et à couper ce dont la compétence a besoin parce que plus court semble mieux. Réécrire la ligne qui doit changer au lieu d'en ajouter une après, et garder l'objectif court. Avant de couper, nommer ce à quoi l'utilisateur essaie d'arriver (étape 1) et vérifier que la version coupée y parvient toujours.
- Dans un audit, citer la ligne derrière chaque constatation, afin que l'utilisateur puisse la voir par lui-même.
Sortie
- Nouvelle compétence : le plan dans la conversation, une ou deux lignes par partie, se terminant par comment l'installer dans l'outil que l'utilisateur a nommé à l'étape 1. Rechercher les étapes actuelles pour cet outil si vous n'êtes pas sûr, car la façon dont chaque outil installe les compétences change souvent. En dessous, lister vos hypothèses et deux ou trois demandes de test, chacune avec à quoi ressemble un bon résultat.
- Audit : dire ce que la compétence essaie de faire, donner un résumé de cinq lignes (ce qui fonctionne, ce qui ne fonctionne pas, quoi faire ensuite, et pourquoi), puis lister chaque partie manquante et chaque ligne qui échoue à une vérification.
Exemple de plan, pour que le LLM corresponde à cette forme :
Objectif : Transformer n'importe quel transcript de réunion en un même résumé d'une page, afin que les décisions et les actions soient faciles à trouver. Vérifier chaque élément par rapport à cet objectif avant de l'inclure. Déclencheur : Utiliser lorsque quelqu'un partage un transcript de réunion et demande un résumé. Entrée : Le transcript et pour qui est le résumé. Si les intervenants ne sont pas nommés, demander qui ils sont. Méthode : Demander pour qui c'est, trier la conversation en décisions, actions et questions ouvertes, puis s'arrêter et demander « Quelque chose manque ou mal entendu ? » avant de finaliser. Contexte : Le format d'une page, et ce dont le lecteur a besoin. Directives et vérification : Au lieu de deviner un responsable, le marquer [responsable ?]. Vérifier chaque action par rapport au transcript avant de la lister. Sortie : Un résumé d'une page dans la conversation, terminé lorsque chaque action a un responsable ou une marque [responsable ?].
Terminé lorsque
Vous avez terminé lorsque l'utilisateur a accepté la structure et approuvé un plan qui fait le travail qu'il a décrit à l'étape 1, avec les sept parties couvertes et chaque ligne pouvant être suivie.