Monozukuri : faire écrire à votre agent du code sobre et vérifiable grâce au processus d'artisanat japonais

À qui cela s'adresse

• Aux développeurs qui souhaitent que leur agent suive un processus vérifiable lors de l'écriture de code (Observer → Comprendre → Planifier → Réaliser → Vérifier → Réfléchir → Améliorer), plutôt que de produire le code en une seule fois.
• Aux utilisateurs d'agents prenant en charge le format Agent Skills : chaque compétence est un répertoire <name>/SKILL.md au premier niveau, et la documentation officielle indique sa compatibilité avec tout agent supportant ce format. Invoquer explicitement via $monozukuri-core.
• Quand ce n'est pas adapté : les preuves n'indiquent pas les versions d'environnement d'exécution dont il dépend, ne listent aucun clients vérifiés, et ne précisent pas la prise en charge des tâches textuelles/documentaires — cette compétence est destinée à la construction et la maintenance logicielle ; ne présumez aucun autre usage tant que les preuves ne le mentionnent pas.
• Ce que l'éditeur officiel ne précise pas : les langages de programmation pris en charge, la nécessité d'un accès réseau, ni les limites précises des effets de bord de chaque compétence — aucune preuve à ce sujet ; vérifiez par vous-même avant usage.

Première tentative en 3 minutes

Prérequis : Node.js/npx installé sur votre machine ; un agent prenant en charge le format Agent Skills. L'éditeur officiel propose deux méthodes d'installation ; seule une voie principale est recommandée ici :

Voie principale : installer la compétence centrale via la CLI skills

À la racine du projet, exécutez :

npx skills add kuya-egg/Monozukuri --skill monozukuri-core

Cela n'installe que la compétence parapluie monozukuri-core. Si vous souhaitez ensuite installer les 12 compétences (la parapluie + 11 compétences ciblées), la même CLI officielle accepte un caractère générique :

npx skills add kuya-egg/Monozukuri --skill '*'

(L'éditeur propose aussi une installation en tant que plugin Claude Code : /plugin marketplace add kuya-egg/Monozukuri puis /plugin install monozukuri@monozukuri, ce qui installe les 12 compétences et les charge sous l'espace de noms monozukuri ; cet article ne la présente pas comme voie principale.)

Déclencher une tâche à faible risque : une fois l'installation effectuée, saisissez explicitement $monozukuri-core dans l'agent et confiez-lui une petite tâche en lecture seule / d'analyse, par exemple « vérifier la correction et la sobriété d'une petite fonction selon le processus craftsmanship ». Le flux de travail principal est Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen.

Signaux de réussite : l'agent structure sa réponse selon les sept phases ci-dessus au lieu de balancer directement du code ; lorsque les compétences ciblées s'enchaînent dans l'ordre officiel (nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka), cela indique que toutes les compétences sont actives. Attention : cette compétence est destinée aux tâches de code ; il n'existe pas de rubriques pour les romans ou les documents professionnels ; si vous lui confiez une tâche de rédaction, les preuves ne garantissent pas l'existence d'un processus correspondant. $monozukuri-core n'est qu'un moyen de déclenchement explicite ; le fait qu'il lise/écrive des fichiers, exécute des commandes ou accède au réseau n'est pas précisé par l'éditeur — pour la première tentative, choisissez une tâche sans effet de bord.

Cas d'usage

Cas 1 : revue soignée d'une petite fonction Scénario : vous voulez que l'agent examine attentivement un code existant. Lancement : saisissez $monozukuri-core dans un agent compatible, avec le code cible et la demande d'une évaluation selon le processus. Flux de travail : celui de la compétence parapluie, Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen. Résultat attendu : l'agent fournit observation, compréhension, plan et suggestions de vérification phase par phase, sans réécrire directement ; le fait qu'il attende votre confirmation avant de modifier des fichiers n'est pas précisé par les preuves — demandez explicitement une analyse sans modification de fichiers.

Cas 2 : développement complet d'une fonctionnalité via la chaîne de compétences ciblées Scénario : installez d'abord toutes les compétences (--skill '*' ou via le plugin Claude Code), puis demandez à l'agent de développer une petite fonctionnalité. Flux de travail : les compétences ciblées s'enchaînent dans l'ordre officiel nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka, couvrant toute la chaîne de la préparation à la vérification. Résultat attendu : l'agent progresse selon les phases de chaque compétence et livre les produits de chaque étape ; les déclencheurs propres à chaque compétence ciblée et leurs effets de bord précis ne sont pas détaillés dans les preuves — confirmez avec l'agent, avant toute exécution, si chaque étape modifiera le code.

Limites d'utilisation

• Installation distincte selon la plateforme : la CLI skills (npx skills add ...) est la voie universelle ; la plateforme Claude Code utilise /plugin marketplace add + /plugin install monozukuri@monozukuri, installant les 12 compétences sous l'espace de noms monozukuri. Ne mélangez pas les deux et ne déduisez pas la méthode d'installation d'autres clients.
• Mode de déclenchement : l'éditeur indique l'appel explicite de $monozukuri-core ; la syntaxe d'invocation des autres compétences n'est pas documentée dans les preuves.
• Effets de bord et points de confirmation : cette compétence guide l'agent dans l'écriture de code, mais les preuves ne précisent pas s'il modifie directement vos fichiers, exécute des commandes ou accède au réseau ; tout cela reste inconnu. Privilégiez pour la première tentative une tâche d'analyse en lecture seule, et exigez que l'agent présente son plan avant toute modification.
• Limites officielles explicites : installé seul, monozukuri-core ne contient que le flux de la compétence parapluie ; la chaîne complète exige l'installation des 12 compétences. L'éditeur ne fournit ni les langages de programmation pris en charge, ni les environnements linguistiques, ni les exigences réseau, ni la liste des clients.
• Informations clés non confirmées : le comportement précis de chaque compétence ciblée, les méthodes de mise à jour/désinstallation, et les conditions d'utilisation hors licence ne figurent pas dans les preuves — consultez le dépôt original avant usage.