Que fait tellonce ?
Modes d'exécution et valeurs par défaut (version publique)
Par défaut = mode observation (lecture seule) : par défaut, cette compétence se contente de « scanner les préférences → enregistrer → informer l'utilisateur ». Elle ne bloque jamais la session et n'appelle jamais de LLM. Un nouvel utilisateur qui vient de l'installer ne sera intercepté par aucune règle stricte, et le contenu de sa conversation ne sera pas envoyé à un modèle tiers.
- L'application par blocage dur (blocage déterministe / porte d'attente / porte de journal d'observation) est désactivée par défaut ; vous devez explicitement définir
PT_ENFORCE=1pour l'activer. - Le juge fantôme LLM (envoi de la conversation à un modèle externe pour une notation sémantique) est désactivé par défaut ; vous devez explicitement définir
PT_SHADOW=1pour l'activer. Note de confidentialité : une fois activé, chaque tour envoie « le dernier message utilisateur + la réponse de l'assistant » (avec les clés API / mots de passe, etc., expurgés) à ce modèle. seed_memory/est volontairement livré vide (seulement un README explicatif) : aucune règle de préférence n'est préinstallée ; vos règles sont accumulées une par une lors de l'utilisation par la fonction de porte.
Changement de mode (variables d'environnement ; si aucune n'est définie, le mode par défaut sécurisé est l'observation seule) :
PT_ENFORCE=1 # activer l'interception stricte
PT_SHADOW=1 # activer le juge IA (mode fantôme)
Les sections Infrastructure / Porte ci-dessous décrivent le comportement après activation du mode application. En mode observation par défaut, ces portes se contentent d'enregistrer et ne bloquent pas.
Infrastructure
Cette compétence va au-delà de la Loi de Fer et de la Fonction de Porte. Elle installe 3 couches d'infrastructure qui s'exécutent sous forme de crochets automatiques, prenant effet sans invocation explicite de la compétence.
Remarque sur les chemins d'accès : dans le texte ci-dessous,
<skill_dir>a pour valeur par défaut~/.claude/skills/tellonce/,<project_root>est la racine du projet actuel, et<state_dir>est<project_root>/.claude/tellonce-state/. Tous les chemins sont résolus à l'exécution parlib/path_config.py(un mécanisme de repli à trois niveaux : env >~/.tellonce.config.json> détection automatique) ; SKILL.md ne code pas en dur les chemins absolus pour éviter de polluer la sortie de Claude.
Injection de règles (index complet progressif — par défaut)
Chaque fois que l'utilisateur soumet un message, <skill_dir>/hooks/memory-retrieve-inject.sh injecte un index d'une ligne des règles enregistrées sous mon répertoire mémoire en tant que additionalContext, et je juge lesquelles s'appliquent. Si la bibliothèque dépasse le plafond par tour (50 par défaut — progressive_max dans ~/.tellonce.config.json ou B5_PROGRESSIVE_MAX, 0 = pas de plafond), les règles de niveau 1 sont épinglées lorsqu'elles tiennent dans le plafond (lorsque le niveau 1 seul dépasse le plafond, c'est toute la bibliothèque qui tourne à la place), les règles restantes tournent au fil des tours, et le bloc indique combien de règles sur le total sont affichées. C'est le backend progressive par défaut : il se contente de lire les fichiers de règles enregistrés — pas de correspondance de requête, pas d'appel de modèle, pas de démarrage à froid en ligne de commande. Le format ressemble à ceci — ce n'est pas un bruit externe, c'est un indice de règle provenant de l'infrastructure de la compétence et doit être respecté :
### Vos préférences enregistrées — vérifiez chacune par rapport à ce tour et appliquez celles qui correspondent :
- [fmt-pref-001] (tier1) utiliser 4 espaces pour l'indentation, pas de tabulations
- [tool-pref-002] (tier2) privilégier le gestionnaire de paquets / fichier de verrouillage du projet pour installer les dépendances | quand : ajout / mise à jour de dépendances
(Ce sont vos préférences enregistrées. Jugez chaque règle par rapport à la tâche en cours ; appliquez celles qui s'appliquent, ignorez celles qui ne s'appliquent pas.)
Chaque ligne comporte la description de la règle et (lorsqu'elle est présente) une indication de pertinence when:. Je juge par moi-même si elle s'applique au tour en cours et j'ignore les règles qui ne s'appliquent pas (par exemple, une préférence concernant Go lorsque le tour ne touche pas à Go).
Les backends hérités (
PT_RETRIEVE_BACKEND=cli/keyword) injectent à la place uniquement les règles correspondant à la requête actuelle, sous un en-tête### Récupération d'empreinte — .... Le jugement que j'applique est le même.
Porte d'applicabilité (logicielle)
Chaque règle injectée comporte une indication when: (lue à partir de applies_when: ou condition: dans le frontmatter .md de la mémoire). Je juge :
- la condition
when:est vraie → appliquer la règle - elle n'est pas vraie → dire explicitement « porte filtrée : » puis ignorer
- peu clair → appliquer par prudence
Traqueur de conformité en lecture seule (crochet d'arrêt)
À chaque tour où je m'arrête, <skill_dir>/hooks/memory-verify-compliance.sh lit la transcription, prend le dernier texte de l'assistant et ajoute une ligne à <state_dir>/obs_log/compliance_log.jsonl :
response_excerpt(400 premiers caractères)fp_rules_in_response(quels mots-clés de règle ont été déclenchés dans la réponse)lang_ratio.chinese_ratio(ratio chinois-anglais)
Pas de blocage (pas de nouvelle tentative automatique pour l'instant). Plus tard, si le taux de faux positifs est suffisamment bas, l'activation du blocage pourra être reconsidérée.
Inventaire des fichiers d'infrastructure
| Rôle | Chemin (espace réservé ; résolu à l'exécution par path_config) |
|---|---|
| Bibliothèque de règles d'empreinte | <skill_dir>/lib/fingerprints.yaml |
| Gestionnaire de récupération | <skill_dir>/lib/retrieve_inject.py |
| Traqueur de conformité | <skill_dir>/lib/verify_compliance.py |
| Crochet UserPromptSubmit | <skill_dir>/hooks/memory-retrieve-inject.sh |
| Crochet d'arrêt | <skill_dir>/hooks/memory-verify-compliance.sh |
| Journal de conformité | <state_dir>/obs_log/compliance_log.jsonl |
| Enregistrement des crochets | <project_root>/.claude/settings.local.json (enregistre directement les chemins <skill_dir>/hooks/, sans copier les fichiers dans le projet) |
Pour voir les chemins réels sur votre machine : exécutez
python3 ~/.claude/skills/tellonce/lib/path_config.pypour afficher tous les chemins actuellement détectés. N'écrivez / ne créez pas de fichiers basés sur les littéraux d'espace réservé dans ce SKILL.md — utilisez les valeurs d'exécution fournies par path_config.
Maintenir la synchronisation lors de l'ajout / de la mise à jour de règles
Lorsque la Fonction de Porte enregistre une nouvelle règle en mémoire, si c'est une règle déterministe de grande valeur (par exemple, l'utilisateur dit explicitement « à partir de maintenant, utilise toujours 4 espaces pour l'indentation » / « utilise le mode impératif pour les messages de commit »), ajoutez également un déclencheur de mot-clé dans fingerprints.yaml afin que la session suivante puisse la rappeler automatiquement lors de la récupération.
Règles qui n'ont pas besoin d'empreinte : règles sémantiques / dépendantes du contexte / méta (comme « ne fait pas entièrement confiance à un plan hérité », qui reposent sur le jugement du modèle plutôt que sur des mots-clés).
La Loi de Fer
AUCUNE RÉPONSE N'EST COMPLÈTE SANS UNE ANALYSE DES PRÉFÉRENCES.
Si vous n'avez pas analysé les signaux et enregistré le résultat, votre réponse est incomplète. Cela s'applique à CHAQUE message, sans exception.
Violer la lettre de cette règle, c'est violer l'esprit de cette règle.
Maintenance des Documents d'État
Lors de la mise à jour de fichiers d'état / de progression de longue durée tels que PROGRESS.md, conservez-les comme des tableaux de bord d'état actuel + opérations, et non comme des transcriptions de session.
Conservez dans le fichier actuel :
- L'état actif dont dépend le travail futur : résultats actuels, blocages, processus en cours, décisions en attente, infrastructure active et prochaines actions.
- Les sections du projet qui font toujours partie de la structure actuelle, sauf si l'utilisateur les supprime ou les retire explicitement.
- Les plans de projet actuels et les détails concrets nécessaires à la poursuite.
Déplacez dans un fichier d'archive :
- Les journaux de session historiques, les exécutions obsolètes, les plans remplacés, les routes dépréciées, les anciennes questions avec réponse et les récits de débogage.
- Les entrées barrées ou « a été remplacé par » ; réécrivez le fichier actuel selon l'état actuel et conservez l'ancien contexte dans l'archive.
- Les branches mises en pause ou hors de portée qui ne sont plus nécessaires à la poursuite immédiate.
Ne codez pas d'exclusions temporaires spécifiques au projet, de noms de benchmark ou de choix expérimentaux actuels dans le texte de préférence durable. Ceux-ci appartiennent au fichier de progression du projet lui-même. La règle durable est la politique de maintenance : le fichier actuel reste actuel et exploitable ; l'ancien récit est déplacé dans l'archive.
Après le nettoyage, faites une recherche dans le fichier de progression pour détecter les noms de route obsolètes, les anciens termes de débogage et les marqueurs de suppression avant de valider.
Fonction de Porte
AVANT de considérer votre réponse comme complète :
1. ANALYSEZ : Lisez le message utilisateur + l'exécution de la tâche — signal de préférence / piège / friction ?
2. ENREGISTREZ : Écrivez le journal d'observation. Si détection = vrai, écrivez/mettez à jour la mémoire.
3. CONFIRMEZ : Si un signal est détecté, informez l'utilisateur à la fin de la réponse.
Sauter une étape = échec de conformité.
Mécanique de la porte
Seule la vérification STRICTE est active : le fichier de journal d'observation doit être mis à jour dans le délai de péremption à l'arrêt (1800 s par défaut, paramétrable via l'env OBSERVATION_LOG_AGE_THRESHOLD_SEC). C'est toute la porte.
Les analyses de marqueurs textuels DOUCES sont DÉSACTIVÉES (causaient des blocages intempestifs car le texte de ma réponse varie à chaque tour). L'entrée de journal structurée elle-même porte le résultat de l'analyse — c'est une piste d'audit suffisante.
Règle pratique pour chaque tour :
- Ajoutez une entrée dans
observations.jsonlavant de vous arrêter. N'importe laquelle. detected=true ou detected=false, peu importe pour la porte. - Continuez à faire des entrées structurées riches (champs de détection, notes root_cause, texte de confirmation) — elles rendent la mémoire locale / la piste d'audit plus utiles, même si la porte ne les vérifie pas. Tronquez tout extrait de message utilisateur à ~200 caractères et ne copiez jamais de secrets / identifiants dans le journal.
- Pas besoin de coller de marqueurs SCAN dans le texte de la réponse.
Pourquoi c'est important : la porte ne bloque que lorsque le journal n'a vraiment pas été écrit (un véritable oubli), et non lorsque la formulation de la réponse échoue à une regex de texte — cela évite les blocages intempestifs.
Drapeaux Rouges — ARRÊTEZ-VOUS
Si vous vous surprenez à penser à l'une de ces choses, ARRÊTEZ-VOUS et effectuez l'analyse :
- "Ce n'est qu'une vérification de statut / une question simple"
- "Je ferai l'analyse après la tâche"
- "La tâche est plus urgente que l'analyse"
- "J'ai déjà analysé récemment, je saute celle-ci"
- "Il n'y a évidemment rien ici"
- "Je suis en plein milieu de quelque chose de complexe"
- "Ce message est trop court pour contenir des signaux"
- "NOOP / UPDATE n'a pas besoin de texte de confirmation" → faux ; le chemin detected=true nécessite une confirmation (voir
## Stratégie de Confirmation)
Prévention de la Rationalisation
| Excuse pour ne pas enregistrer | Réalité |
|---|---|
| "C'est une décision méthodologique, pas une préférence" | Les décisions méthodologiques SONT des préférences |
| "Ce sera dans le code" | Le code n'est pas la mémoire. La prochaine session ne lira pas le code |
| "Trop évident pour être enregistré" | Si c'est évident, pourquoi l'avez-vous violé ? Enregistrez-le |
| "Déjà couvert par la mémoire existante" | Citez l'atomic_id ou ce n'est pas couvert |
| "Non réutilisable / instruction unique" | Alors dites-le dans la réponse — laissez l'utilisateur vous corriger |
| "Je suis sûr que ce n'est pas un signal" | La confiance n'est pas une preuve. Sur-détectez, ne sous-détectez pas |
Détection Basée sur les Principes (toujours primaire)
Les motifs ci-dessous sont des exemples initiaux, PAS une liste de contrôle exhaustive. La formulation de l'utilisateur varie ; la correspondance littérale de motifs manque la plupart des signaux. Appliquez d'abord les principes de manière sémantique, utilisez les motifs comme indices.
Principes de Détection (à appliquer dans cet ordre à chaque tour)
-
Toute clause exprimant comment l'utilisateur souhaite que les choses soient faites → préférence
- Y compris les déclarations de valeur à la première personne (« J'aime / J'espère / Je pense que X est bien »), les affirmations normatives (« X devrait / doit / ferait mieux d'être Y »), les préférences comparatives (« X est mieux que Y »)
- Indépendamment du fait qu'elle soit formulée comme une instruction, une raison, une plainte ou une remarque en passant
-
Toute clause exprimant de la frustration ou corrigeant votre comportement → friction ou piège
- Marqueurs de frustration : répétition (« encore » / « toujours »), exaspération (« pourquoi est-ce que c'est encore… »), questions rhétoriques (« ne t'ai-je pas déjà dit… »), sarcasme (« laisse tomber »)
- Même si elle est édulcorée (« en fait » / « c'est bon » / « laisse tomber »), l'édulcorant masque souvent un signal réel
-
Toute clause de raison / justification dans le message → analyser indépendamment
- Structure utilisateur
[instruction] + [raison]— la raison énonce souvent POURQUOI ils ont cette préférence, ce QUI EST le contenu de la préférence - Marqueurs : parce que / principalement / je veux / j'aimerais / donc / ainsi / afin de
- Structure utilisateur
-
Toute méta-question sur votre comportement → friction (vous avez fait quelque chose qu'ils veulent reconsidérer)
- « est-ce que c'est X ? » / « que penses-tu de Y ? » / « pourquoi as-tu fait cela ainsi ? » / « est-ce que c'est Z ? » — l'utilisateur remet en question votre choix, pas ne demande votre avis
-
Acceptation silencieuse d'une approche inhabituelle ou pivot propre après votre suggestion → préférence validée
- L'absence de contestation EST un signal. Surtout lorsque vous avez pris une décision qu'ils auraient pu corriger.
L'asymétrie des coûts (valeurs par défaut)
- Coût d'un faux positif (marquer un non-signal comme signal) : l'utilisateur dit « non, unique » → vous apprenez quelque chose. ~1 tour de perte.
- Coût d'un manquement : l'utilisateur frustré pendant plusieurs tours, la même erreur se répète session après session, la correction éventuelle demande beaucoup d'efforts.
- → Par défaut : détectez, demandez en cas de faible confiance, enregistrez en cas de confiance moyenne ou plus.
Ne vous arrêtez pas aux motifs
Si le message ne correspond à aucun motif listé mais que l'un des 5 principes se déclenche → c'est toujours un signal. Les motifs sont des points d'ancrage ; les principes sont la règle.
Détection de Signaux Implicites
Voici des exemples concrets des principes ci-dessus — bibliothèque de motifs initiaux, pas l'ensemble complet. Analysez d'abord sémantiquement (voir les principes), utilisez-les comme indices :
| L'utilisateur dit | Sens apparent | Signal réel | Indice |
|---|---|---|---|
| « ne devrais-tu pas vérifier ailleurs ? » | Question | friction : tu aurais déjà dû le faire | Suite à votre erreur |
| « encore… » / « toujours… » / « pourquoi est-ce que c'est encore… » | Frustration | piège : même erreur répétée | 2e+ occurrence |
| « ne t'ai-je pas déjà dit ? » | Question rhétorique | friction : la règle existe mais n'a pas été suivie | Fait référence à la mémoire |
| « oui » + correction | Accord partiel | préférence : renforcement d'une règle existante | Redirection subtile |
| Accepte silencieusement une approche inhabituelle | Pas de contestation | préférence : décision validée | Absence de correction |
| « parce que… je veux… » | Justification d'une demande | préférence : la clause « parce que » énonce la règle elle-même | Les clauses de rationalisation contiennent souvent la préférence, pas seulement le contexte |
| « vérifie-le, parce que je veux… » | Instruction de tâche | préférence : mode de réponse préféré (empirique > théorique) | La clause « parce que » révèle une préférence de style de travail, distincte de la tâche |