Skills

Monozukuri: Mit japanischem Handwerksablauf Agents schlichten, überprüfbaren Code schreiben lassen

Monozukuri eignet sich am besten, um Agents nach japanischem Handwerksablauf schlichten und überprüfbaren Softwarebau und -wartung durchführen zu lassen – vorher aber prüfen, ob dein Agent das Agent-Skills-Format unterstützt; ob der Skill Dateien verändert, Befehle ausführt oder aufs Netz zugreift, ist offiziell nicht angegeben.

Official source · kuya-egg/Monozukuri

Install

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

Für wen ist das geeignet?

  • Für Entwickler:innen, die wollen, dass der Agent beim Schreiben von Code einem überprüfbaren Ablauf folgt (Beobachten → Verstehen → Planen → Umsetzen → Verifizieren → Reflektieren → Verbessern), statt einfach einmalig Code auszugeben.
  • Für Nutzer:innen von Agents, die das Agent-Skills-Format unterstützen: Jede Skill ist ein Verzeichnis <name>/SKILL.md auf oberster Ebene; laut offizieller Beschreibung ist sie mit jedem Agent kompatibel, der dieses Format unterstützt. Aufruf erfolgt explizit über $monozukuri-core.
  • Nicht geeignet, wenn: Die Quellen nennen keine konkrete Laufzeitversion, keine geprüfte Liste unterstützter Clients und keine Aussagen zur Unterstützung von Text-/Dokumentationsaufgaben – dieser Skill richtet sich an Softwarebau und -wartung; wenn die Belege andere Verwendungszwecke nicht abdecken, bitte nichts annehmen.
  • Von offizieller Seite ungeklärt: unterstützte Programmiersprachen, ob Netzwerkzugriff nötig ist, sowie die konkreten Nebeneffekt-Grenzen der einzelnen Skills – dazu gibt es keine Belege; bitte vor der Nutzung selbst verifizieren.

Erster Versuch in 3 Minuten

Voraussetzung: Node.js/npx auf dem Rechner sowie ein Agent, der das Agent-Skills-Format unterstützt. Es gibt offiziell zwei Installationswege; hier wird nur ein Hauptweg empfohlen:

Hauptweg: Kern-Skill über die skills CLI installieren

Im Projektstammverzeichnis ausführen:

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

Damit wird nur der Umbrella-Skill monozukuri-core installiert. Wer später alle 12 Skills installieren möchte (Umbrella-Skill + 11 fokussierte Skills), kann mit derselben offiziellen CLI einen Platzhalter verwenden:

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

(Offiziell gibt es zusätzlich eine Installation als Claude-Code-Plugin: nach /plugin marketplace add kuya-egg/Monozukuri dann /plugin install monozukuri@monozukuri; dabei werden alle 12 Skills installiert und unter dem Namespace monozukuri geladen. Dies wird hier nicht als gleichwertiger Hauptweg dargestellt.)

Eine risikoarme Aufgabe auslösen: Nach der Installation $monozukuri-core im Agent explizit eingeben und eine kleine Nur-Lese-/Analyseaufgabe stellen, z. B. „Prüfe nach dem craftsmanship-Ablauf Korrektheit und Schlichtheit einer kleinen Funktion“. Der Kern-Workflow lautet Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen.

Erfolgssignal: Der Agent gliedert seine Antwort nach den sieben oben genannten Phasen, statt direkt Code auszuspucken; wenn die fokussierten Skills in der offiziellen Reihenfolge verkettet werden (nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka), sind alle Skills aktiv. Hinweis: Dieser Skill ist auf Codeaufgaben ausgerichtet; es gibt keinen separaten Rubric-Pfad für Romane/Fachdokumente. Wenn man ihm Textschreibaufgaben gibt, garantiert die Beleglage keinen passenden Ablauf. $monozukuri-core ist nur die explizite Auslösemethode; ob er Dateien liest/schreibt, Befehle ausführt oder aufs Netz zugreift, ist offiziell nicht angegeben – wähle für den ersten Versuch eine Aufgabe ohne Nebenwirkungen.

Anwendungsfälle

Fall 1: Handwerkliche Prüfung einer kleinen Funktion Szenario: Du möchtest, dass der Agent bestehenden Code sorgfältig unter die Lupe nimmt. Auslösung: Im unterstützten Agent $monozukuri-core eingeben, den Zielcode anhängen und eine Bewertung nach dem Ablauf verlangen. Verwendeter Workflow: Umbrella-Ablauf Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen. Erwartbares Ergebnis: Der Agent liefert phasenweise Beobachtungen, Verständnis, Plan und Verifikationsempfehlungen, statt Code direkt umzuschreiben; ob eine Bestätigung vor Dateiänderungen nötig ist, ist unbelegt – am besten explizit verlangen, nur zu analysieren und keine Dateien zu ändern.

Fall 2: Komplette Feature-Entwicklung über die fokussierte Skill-Kette Szenario: Zuerst alle Skills installieren (--skill '*' oder den Claude-Code-Plugin-Weg), dann den Agent ein kleines Feature entwickeln lassen. Verwendeter Workflow: Die fokussierten Skills in der offiziellen Reihenfolge nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka verkettet, über die gesamte Kette von Vorbereitung bis Verifikation. Erwartbares Ergebnis: Der Agent geht die Phasen der einzelnen Skills durch und liefert zu jeder Phase einen Output; die Auslösemechanismen und konkreten Nebeneffekte der einzelnen Skills sind in den Belegen nicht ausgeführt – kläre vor der Ausführung mit dem Agent, ob ein Schritt Code verändert.

Nutzungsgrenzen

  • Installationsunterschiede je Plattform: Die skills CLI (npx skills add ...) ist der allgemeine Weg; auf Claude Code erfolgt die Installation über /plugin marketplace add + /plugin install monozukuri@monozukuri, wodurch alle 12 Skills mit dem Namespace monozukuri installiert werden. Beides nicht vermischen und nicht auf andere Clients schließen.
  • Auslösemethode: Laut offizieller Beschreibung expliziter Aufruf von $monozukuri-core; die Aufrufsyntax der anderen Skills ist unbelegt.
  • Nebeneffekte und Bestätigungspunkte: Der Skill leitet den Agent zum Schreiben von Code an, aber ob er direkt deine Dateien verändert, Befehle ausführt oder aufs Netz zugreift, ist nicht belegt – all das ist unbekannt. Für den ersten Versuch eine Nur-Lese-Analyseaufgabe wählen und vor jeder Änderung verlangen, dass der Agent zuerst den Plan zeigt.
  • Offizielle Einschränkungen: monozukuri-core allein enthält nur den Umbrella-Ablauf; die komplette Skill-Kette erfordert die Installation aller 12 Skills. Offiziell fehlen Angaben zu unterstützten Programmiersprachen, Sprachumgebungen, Netzwerkanforderungen und Client-Listen.
  • Unbestätigte Kerninformationen: Das konkrete Verhalten der einzelnen fokussierten Skills, Update-/Deinstallationswege und Nutzungsbedingungen jenseits der Lizenz werden in den Belegen nicht behandelt – bitte vor der Nutzung das Repository im Original prüfen.