moyu-ja

Überblick über die moyu-ja-Skill

moyu-ja ist eine japanische Skill für Code-Editing, die einem KI-Modell hilft, bei klar eingegrenzten Änderungswünschen streng minimal zu bleiben. Sie eignet sich besonders für Entwickler, die statt eines „hilfreichen“ Rewrites lieber einen kleinen, präzisen Diff wollen — vor allem dann, wenn Zieldatei, Feature oder Zeilenbereich bereits bekannt sind.

Die eigentliche Aufgabe der moyu-ja-Skill ist Scope-Kontrolle: nur das ändern, was der Nutzer verlangt hat, die einfachste brauchbare Lösung wählen und innehalten, wenn die Anfrage unklar ist oder in andere Dateien ausufern würde. Das macht sie nützlich für Wartungsarbeiten, Bugfixes und reviewgetriebene Änderungen, bei denen Overengineering das größte Risiko ist.

Ihr Hauptmerkmal ist Zurückhaltung. Die Skill ist darauf ausgelegt, zusätzliche Abstraktionen, zusätzliche Abhängigkeiten, zusätzliche Tests und zusätzliche Dokumentation zu vermeiden, wenn nichts davon verlangt wurde. Wenn Sie ein Modell wollen, das das bestehende Design bewahrt und so wenig wie möglich verändert, ist moyu-ja eine starke Wahl.

moyu-ja für Code-Editing

Verwenden Sie moyu-ja, wenn die Aufgabe lautet: „Ändere genau das, nicht mehr.“ Sie passt zu Code-Editing-Aufgaben, bei denen die sicherste Ausgabe die kleinste ist: ein Einzeiler-Fix, ein gezielter Austausch oder ein begrenzter Patch in einer bekannten Datei.

Wofür diese Skill gut ist

• Änderungen innerhalb des vom Nutzer genannten Umfangs halten
• Unnötige Refactors und Wrapper-Ebenen vermeiden
• Vorhandene Codepfade statt neuer Struktur bevorzugen
• Nach einer Bestätigung fragen, wenn die Anfrage zu ungenau ist

Wann sie schlecht passt

Wenn Sie architektonische Bereinigung, umfangreiches Refactoring oder eine Lösung wollen, die das umliegende Design mitüberarbeitet, wirkt moyu-ja schnell zu konservativ. Sie ist nicht für Anfragen gedacht wie „verbessere gleich das ganze Modul mit“.

So verwenden Sie die moyu-ja-Skill

moyu-ja installieren und aktivieren

Installieren Sie die moyu-ja-Skill in Ihrer Skills-Umgebung und rufen Sie sie dann für Editieraufgaben auf, bei denen Zurückhaltung wichtig ist. Ein typischer Installationsbefehl in diesem Repo ist:

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

Verwenden Sie moyu-ja, wenn Ihr Prompt eine klar begrenzte Änderungsanfrage enthält, etwa das Beheben einer Funktion, das Anpassen einer Bedingung oder das Umsetzen einer kleinen Verhaltensänderung.

Geben Sie ein enges Änderungsbriefing

Die beste Nutzung von moyu-ja beginnt mit einem Prompt, der das genaue Ziel und die genaue Grenze nennt. Gute Eingaben sagen, was geändert werden soll, wo es geändert werden soll und was auf keinen Fall geändert werden darf.

Starkes Prompt-Muster:

• „In src/auth.ts nur die Token-Parsing-Logik ändern. Unabhängige Validierung nicht anfassen.“
• „Dieses Component so anpassen, dass es leere Eingaben verarbeitet, aber die aktuelle Struktur beibehalten und keine neuen Dateien anlegen.“
• „Den kleinstmöglichen Fix für den fehlgeschlagenen Fall in PaymentForm machen; keine neuen Abstraktionen hinzufügen.“

Schwaches Prompt-Muster:

• „Verbessere diesen Code.“
• „Mach ihn sauberer.“
• „Refaktoriere dieses Modul.“

Lesen Sie die Quellen in der richtigen Reihenfolge

Beginnen Sie bei dieser Skill mit SKILL.md und prüfen Sie danach den Repo-Tree auf angrenzende Hinweisdateien, die aus dem Repository verlinkt sind. Wenn das Projekt README.md, AGENTS.md, metadata.json oder Support-Ordner wie rules/, resources/, references/ oder scripts/ enthält, lesen Sie diese nur bei Bedarf, um Umfang und Einschränkungen zu klären.

