tencentmusic/modus

Modus-Entwicklung und -Schreiben

Dies ist eine zusammengesetzte Fähigkeit, die dem Modus-Framework selbst dient. Ein Einstiegspunkt verbindet globales Verständnis, Modulentwicklung, Testen/Veröffentlichung und Artikelverfassen; Modulhandbücher werden je nach Aufgabe geladen, ohne das gesamte Referenzverzeichnis auf einmal in den Kontext zu packen.

Zuerst das aktuelle Projekt bestimmen

Der Quellcode-Pfad basiert auf dem vom Benutzer angegebenen Checkout; falls nicht angegeben, wird das aktuelle Git-Repository-Root verwendet. Das Skill-Verzeichnis wird durch den Speicherort des geladenen SKILL.md bestimmt. Beim ersten Betreten eines Checkouts wird SKILL_DIR auf dieses Skill-Verzeichnis gesetzt und eine schreibgeschützte Diagnose im Modus-Repository-Root ausgeführt:

python3.11 "$SKILL_DIR/scripts/inspect_repository.py" --root .

Es überprüft Branch, HEAD, Upstream, lokale Änderungen, Paketversion und Abweichungen von der Wissensbasis, ohne Netzwerkzugriff, ohne in das Repository zu schreiben und ohne installiertes Modus aufzurufen. Verwenden Sie einen beliebigen Python 3.11+ Interpreter. Ersetzen Sie python3.11 im Beispiel nach Bedarf für Ihre Umgebung.

Der Wissens-Snapshot stammt von modus-open / 49c51621f378a58d6724eedde4657d9505346d45, dem Distributionspaket openmodus 0.0.4. Unterschiedliche Branches, Versionen oder Dateiänderungen bedeuten, dass relevante Handbücher gegen die aktuelle Implementierung überprüft werden müssen; wechseln Sie nicht automatisch den Branch, aktualisieren Sie keine persönliche CLI und generieren Sie kein Projektwissen.

Lesen Sie zuerst den globalen Überblick, und wählen Sie dann das Handbuch gemäß der folgenden Tabelle aus. Wenn Sie mit dem Projekt bereits vertraut sind und die Aufgabe klar ist, können Sie direkt zum entsprechenden Modul springen.

Aufgabenrouting

Aktuelle Aufgabe	Lesen
Funktionsentwicklung, Fehlerbehebung, Refactoring, Code-Review	Entwicklungsablauf + entsprechendes Modul + Validierung und Veröffentlichung
Hilfe, Parameter, Exit-Codes, chinesische Benutzererfahrung, persönliche Paketwartung	CLI- und Wartungseinstieg
Integration, Upgrade, Deinstallation, Manifest, Asset-Konflikte, Git-Schutz	Projektinstallation und -verantwortlichkeiten
CodeBuddy / Claude / Cursor / Codex-Integration, Start-Hooks	Plattformen und Hooks
Quellcode-Erkennung, Freezing, Parsing, Compiler, Sprach-Erweiterungen, Cache-Treffer	N1–N2: Quellcode und Beobachtung
Identitätsauflösung, Aufrufbeziehungen, Topologie, Einstieg zu Effekt, Fähigkeitsdurchlauf	N3–N4: Auflösung und Fähigkeiten
Bereichskandidaten, Clustering-Vorschläge, Beweispakete, Kontext, Cursor, Zusammenfassung	N5–N6: Projektion und Bereitstellung
Aktueller Projektkontext, Wissens-Routing, Ranking, Quellcode-Rückgriff, Budget	Suche und Orchestrierung
Markdown-Identität, CAS, Wissensaktualisierung, Ankerpunkte, Vollständigkeits- und Veröffentlichungsprüfung	Wissen schreiben und verifizieren
init/reinit/update/sync-Verhalten, Textgenerierung, Bereichsbestätigung, Vorlagen	Wissenserstellungs-Workflow
Multi-Repo-Arbeitsbereich, Mitgliederadressierung, äußere Navigation, Isolation	Arbeitsbereich
Wheel, Quellpaket, Abhängigkeiten, CI, Testauswahl	Validierung und Veröffentlichung
Artikel, Berichte, technische Einführung, Gliederung für Präsentationen, Architekturdiagramme	Quellcode-Basis und Schreiben; die beteiligten Mechanismen lesen Sie bitte im entsprechenden Modul nach
Überprüfung von iwiki, alten Materialien oder dieser Fähigkeit zugrunde liegenden Quellen	Quellen und Unterschiede

Häufigste Fehlergrenzen

• Modus-Installation/-Integration, Initialisierungsbeweise und langfristiges Markdown-Wissen haben unterschiedliche Eigentümer. modus init installiert Assets; /modus-init wird vom Assistenten analysiert und Wissen erstellt.
• Normale Suche liest den aktuellen Quellcode und formales Markdown. Initialisierungsanalyse-Caches werden nicht zur faktischen Quelle für den täglichen Betrieb; neue Fähigkeiten importieren machine nicht in den normalen CLI-Pfad.
• N1–N6 sind deterministische Beweisverarbeitung, K1–K6 sind semantische Kreation des Assistenten. Fähigkeitskombinationen rufen kein LLM auf, Kandidaten- und Repräsentationspfade entsprechen nicht formellen Domänen oder vollständigen Ausführungspfaden.
• Installations-/Aktualisierungstransaktionen und Wissensaktualisierungen haben unterschiedliche Fehlersemantiken. Wissensaktualisierungen werden pro Datei eingereicht und melden Teilerfolge, ein vollständiger Rollback wird nicht zugesichert.
• .modus/ und Host-Kopien sind verwaltete Integrations-Assets; modus/knowledge/ ist langfristiges Wissen; manuelles constraint/, references/business/ haben unabhängigen Schutz.
• clean beweist nur die vom Prüfer abgedeckte Vollständigkeit oder Veröffentlichungszusage, nicht die inhaltliche Wahrheit, Vollständigkeit, Klarheit oder den Erfolg zur Laufzeit.
• Befehle, JSON-Felder, Statuscodes, stabile IDs und chinesische Anzeige werden getrennt gewartet. Vorlagen sind produktausgelieferte Verhaltensverträge.

Aufgabe abschließen

Entwicklungsergebnisse beschreiben konkretes Verhalten, den Änderungseigentümer, tatsächliche Validierung und nicht validierte Grenzen. Schreibergebnisse trennen die aktuelle Implementierung, Designziele, historische Materialien und Effektbeweise. Das Referenzieren dieser Fähigkeit beschleunigt die Lokalisierung, aber Implementierungsschlussfolgerungen müssen durch erneutes Lesen des aktuellen Quellcodes überprüft werden.

Diese Fähigkeit unterstützt die nachfolgende Entwicklung, gewährt jedoch keine Rechte zum Veröffentlichen, Committen, Pushen, Schreiben in externe Dokumente oder Delegieren; diese Aktionen unterliegen den Berechtigungen der aktuellen Benutzeraufgabe. Verwenden Sie diese Fähigkeit nicht, um automatisch Wissen neu zu erstellen, die Fähigkeit zu aktualisieren oder nicht zusammenhängende Assets zu ändern.