moyu-ja

Aperçu de moyu-ja

moyu-ja est une skill japonaise de code editing qui aide une IA à rester strictement minimaliste quand une demande de modification est étroite. Elle convient particulièrement aux développeurs qui veulent un diff petit et exact plutôt qu’une réécriture « utile », surtout lorsqu’ils connaissent déjà le fichier cible, la fonctionnalité ou la plage de lignes à modifier.

Le vrai rôle de la skill moyu-ja est de maîtriser le périmètre : ne modifier que ce que l’utilisateur a demandé, choisir la correction la plus simple qui fonctionne, et s’arrêter si la demande reste ambiguë ou risque d’essaimer vers des fichiers sans rapport. Cela la rend utile pour la maintenance, les corrections de bugs et les modifications guidées par la revue, là où le principal risque est de sur-ingénieriser.

Son principal facteur de différenciation, c’est sa retenue. La skill est conçue pour décourager les abstractions superflues, les dépendances supplémentaires, les tests en trop et la documentation inutile lorsqu’ils n’ont pas été demandés. Si vous voulez un modèle qui préserve l’architecture existante et change le moins possible, moyu-ja est un excellent choix.

moyu-ja pour le code editing

Utilisez moyu-ja quand la consigne est : « change ceci, pas cela ». Elle est adaptée aux tâches de code editing où la sortie la plus sûre est aussi la plus petite : une correction en une ligne, un remplacement ciblé ou un patch contraint dans un fichier connu.

Ce que cette skill fait bien

• Maintenir les modifications dans le périmètre indiqué par l’utilisateur
• Éviter les refactorings inutiles et les couches d’enrobage
• Préférer les chemins de code existants à une nouvelle structure
• Demander une confirmation quand la demande manque de précision

Quand elle est mal adaptée

Si vous cherchez un nettoyage architectural, un refactoring large ou une solution qui revoit la conception autour du point concerné, moyu-ja paraîtra trop conservatrice. Elle n’est pas faite pour les demandes du type « améliore tout le module pendant que tu y es ».

Comment utiliser la skill moyu-ja

Installer et activer moyu-ja

Installez la skill moyu-ja dans votre environnement de skills, puis invoquez-la pour les tâches de modification où la retenue compte. Une commande d’installation typique dans ce dépôt est :

npx skills add uucz/moyu --skill moyu-ja

Utilisez moyu-ja lorsque votre prompt contient une demande de modification clairement bornée, par exemple corriger une fonction, ajuster une condition ou appliquer un minuscule changement de comportement.

Donner un brief de modification très précis

La meilleure utilisation de moyu-ja commence par un prompt qui nomme la cible exacte et la limite exacte. Les bons prompts disent quoi changer, où le changer, et ce qui ne doit surtout pas changer.

Modèle de prompt solide :

• « Dans src/auth.ts, ne modifie que la logique d’analyse du jeton. Ne touche pas à la validation sans rapport. »
• « Mets à jour ce composant pour qu’il gère une entrée vide, mais conserve la structure actuelle et n’ajoute pas de nouveaux fichiers. »
• « Fais la correction la plus petite possible pour le cas défaillant dans PaymentForm ; n’ajoute pas de nouvelles abstractions. »

Modèle de prompt faible :

• « Améliore ce code. »
• « Rends-le plus propre. »
• « Refactorise ce module. »

Lire le source dans le bon ordre

Pour cette skill, commencez par SKILL.md, puis inspectez l’arborescence du dépôt pour repérer d’éventuels fichiers de guidance adjacents liés depuis le repository. Si le projet inclut README.md, AGENTS.md, metadata.json ou des dossiers de support comme rules/, resources/, references/ ou scripts/, lisez-les seulement si cela est nécessaire pour clarifier le périmètre et les contraintes.

L’essentiel est de ne pas trop lire. moyu-ja fonctionne mieux quand vous identifiez le minimum de contexte nécessaire pour modifier en sécurité, puis que vous vous arrêtez là.

Un workflow qui donne de meilleurs résultats

1. Identifiez le fichier exact et le comportement exact à modifier.
2. Formulez le résultat souhaité en une seule phrase.
3. Ajoutez des contraintes comme « diff minimal », « pas de nouveaux fichiers » ou « pas de nouvelle dépendance » quand elles comptent.
4. Demandez d’abord la correction la plus petite acceptable.
5. Si le modèle pose une question de clarification, répondez-y au lieu d’élargir la tâche.

Ce workflow correspond à l’esprit de moyu-ja : entrée précise, périmètre minimal, zéro supposition.

FAQ sur la skill moyu-ja

moyu-ja est-elle réservée aux workflows japonais ?

Non. Le contenu de la skill est en japonais, mais le comportement de modification qu’elle impose est général : rester minimal, rester dans le périmètre, et éviter les changements inutiles. La skill moyu-ja reste utile même si votre dépôt et vos prompts sont en anglais.

En quoi est-ce différent d’un prompt normal ?

Un prompt normal peut demander une modification soigneuse, mais moyu-ja encode cette discipline comme comportement par défaut. C’est important quand le modèle est tenté d’« aider » en réécrivant trop, en ajoutant des abstractions ou en touchant des fichiers adjacents.

moyu-ja convient-elle aux débutants ?

Oui, si l’objectif est d’apprendre à faire des modifications plus petites et plus sûres. Elle est particulièrement utile quand les débutants ont tendance à surcorriger le code ou à ajouter des couches inutiles.

Quand ne faut-il pas utiliser moyu-ja ?

N’utilisez pas moyu-ja quand la vraie tâche est une refonte, un nettoyage sur plusieurs fichiers ou une amélioration plus large. Si vous voulez que le modèle réévalue l’architecture, une skill de code plus expansive sera mieux adaptée.

Comment améliorer la skill moyu-ja

Donner des signaux de périmètre plus serrés

L’amélioration la plus importante consiste à préciser la frontière de la modification. Nommez le fichier, la fonction, la plage de lignes ou le comportement exact. Plus la frontière est explicite, moins la skill risque de dépasser le cadre.

Énoncer les contraintes qui comptent

Si vous tenez à préserver le style d’implémentation, dites-le. Si vous ne voulez ni nouvelles classes, ni nouveaux helpers, ni nouvelles dépendances, ni commentaires, ni tests, ni documentation, dites-le explicitement. moyu-ja est d’autant plus efficace que le prompt rend la règle du « faire moins » concrète.

Demander la correction la plus petite acceptable

Une boucle d’amélioration utile avec moyu-ja consiste à demander d’abord le patch viable minimal, puis à n’élargir que si ce patch ne couvre pas une exigence réelle. Par exemple, commencez par « corrige ce bug avec le diff le plus petit possible », puis itérez seulement si la première réponse manque un besoin concret.

Surveiller les modes d’échec liés à la sur-ingénierie

Le principal mode d’échec que cette skill cherche à éviter est l’élargissement de périmètre : fichiers sans rapport modifiés, abstractions ajoutées pour corriger un cas ponctuel, ou code défensif introduit pour des situations que l’utilisateur n’a jamais demandées. Si cela arrive, resserrez le prompt autour de la modification exacte et réaffirmez l’interdiction de tout travail supplémentaire.