# Canevas de transfert de compétence

**Objectif :** capturer le jugement d’un expert avant d’écrire un fichier `SKILL.md`.  
**Usage :** remplir un canevas par tâche bornée. Si un champ est vide, la compétence n’est pas prête.

> Remplacez chaque indication entre crochets par du contenu réel. Supprimez les consignes avant de publier la compétence.

## 1. Tâche

- **Nom :** [nom court]
- **Déclencheur :** [quelle demande, quel événement ou quelle condition active la compétence ?]
- **Utilisateurs :** [qui utilise la sortie ?]
- **Décision soutenue :** [quelle décision ou action la sortie améliore-t-elle ?]
- **Critère de réussite :** [qu’est-ce qui doit être vrai pour que la sortie soit utile ?]
- **Hors périmètre :** [que doit refuser ou escalader la compétence ?]

## 2. Entrées

| Entrée | Requise ? | Source | Validation |
|---|---|---|---|
| [brouillon / grille / données / transcription] | Oui | [source] | [format, longueur, langue, permissions] |
| [contexte] | Non | [source] | [comment vérifier] |

## 3. Jugement expert

- **Que remarquez-vous en premier ?** [indices, signaux d’alerte]
- **Qu’est-ce qui vous fait ralentir ou arrêter ?** [seuils, incertitude, risque]
- **Quelles exceptions priment sur la règle ?** [cas limites]
- **À quoi ressemble une sortie forte ?** [exemple]
- **À quoi ressemble une sortie faible ?** [contre-exemple]
- **Où les experts sont-ils en désaccord ?** [encoder en escalade, pas en consensus]
- **Que n’automatiseriez-vous jamais ?** [jugement, éthique, relations]
- **Quelle preuve démontre la sortie ?** [citation, calcul, approbation]

## 4. Procédure

1. [Valider les entrées.]
2. [Récupérer le plus petit pack de preuves.]
3. [Appliquer les règles de décision.]
4. [Traiter les exceptions ou escalader.]
5. [Produire le format attendu.]
6. [Vérifier selon les règles de preuve.]
7. [S’arrêter ou escalader si la confiance est faible.]

## 5. Contrat de sortie

- **Format :** [tableau / mémo / JSON / feedback / plan]
- **Champs requis :** [liste]
- **Ton et langue :** [contraintes]
- **Longueur :** [limites]
- **À préserver :** [voix de l’élève, formulation de la source, incertitude]
- **À éviter :** [preuve inventée, flatterie, surinterprétation]

## 6. Modes d’échec

| Échec | Signal | Prévention |
|---|---|---|
| Flatterie sans preuve | Éloge sans citation | Exiger une citation pour chaque jugement |
| Citation inventée | La source n’existe pas | Ouvrir chaque source ; autoriser « preuve manquante » |
| Dérive des critères | Critères absents de la grille | Relire la grille à chaque étape |
| Fuite de données | Données d’élève dans un outil externe | Environnement approuvé ; anonymiser |
| Sur-automatisation | Action irréversible effectuée | Point d’approbation humaine |

## 7. Permissions et sécurité

- **Peut lire :** [données]
- **Peut écrire :** [données]
- **Peut envoyer / publier / payer / supprimer :** [oui/non, avec approbation]
- **Secrets :** [ne jamais placer d’identifiants dans la compétence]
- **Rétention :** [ce qui est stocké, où et combien de temps]
- **Audit :** [ce qui est journalisé]

## 8. Évaluation

- **Jeu de référence :** [10–30 cas réels, faciles, ambigus et adverses]
- **Grille :** [exactitude, preuve, complétude, ton, sécurité, actionnabilité]
- **Critères de réussite :** [seuil minimal]
- **Seuil critique :** [seuil séparé]
- **Calibration humaine :** [qui révise les désaccords ?]
- **Régression :** [relancer après chaque changement de modèle, prompt, outil ou source]

## 9. Maintenance

- **Propriétaire :** [nom et rôle]
- **Version :** [semver]
- **Date de revue :** [date]
- **Changelog :** [ce qui a changé et pourquoi]
- **Dépréciation :** [quand et comment retirer la compétence]
- **Limites connues :** [ce que la compétence ne sait pas faire]

## 10. Démarrage `SKILL.md`

```markdown
---
name: [nom-en-minuscules-avec-tirets]
description: [Ce que fait la compétence + quand l’utiliser. Inclure les mots déclencheurs et les limites.]
---

# [Nom de la compétence]

## Quand l’utiliser
[Conditions de déclenchement et exclusions.]

## Entrées
- [Entrée requise]
- [Contexte optionnel]

## Procédure
1. [Valider les entrées.]
2. [Récupérer les preuves.]
3. [Appliquer les règles.]
4. [Traiter les exceptions.]
5. [Produire la sortie.]

## Sortie
[Format exact, champs et longueur.]

## Vérification
- [Chaque affirmation matérielle cite une preuve.]
- [Ne pas inventer de sources ou de critères.]
- [Si la confiance est faible, expliquer ce qui manque et s’arrêter.]

## Modes d’échec
- [Erreur prévisible et prévention.]

## Permissions
[Lecture/écriture/envoi. Par défaut : lecture seule.]

## Références
[Lien vers exemples et jeu d’évaluation.]
```

## 11. Premier exercice (90 minutes)

1. Choisissez une tâche de 30 minutes que vous répétez.
2. Observez un expert ou enregistrez votre propre réflexion à voix haute.
3. Remplissez les sections 1 à 7.
4. Rédigez `SKILL.md`.
5. Testez sur cinq cas réels et notez les échecs.
6. Décidez : prêt pour un pilote, ou besoin de plus de capture ?

---

**Règle :** si vous ne pouvez pas expliquer le jugement, ne l’automatisez pas. Capturez le désaccord comme chemin d’escalade.