Wichtig ist, nicht zu viel zu lesen. moyu-ja funktioniert am besten, wenn Sie den minimal nötigen Kontext für eine sichere Änderung identifizieren und dann aufhören.

Workflow, der bessere Ergebnisse liefert

1. Die genaue Datei und das Verhalten identifizieren, das geändert werden soll.
2. Das gewünschte Ergebnis in einem Satz formulieren.
3. Einschränkungen wie „minimaler Diff“, „keine neuen Dateien“ oder „keine neue Abhängigkeit“ ergänzen, wenn sie wichtig sind.
4. Zuerst nach dem kleinsten akzeptablen Fix fragen.
5. Wenn das Modell eine Rückfrage stellt, diese beantworten statt die Aufgabe zu vergrößern.

Dieser Workflow passt zur moyu-ja-Anleitung: präzise Eingaben, enger Scope, kein Rätselraten.

FAQ zur moyu-ja-Skill

Ist moyu-ja nur für japanische Workflows gedacht?

Nein. Der Inhalt der Skill ist japanisch, aber das Verhalten, das sie durchsetzt, ist allgemein: minimal bleiben, den Scope einhalten und unnötige Änderungen vermeiden. Die moyu-ja-Skill ist auch dann nützlich, wenn Ihr Repo und Ihre Prompts auf Englisch sind.

Worin unterscheidet sie sich von einem normalen Prompt?

Ein normaler Prompt kann um sorgfältiges Editieren bitten, aber moyu-ja verankert diese Disziplin als Standardverhalten. Das ist wichtig, wenn das Modell dazu neigt, „helfen“ zu wollen, indem es zu viel umschreibt, Abstraktionen einführt oder benachbarte Dateien anfasst.

Ist moyu-ja für Anfänger geeignet?

Ja, wenn das Ziel ist zu lernen, wie man kleinere und sicherere Änderungen macht. Sie ist besonders hilfreich, wenn Anfänger dazu neigen, Code zu stark zu korrigieren oder unnötige zusätzliche Ebenen einzubauen.

Wann sollte ich moyu-ja nicht verwenden?

Verwenden Sie moyu-ja nicht, wenn die eigentliche Aufgabe ein Redesign, eine Bereinigung über mehrere Dateien hinweg oder ein breiterer Verbesserungsdurchlauf ist. Wenn das Modell die Architektur neu bewerten soll, passt eine umfassendere Coding-Skill besser.

So verbessern Sie die moyu-ja-Skill

Engere Scope-Signale geben

Die wichtigste Verbesserung ist, die Grenze der Änderung klar zu benennen. Nennen Sie die Datei, die Funktion, den Zeilenbereich oder das exakte Verhalten. Je eindeutiger die Grenze ist, desto unwahrscheinlicher ist es, dass die Skill über das Ziel hinausschießt.

Die wichtigen Einschränkungen klar benennen

Wenn Ihnen wichtig ist, den Implementierungsstil zu bewahren, sagen Sie das ausdrücklich. Wenn Sie keine neuen Klassen, Helfer, Abhängigkeiten, Kommentare, Tests oder Dokumentation wollen, sagen Sie das direkt. moyu-ja ist dann am stärksten, wenn der Prompt die Regel „weniger tun“ konkret macht.

Nach dem kleinsten akzeptablen Fix fragen

Ein nützlicher Verbesserungszyklus für moyu-ja ist, zuerst den minimal nötigen Patch anzufordern und nur dann zu erweitern, wenn dieser Patch scheitert. Starten Sie zum Beispiel mit „Behebe diesen Bug mit dem kleinsten Diff“ und iterieren Sie nur, wenn die erste Antwort eine echte Anforderung verfehlt.

Auf Overengineering-Fehlermuster achten

Der wichtigste Fehlerfall, den diese Skill verhindern soll, ist Scope Creep: unbeteiligte Dateien werden geändert, für einen Einzelfix werden Abstraktionen eingeführt oder es wird defensive Logik für Situationen ergänzt, nach denen der Nutzer nie gefragt hat. Wenn das passiert, ziehen Sie den Prompt enger auf die exakte Änderung und wiederholen Sie das Verbot zusätzlicher Arbeit.