Améliorer
Chemins : ${CLAUDE_SKILL_DIR} désigne le dossier contenant ce SKILL.md, et ${CLAUDE_SKILL_DIR}/../.. le dossier .claude/ de l'éditeur deux niveaux au-dessus.
Chaque question à l'utilisateur est posée dans la zone de questions : appelez l'outil AskUserQuestion (2 à 4 options, la recommandée en premier). Uniquement dans un agent dépourvu de cet outil, posez les questions numérotées dans le texte.
Ceci s'exécute dans un checkout du dépôt, pour la personne qui le maintient. Un correctif ici atteint chaque utilisateur lors de sa prochaine mise à jour. S="${CLAUDE_SKILL_DIR}/scripts". Exécutez les scripts avec python3 sur Mac et Linux, py sur Windows.
0. Qui exécute ceci
python3 "$S/improve.py" mode
maintainer uniquement dans un checkout git du dépôt avec AI_EDITOR_MAINTAINER=1 : passez à l'étape 1.
user : les fichiers propres de l'éditeur sont remplacés à chaque mise à jour, ne les modifiez donc jamais (pas de SKILL.md, référence, script ou PRINCIPLES.md). Collectez et sélectionnez comme ci-dessous, puis enregistrez chaque élément accepté dans la couche personnelle de l'utilisateur, que les mises à jour ne touchent jamais (docs/customise.md dans le dépôt) :
un réglage avec taste.py add ... --set ; une règle de mot avec python3 "${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py" rule "<règle>" ; un aspect de légende comme custom/captions/<nom>.json plus taste.py set captions.preset <nom> ; des valeurs par défaut de modèle comme custom/templates/<type>.json. Proposez ensuite taste.py suggest pour que les mainteneurs puissent le corriger pour tout le monde. Arrêtez-vous là.
1. Collecter
python3 "$S/improve.py" collect [--edits D] [--no-gh]
Une ligne par règle, la plus fréquente en premier : nombre de fois qu'elle est apparue, d'où (suggestion, régression de goût, correction d'aperçu, note de révision, ticket GitHub), le propriétaire nommé et jusqu'à trois exemples. Une règle mentionnée par plusieurs utilisateurs, ou redite après avoir été appliquée, vient en premier.
2. Choisir
Affichez le haut de la file d'attente et demandez dans la zone de questions laquelle corriger maintenant (sélection multiple, la plus fréquente en premier, recommandée). Pour chacune, demandez aussi lorsque ce n'est pas clair : Chaque utilisateur (Recommandé) / Uniquement certains styles de créateurs (cela appartient à un champ style.json, pas à une règle) / Pas un correctif (fermez-la).
3. Corriger chacune, dans cet ordre
- La règle. Une ligne dans
${CLAUDE_SKILL_DIR}/../../PRINCIPLES.mdsous la bonne rubrique, nommant où elle est appliquée, et la même règle dans le SKILL.md ou la référence propriétaire. Générale, jamais à propos d'une seule vidéo : « Les zooms s'adoucissent sur au moins 0,5 s », pas « le zoom à 0:12 a saccadé ». - L'application. Le code le plus petit qui fait respecter la règle sans que personne ait à s'en souvenir : un ÉCHEC dans une vérification (
check.py,quality.py,product.py check,ai_tells.py), un refus dans le script qui la briserait (gates.py), une valeur par défaut qui ne peut pas la produire, ou une ligne danstests/check_plugins.pypour une règle du dépôt. Préférez renforcer une vérification existante plutôt que d'en ajouter une. - Le test. Une assertion dans le
demo()de ce script (outests/), construite à partir d'un petit exemple synthétique de l'échec. Exécutez-le avant le correctif et voyez-le échouer, puis après et voyez-le réussir. Une règle que seul un agent peut suivre (demander, expliquer) reçoit à la place un cas d'évaluation dansevals/:prompt.mdplus un correcteurtool_usedoullm. - L'enregistrement.
docs/feedback-matrix.md: la règle, où elle est écrite, ce qui l'applique, ce qui la teste.
4. Tout exécuter
python3 tests/check_plugins.py
python3 .claude/lib/ai_editor/okf.py check
Ensuite tests/demos.sh (demo de chaque script), node tests/test_record.mjs, et lorsque le moteur de rendu est configuré tests/smoke.py et tests/golden.py. Tout vert avant de remettre. Ne committez pas ; le mainteneur examine la différence et commit.
Sur un ticket GitHub désormais corrigé, proposez de commenter un résumé d'une ligne du correctif et de le fermer (gh issue close <n> --comment "..."), uniquement après avoir demandé.
Jamais
- Ne modifiez jamais le taste.md, taste.json, rules.json ou suggestions.jsonl d'un utilisateur : ils lui appartiennent.
- Ne mettez jamais de données personnelles dans le dépôt : pas de noms, identifiants, adresses email, noms de fichiers ou séquences provenant des retours. Écrivez la règle générale et un exemple synthétique.
tests/check_plugins.pyéchoue sur les noms privés connus ; lisez chaque exemple avant de l'intégrer. - Ne bouclez jamais avec une seule note. Une règle sans application et sans test n'est pas terminée.
Fichiers
scripts/improve.py:mode,collect,demo. Lecture seule.${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py: le dossier<library>/custom/de l'utilisateur (le mode utilisateur y écrit).${CLAUDE_SKILL_DIR}/../../skills/taste/scripts/taste.py: là oùsuggestetissueécrivent le côté utilisateur.