Prompts : gabarits dans docs/prompts/ et remplissage par le domaine
Cinq gabarits sous CC BY-SA 4.0 (coup, videau, bilan, concept, exercices), remplis par des fonctions pures de domain/prompts/ avec la position lue par le moteur (identifiants, lien public, diagramme) et ses chiffres, écrits comme à l'écran (domain/analysis/numbers.ts, partagé avec la feuille du maître, le bilan et l'analyse). Testés sur de vraies analyses : aucun repère vide ni inconnu, mêmes chiffres que l'écran. Fiche du glossaire « Prompt ». Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Pierre MARTIN
co-authored by
Claude Opus 5.5
Claude Opus 5.5
parent
f3f977bf66
commit
4f0611c24c
@@ -67,6 +67,7 @@ exportée. `make test` vérifie le lien dans les deux sens : chaque fiche avec
|
||||
| [Pli](pli.md) | Ply |
|
||||
| [Point](point.md) | Point |
|
||||
| [Prendre](prendre.md) | Take |
|
||||
| [Prompt](prompt.md) | Prompt |
|
||||
| [Règle de Crawford](regle-de-crawford.md) | Crawford rule |
|
||||
| [Règle de Jacoby](regle-de-jacoby.md) | Jacoby rule |
|
||||
| [SGF](sgf.md) | SGF |
|
||||
|
||||
@@ -0,0 +1,16 @@
|
||||
---
|
||||
term: Prompt
|
||||
english: Prompt
|
||||
code: Prompt
|
||||
---
|
||||
# Prompt
|
||||
|
||||
**En bref** : la question toute prête que l'application copie pour une IA (« Demander à une IA ») : la position, les chiffres de GNU Backgammon, et ce qu'on demande ; il suffit de la coller dans l'IA de votre choix.
|
||||
|
||||
L'application n'appelle aucune IA et n'envoie rien : elle prépare le texte,
|
||||
vous le relisez, vous le copiez. Le moteur décide, l'IA explique : le prompt
|
||||
lui demande de ne pas contredire les évaluations de GNU Backgammon, qui
|
||||
restent celles que l'application affiche. Il contient aussi le lien de la
|
||||
position, pour la retrouver dans l'application.
|
||||
|
||||
Voir aussi : [Lien de position](lien-de-position.md), [Moteur](moteur.md), [Conseil du maître](conseil-du-maitre.md)
|
||||
@@ -0,0 +1,58 @@
|
||||
# Les prompts à copier pour une IA
|
||||
|
||||
Les textes que l'application copie dans le presse-papiers quand on touche
|
||||
« Demander à une IA » (étape 1f ; `docs/cadrage.md`, « IA générative en
|
||||
V1 »). L'application n'appelle aucune IA : elle prépare une question
|
||||
complète, que le joueur colle dans l'IA de son choix. Règle d'or : **le
|
||||
moteur décide, l'IA explique**.
|
||||
|
||||
Une seule source (ADR 0008) : `make site` copie ce dossier dans le site
|
||||
publié (`docs/prompts/`), l'application lit les gabarits à l'exécution
|
||||
(`app/src/domain/prompts/`), et `make test` remplit chacun d'eux avec de
|
||||
vraies analyses du moteur (`app/tests/prompts.test.ts`) : aucun repère
|
||||
laissé vide, et les chiffres du prompt sont ceux que l'application affiche.
|
||||
|
||||
Textes sous licence **CC BY-SA 4.0**. Version 1, rédigée par Claude Code
|
||||
d'après le cadrage, **à relire** par Pierre.
|
||||
|
||||
## Les gabarits
|
||||
|
||||
| Fichier | Bouton | Où |
|
||||
| --- | --- | --- |
|
||||
| [coup.md](coup.md) | Pourquoi ce coup est meilleur | Feuille du maître, bilan, analyse |
|
||||
| [videau.md](videau.md) | Expliquer cette décision de videau | Feuille du maître, bilan, analyse |
|
||||
| [bilan.md](bilan.md) | Bilan de ma partie | Bilan de fin de partie |
|
||||
| [concept.md](concept.md) | Expliquer ce concept | Fiche d'un terme du glossaire |
|
||||
| [exercices.md](exercices.md) | Créer des exercices | Progression (étape 1h, pas encore de bouton) |
|
||||
|
||||
Chaque prompt contient :
|
||||
|
||||
- le rôle de l'IA (un coach) et le niveau du joueur ;
|
||||
- la position : Position ID et Match ID de GNU Backgammon, le lien qui
|
||||
l'ouvre dans l'application (`https://ustagammon.sans.pub/#/position/…`,
|
||||
ADR 0013) et un diagramme texte dessiné d'après le plateau décodé par le
|
||||
moteur ;
|
||||
- les chiffres du moteur, avec le niveau d'évaluation (en plis) ;
|
||||
- la consigne de ne pas recalculer ni contredire ces chiffres ;
|
||||
- la langue de la réponse.
|
||||
|
||||
## Format
|
||||
|
||||
Dans chaque fichier, le gabarit est le bloc de texte qui suit le titre
|
||||
`## Gabarit`. Le reste du fichier n'est pas lu. Les mots entre accolades sont
|
||||
remplis par l'application ; un repère inconnu ou une valeur vide est une
|
||||
erreur, vérifiée par les tests.
|
||||
|
||||
Repères communs à plusieurs gabarits :
|
||||
|
||||
| Repère | Ce qu'il devient |
|
||||
| --- | --- |
|
||||
| `{niveau}` | le niveau du joueur, d'après son taux d'erreur mesuré par GNU Backgammon, ou « pas encore mesuré » |
|
||||
| `{position_id}`, `{match_id}` | les identifiants de GNU Backgammon de la position |
|
||||
| `{au_trait}` | « moi » ou « l'ordinateur » : celui dont les identifiants décrivent le point de vue |
|
||||
| `{lien}` | l'adresse de la position dans l'application publiée |
|
||||
| `{diagramme}` | le plateau en texte : vos pions X, ceux de l'ordinateur O, dans votre numérotation |
|
||||
| `{score}` | « partie libre » ou le score du match |
|
||||
| `{videau}` | sa valeur et qui le possède |
|
||||
| `{niveau_eval}` | le niveau d'évaluation de GNU Backgammon, « analyse à 2 plis » |
|
||||
| `{langue}` | la langue de la réponse : « français » |
|
||||
@@ -0,0 +1,44 @@
|
||||
# Bilan de ma partie
|
||||
|
||||
Bouton « Demander à une IA » de la carte « Le coup à revoir » du bilan de
|
||||
fin de partie. Texte sous licence CC BY-SA 4.0 (voir
|
||||
[README.md](README.md)).
|
||||
|
||||
Repères propres à ce gabarit :
|
||||
|
||||
| Repère | Ce qu'il devient |
|
||||
| --- | --- |
|
||||
| `{ordinateur}` | le niveau de l'ordinateur, « Intermédiaire » |
|
||||
| `{resultat}` | le résultat de la partie, et le score du match s'il y en a un |
|
||||
| `{decomptes}` | vos décisions par appréciation, comme les trois cases du bilan |
|
||||
| `{taux}`, `{decisions}`, `{niveau_jeu}` | votre erreur par décision, le nombre de décisions comptées et le niveau correspondant, comme « Voir les chiffres du moteur » de l'analyse |
|
||||
| `{taux_ordinateur}` | la même mesure pour l'ordinateur |
|
||||
| `{chance}`, `{chance_mots}`, `{chance_ordinateur}` | la chance par tour de vos dés, en chiffres et en mots, et celle de l'ordinateur |
|
||||
| `{erreurs}` | vos imprécisions et erreurs, coup par coup, avec leur coût |
|
||||
| `{position_titre}` | ce que montre la position : le coup à revoir, ou la position finale s'il n'y en a pas |
|
||||
|
||||
## Gabarit
|
||||
|
||||
```text
|
||||
Tu es un coach de backgammon, bienveillant et précis. Je suis un joueur de niveau {niveau}.
|
||||
|
||||
Je viens de finir une partie contre l'ordinateur (niveau {ordinateur}), analysée par GNU Backgammon ({niveau_eval}).
|
||||
Résultat : {resultat}.
|
||||
Mes décisions : {decomptes}.
|
||||
Mon erreur par décision : {taux} sur {decisions}, soit le niveau {niveau_jeu} ; celle de l'ordinateur : {taux_ordinateur}.
|
||||
La chance de mes dés par tour : {chance} ({chance_mots}) ; celle de l'ordinateur : {chance_ordinateur}.
|
||||
|
||||
Mes imprécisions et erreurs, avec leur coût en équité :
|
||||
{erreurs}
|
||||
|
||||
{position_titre} (GNU Backgammon, Position ID : {position_id}, Match ID : {match_id} ; ces identifiants la décrivent du point de vue du joueur qui a la main : {au_trait}).
|
||||
Elle s'ouvre aussi à cette adresse : {lien}
|
||||
|
||||
{diagramme}
|
||||
|
||||
Score : {score}. Videau : {videau}.
|
||||
|
||||
Ces évaluations font foi : ne les recalcule pas et ne les contredis pas.
|
||||
À partir de ce bilan, identifie trois thèmes que je devrais travailler en priorité, avec pour chacun un conseil concret.
|
||||
Réponds en {langue}, simplement, en moins de 300 mots.
|
||||
```
|
||||
@@ -0,0 +1,36 @@
|
||||
# Expliquer ce concept
|
||||
|
||||
Bouton « Demander à une IA » sur la fiche d'un terme du glossaire (« Les
|
||||
mots du jeu »). La position d'exemple est celle de la partie en cours, ou la
|
||||
position de départ s'il n'y en a pas. Texte sous licence CC BY-SA 4.0 (voir
|
||||
[README.md](README.md)).
|
||||
|
||||
Repères propres à ce gabarit :
|
||||
|
||||
| Repère | Ce qu'il devient |
|
||||
| --- | --- |
|
||||
| `{concept}` | le terme, et son nom anglais s'il en a un |
|
||||
| `{definition}` | la phrase « En bref » de sa fiche |
|
||||
| `{position_titre}` | « une position de ma partie en cours » ou « la position de départ » |
|
||||
| `{evaluation}` | les chances de gagner et l'équité du joueur au trait, avant de lancer les dés |
|
||||
|
||||
## Gabarit
|
||||
|
||||
```text
|
||||
Tu es un coach de backgammon, bienveillant et précis. Je suis un joueur de niveau {niveau}.
|
||||
|
||||
Explique-moi le concept {concept}.
|
||||
Mon application le définit ainsi : {definition}
|
||||
|
||||
Pour l'illustrer, voici {position_titre} (GNU Backgammon, Position ID : {position_id}, Match ID : {match_id} ; ces identifiants la décrivent du point de vue du joueur qui a la main : {au_trait}).
|
||||
Elle s'ouvre aussi à cette adresse : {lien}
|
||||
|
||||
{diagramme}
|
||||
|
||||
Score : {score}. Videau : {videau}.
|
||||
Évaluation de GNU Backgammon ({niveau_eval}), pour le joueur qui a la main ({au_trait}), avant de lancer les dés : {evaluation}.
|
||||
|
||||
Ces évaluations font foi : ne les recalcule pas et ne les contredis pas.
|
||||
Explique ce concept simplement, avec une analogie de la vie courante, puis dis s'il joue un rôle dans cette position et comment.
|
||||
Réponds en {langue}, en moins de 250 mots.
|
||||
```
|
||||
@@ -0,0 +1,36 @@
|
||||
# Pourquoi ce coup est meilleur
|
||||
|
||||
Bouton « Demander à une IA » sur un coup du joueur : feuille d'explication
|
||||
du maître, carte « Le coup à revoir » du bilan, visualiseur de l'analyse.
|
||||
Texte sous licence CC BY-SA 4.0 (voir [README.md](README.md)).
|
||||
|
||||
Repères propres à ce gabarit :
|
||||
|
||||
| Repère | Ce qu'il devient |
|
||||
| --- | --- |
|
||||
| `{des}` | le jet joué, « 3-1 » |
|
||||
| `{coup_joue}` | votre coup, dans la notation de GNU Backgammon |
|
||||
| `{appreciation}` | le mot du maître : « Bon coup », « Imprécision », « Erreur » ou « Grosse erreur » |
|
||||
| `{rang}` | « le meilleur coup » ou « le 4e choix sur 15 coups possibles » |
|
||||
| `{classement}` | le classement du moteur : les trois meilleurs coups, et le vôtre s'il n'en est pas, avec leur équité et leur écart au meilleur, comme dans « Voir les chiffres du moteur » |
|
||||
|
||||
## Gabarit
|
||||
|
||||
```text
|
||||
Tu es un coach de backgammon, bienveillant et précis. Je suis un joueur de niveau {niveau}.
|
||||
|
||||
Voici la position avant mon coup (GNU Backgammon, Position ID : {position_id}, Match ID : {match_id} ; ces identifiants la décrivent du point de vue du joueur qui a la main : {au_trait}).
|
||||
Elle s'ouvre aussi à cette adresse : {lien}
|
||||
|
||||
{diagramme}
|
||||
|
||||
Score : {score}. Videau : {videau}. Dés : {des}.
|
||||
|
||||
J'ai joué {coup_joue} : {rang}, jugé « {appreciation} ».
|
||||
Classement de GNU Backgammon ({niveau_eval}), équités du point de vue du joueur qui joue :
|
||||
{classement}
|
||||
|
||||
Ces évaluations font foi : ne les recalcule pas et ne les contredis pas.
|
||||
Explique-moi pourquoi le meilleur coup est supérieur au mien : quels concepts sont en jeu, et ce que je dois retenir pour la prochaine fois.
|
||||
Réponds en {langue}, simplement, en moins de 200 mots.
|
||||
```
|
||||
@@ -0,0 +1,38 @@
|
||||
# Créer des exercices
|
||||
|
||||
Prévu pour l'écran de progression (étape 1h) : le gabarit est écrit et
|
||||
testé, sans bouton pour l'instant. Il rassemble les erreurs de vos
|
||||
dernières parties analysées. Texte sous licence CC BY-SA 4.0 (voir
|
||||
[README.md](README.md)).
|
||||
|
||||
Repères propres à ce gabarit :
|
||||
|
||||
| Repère | Ce qu'il devient |
|
||||
| --- | --- |
|
||||
| `{parties}` | le nombre de parties analysées |
|
||||
| `{taux_parties}` | votre erreur par décision et votre niveau, partie par partie, de la plus ancienne à la plus récente |
|
||||
| `{erreurs}` | vos erreurs les plus coûteuses sur ces parties, avec leur coût |
|
||||
| `{position_titre}` | la plus coûteuse d'entre elles |
|
||||
|
||||
## Gabarit
|
||||
|
||||
```text
|
||||
Tu es un coach de backgammon, bienveillant et précis. Je suis un joueur de niveau {niveau}.
|
||||
|
||||
Voici mes {parties} dernières parties contre l'ordinateur, analysées par GNU Backgammon ({niveau_eval}).
|
||||
Mon erreur par décision, de la plus ancienne à la plus récente : {taux_parties}.
|
||||
|
||||
Mes erreurs les plus coûteuses, avec leur coût en équité :
|
||||
{erreurs}
|
||||
|
||||
{position_titre} (GNU Backgammon, Position ID : {position_id}, Match ID : {match_id} ; ces identifiants la décrivent du point de vue du joueur qui a la main : {au_trait}).
|
||||
Elle s'ouvre aussi à cette adresse : {lien}
|
||||
|
||||
{diagramme}
|
||||
|
||||
Score : {score}. Videau : {videau}.
|
||||
|
||||
Ces évaluations font foi : ne les recalcule pas et ne les contredis pas.
|
||||
Repère les thèmes qui reviennent dans ces erreurs, puis propose-moi cinq exercices ciblés : pour chacun, le thème, une position type décrite simplement, et ce que je dois y chercher.
|
||||
Réponds en {langue}, en moins de 350 mots.
|
||||
```
|
||||
@@ -0,0 +1,40 @@
|
||||
# Expliquer cette décision de videau
|
||||
|
||||
Bouton « Demander à une IA » sur une décision de videau du joueur (doubler,
|
||||
lancer sans doubler, prendre, passer) : feuille d'explication du maître,
|
||||
carte « Le coup à revoir » du bilan, visualiseur de l'analyse. Texte sous
|
||||
licence CC BY-SA 4.0 (voir [README.md](README.md)).
|
||||
|
||||
Repères propres à ce gabarit :
|
||||
|
||||
| Repère | Ce qu'il devient |
|
||||
| --- | --- |
|
||||
| `{decision}` | la question posée : « doubler ou lancer les dés sans doubler » ou « prendre ou passer le double de l'ordinateur » |
|
||||
| `{choix}` | votre décision, « passer » |
|
||||
| `{choix_moteur}` | la décision que préfère GNU Backgammon |
|
||||
| `{appreciation}` | le mot du maître : « Bonne décision », « Imprécision », « Erreur » ou « Grosse erreur » |
|
||||
| `{qui_double}` | « moi » ou « l'ordinateur » : celui qui double ou non |
|
||||
| `{equites}` | les équités sans double, double et prise, double et refus, comme dans « Voir les chiffres du moteur » |
|
||||
| `{ecart}` | l'équité perdue par votre décision |
|
||||
|
||||
## Gabarit
|
||||
|
||||
```text
|
||||
Tu es un coach de backgammon, bienveillant et précis. Je suis un joueur de niveau {niveau}.
|
||||
|
||||
Voici la position au moment d'une décision de videau (GNU Backgammon, Position ID : {position_id}, Match ID : {match_id} ; ces identifiants la décrivent du point de vue du joueur qui a la main : {au_trait}).
|
||||
Elle s'ouvre aussi à cette adresse : {lien}
|
||||
|
||||
{diagramme}
|
||||
|
||||
Score : {score}. Videau : {videau}.
|
||||
|
||||
Il fallait choisir : {decision}. J'ai choisi de {choix}, jugé « {appreciation} » ; GNU Backgammon aurait choisi de {choix_moteur}.
|
||||
Équités calculées par GNU Backgammon ({niveau_eval}), du point de vue de celui qui double ou non ({qui_double}), pour un videau de 1 :
|
||||
{equites}
|
||||
Écart de ma décision : {ecart}.
|
||||
|
||||
Ces évaluations font foi : ne les recalcule pas et ne les contredis pas.
|
||||
Explique-moi cette décision : pourquoi doubler ou non, prendre ou passer, quels repères de la position comptent, et ce que je dois retenir.
|
||||
Réponds en {langue}, simplement, en moins de 200 mots.
|
||||
```
|
||||
Reference in New Issue
Block a user