xEdit-Automation — Hub-Skill
Dieser Skill ist der immer geladene Einstiegspunkt für jegliche xEdit-Arbeit. Er ist die einzige Quelle der Wahrheit für „Welchen Pfad benutze ich?“ und „Was darf ich niemals tun?“. Spezialisierte Aufgaben-Skills (z. B. xedit-conflict-audit) erben sein Routing, seine Anti-Patterns und seine Überprüfungsdisziplin; sie wiederholen sie nicht.
Toolbox auf einen Blick (progressive-disclosure, r6-bewusst)
Der geforkte xEdit-Daemon wird am besten als progressive-disclosure-Oberfläche behandelt:
Starte mit den kleinen MCP-Intent-Tools, frage den laufenden Daemon, welche r6-Fähigkeitsblöcke
er unterstützt, und wechsle dann zu den leistungsstärkeren Ein-Aufruf-Mustern, nur wenn der
entsprechende system.capabilities.supports.*-Schlüssel vorhanden ist.
- Discovery & Session —
xedit_session,xedit_list_capabilities. Rufexedit_sessionzuerst in jeder Unterhaltung auf. Rufe dannxedit_list_capabilitieseinmal auf, um die Befehlsübersicht, „contractVersionExpected“ und die r6-supports.*-Anker zu sehen. - Lesen von Datensätzen & Konflikten —
xedit_find_record,xedit_read_record,xedit_inspect_conflicts. Diese bilden das W2-Konfliktaudit-Rückgrat; verzweige zum Atomic-Passthrough, wenn W2 einen r6-Antwortblock benötigt, den noch kein Intent-Tool bereitstellt. - Atomic-Passthrough —
xedit_call(command, args). Für jeden nativen Daemon-Befehl, für den es noch kein Intent-Tool gibt. Durchläuft dennoch die vollständige Pipeline (Validierung → Zustand → Regeln → Audit). Verwende es, wenn die Intent-Tools nicht passen.
Tiefgehendes Referenzmaterial findest du zuerst in der strukturierten BGS-KB (bgs_kb_query
/ bgs_kb_get). Tiefgehende Referenzdatensätze befinden sich unter
knowledge/bgs-kb/packs/core/records/xedit/ (abfragbar via bgs_kb_query /
bgs_kb_get).
Routing-Doktrin (welcher Pfad zu verwenden ist)
| Aufgabenform | Pfad |
|---|---|
| Hochfrequente bekannte Absicht (Konflikt auditieren, Datensatz lesen, Job ausführen, Patch schreiben) | MCP-Intent-Tool |
| Neu / Debugging / freie Zusammensetzung nativer Befehle | MCP-Atomic-Passthrough: xedit_call(command, args) — weiterhin im Harness |
| Explorative Atomic-Op-Stürme (Versuch und Irrtum, wiederholtes Read-Eval, Hypothesentest) | An einen schreibgeschützten Investigator-Sub-Agenten delegieren mit geladenem Skill; der Sub-Agent verbraucht seinen eigenen Kontext, gibt eine destillierte Zusammenfassung zurück |
| Große, formalisierbare Bulk-Mutation | MCP xedit_run_script (Batch 4+) mit Dry-Run + Snapshot |
| Daemon explizit im Standardmodus (nicht MCP), nur manuelles Debugging | Direkt xedit-client.ps1 ist akzeptabel — aber NUR, wenn der Benutzer das Risiko explizit akzeptiert hat und der Daemon nicht im -automation-mcp-mode ist |
Der Agent sollte niemals einen Grund haben, das MCP zu umgehen. Atomic-Passthrough existiert dafür.
Patch-Erstellungsbeurteilung / Patch authoring judgment
Übersicht
Patch-Erstellung bedeutet nicht „das Rote wegmachen“. Es ist ein kleines Kompatibilitätsargument: Erhalte den aktuellen Gewinner, gib nur die Upstream-Werte weiter, die noch überleben sollen, und hinterlasse ein reversibles Patch-Plugin, dessen Inhalt aussagt, was du meinst. Sortierung ist ein Auswahlhebel; Patchen ist, wie du dafür sorgst, dass die beabsichtigten Werte zweier Mods gleichzeitig aktiv bleiben. Aber „im Prinzip wahr“ ist nicht „im Pack-Maßstab wahr“: Wenn der Plan ist, jede FormID zu patchen, weil „xEdit alles reparieren kann“, ist der Plan bereits gescheitert.
Verwende diesen Abschnitt, wenn du gerade dabei bist, einen Patch über das MCP zu erstellen oder zu beurteilen.
Verwende zuerst xedit-conflict-audit, wenn die Frage noch ist „Was gewinnt, was
konfliktiert, und sollte dies ein Patch vs. eine Neuanordnung sein?“. Dieser Skill besitzt die
Patch-vs.-Neuanordnung-Entscheidung; dieser Abschnitt besitzt, ob der Patch, den du gerade schreiben willst, wohlgeformt ist.
Entscheidungsfluss: Ist dieser Patch wohlgeformt?
digraph patch_authoring_judgment {
// Ausstehende Speicherungen blockieren Lebenszyklusoperationen; siehe „Dirty-state und
// Neustartsteuerung“ unten. Ein Neustart ist kein Haltbarkeitsmechanismus.
rankdir=TB;
node [shape=box];
start [shape=doublecircle, label="Patch nötig?"];
audit [label="Auditiere tatsächlichen Gewinner + Konfliktfelder\n(xedit-conflict-audit falls nicht bereits geschehen)"];
reorder [shape=diamond, label="Reicht eine Neuanordnung\nohne Verlust nötiger Werte?"];
no_patch [shape=doublecircle, label="Kein Patch: Neuanordnung / Gewinner belassen\ndann Rücklesen verifizieren"];
winner [label="Kopiere / ziele auf den aktuellen Gewinner\nnicht auf einen älteren Verlierer"];
intent [label="Benenne jeden weiterzugebenden Wert\nWas tut er? Warum sollte er überleben?"];
noise [shape=diamond, label="Unveränderte kopierte Werte\noder grüne/ITM-artige Störungen?"];
clean [label="Entferne unveränderte / absichtslose Werte"];
refs [shape=diamond, label="Löschen oder als gelöscht markieren\nvon Datensätzen/Elementen?"];
referenced [label="Führe referenced_by / Referenz-Audit durch\nStoppe, wenn die Konsequenzen unbekannt sind"];
esl [label="Wähle Patch-Form bewusst\nNormalerweise ESP-flagged ESL, wenn sicher; vermeide natives ESL/ESM, wenn Sortierfreiheit wichtig ist"];
reversible [shape=diamond, label="Separater reversibler Patch\n(keine direkte Quell-Mod-Bearbeitung, kein unverwalteter Overwrite-Spill)?"];
fix_shape [label="Verschiebe in verwaltetes MO2-Mod\noder erstelle dediziertes Patch-Plugin"];
verify [label="Speichern + Neustarten + Rücklesen\nGewinnender Override zeigt beabsichtigte Werte"];
pass [shape=doublecircle, label="Wohlgeformter Patch"];
start -> audit -> reorder;
reorder -> no_patch [label="ja"];
reorder -> winner [label="nein, benötige kombinierte Werte"];
winner -> intent -> noise;
noise -> clean [label="ja"];
noise -> refs [label="nein"];
clean -> refs;
refs -> referenced [label="ja"];
refs -> esl [label="nein"];
referenced -> esl;
esl -> reversible;
reversible -> fix_shape [label="nein"];
reversible -> verify [label="ja"];
fix_shape -> verify -> pass;
// Contract 0.23 ausstehende Speicherungen verwenden xedit_flush; Neustart allein ist kein Beweis.
verify [label="Speichern + ausstehenden Zustand inspizieren; xedit_flush falls nötig; frisches Rücklesen"];
}
Korrektur der verzögerten Speicherung: Der historische Knoten
Speichern + Neustarten + Rücklesenim Diagramm ist überholt. Wennsession.saveeine von Null verschiedenesavePendingShutdownCountmeldet, inspizierexedit_dirty, verwende dannxedit_flushauf einem Contract-0.23-Daemon. Das Tool validiert die Drain-Antwort und bestätigt den vom Daemon zugesagten Selbstausstieg. Einpartialoder unbekannterlastFlushist kein Haltbarkeitsnachweis. Normaler Stop/Neustart bleibt verweigert, solange eine lebende ausstehende Warteschlange existiert;force:truegibt den Zustand auf und ist niemals ein Beweis für Haltbarkeit.
Autorenprüfungen
- Gib den Gewinner weiter. Das Spiel liest den finalen/gewinnenden Override für eine FormID. Baue den Patch aus dem aktuellen Gewinner, dann gib nur die älteren Mod-Werte weiter, die noch überleben müssen.
- Keine unveränderte Fracht. Wenn ein kopierter Wert seine Bedeutung nicht ändert, ist es ITM-artige Störung, keine Kompatibilität. Entferne ihn, es sei denn, du kannst angeben, warum er absichtlich getragen wird.
- Patch als separate Schicht. Ziehe Werte nicht direkt in die Quell-Mod, nur weil sie heute die rechteste Spalte ist. Ein Patch sollte durch Deaktivieren/Entfernen der Patch-Schicht reversibel sein, nicht durch händisches Löschen von Feldern aus dem Plugin eines anderen.
- Referenzen erhalten. Wenn Löschen oder Markieren als gelöscht in den Plan kommt, stoppe und führe zuerst den Referenziert-von/Rücklese-Pfad aus. Unbekannte Referenzen bedeuten unbekannten Explosionsradius.
- Wähle Plugin-Form bewusst. Gewöhnliche Kompatibilitätspatches wollen normalerweise normale ESP-Sortierfreiheit plus ESL-Flagging, wenn sicher. Natives ESL/ESM-Ladereihenfolgeverhalten ist kein kostenloses Sauberkeits-Upgrade.
- Guter Patch vs. Pflaster-Patch. Ein guter Patch hat eine benannte Absicht pro weitergegebenem Wert und reduziert Konfliktschulden. Ein Pflaster-Patch kopiert ganze Datensätze, bearbeitet Quell-Mods oder versucht, jede FormID zu verarbeiten, weil Sortierung als irrelevant behandelt wurde.
KB-Abfragedisziplin
Dieser Beurteilungsabschnitt ist spielunabhängig. Frage die KB nach spielspezifischen Patch-Fallstricken, Datensatzfamilien-Besonderheiten und aktuellen Toolchain-Fakten, anstatt sie hier zu versteinern.
bgs_kb_query({ query: "xedit patch authoring gotchas", domains: ["xedit", "load-order"], games: ["<aktuelles spiel>"] })
Wenn die KB schweigt, markiere [LÜCKE] und behalte die Patch-Regel auf der Framework-Ebene,
anstatt eine spielspezifische Doktrin zu erfinden.
Rote Flaggen (STOP)
| Gedanke | Realität |
|---|---|
| „Es ist rot, also kopiere den linken Wert.“ | Rot ist eine Aufforderung zum Inspizieren. Es ist kein Urteil, dass der verlierende Wert überleben sollte. |
| „Die rechteste Mod ist falsch; ich bearbeite sie direkt.“ | Dann hast du die Quell-Mod zum Patch gemacht. Verwende einen separaten Override-Patch, damit die Umkehrung sauber ist. |
| „Sortierung spielt keine Rolle, weil xEdit alles patchen kann.“ | Im Prinzip ja; über Hunderttausende von FormIDs hinweg, nein. Verwende Sortierung, um Reparaturschulden zu reduzieren, dann patche den bedeutungsvollen Rest. |
| „Grüne/unveränderte kopierte Werte sind harmlos.“ | Sie sind absichtslose Fracht. Wenn sie die Bedeutung nicht ändern, entferne sie. |
| „Natives ESL ist sauberer als ESP-flagged ESL.“ | Natives ESL/ESM kann normale Sortierfreiheit kosten. Verwende ESP-flagged ESL, wenn das die sichere Patch-Form ist. |
| „Das sieht ungenutzt aus; lösche es.“ | Referenziert-von zuerst. Löschen ohne Referenzwissen ist unbekannter Explosionsradius. |
Rationalisierungen
| Ausrede | Realität |
|---|---|
| „Ich ziehe nur ein Feld in das gewinnende Plugin.“ | Ein Feld ist immer noch eine Quell-Mod-Bearbeitung. Mache eine Patch-Schicht, oder das zukünftige Du entfernst mühsam einzelne Felder. |
| „Der Patch sollte alles bewahren, was irgendeine Mod berührt hat.“ | Bewahre Absicht, nicht Geschichte. Einige Bearbeitungen sind zentral für die Mod; einige sind beiläufige Autorenpräferenz, die einer systemischen Regel weichen sollte. |
| „Ich weiß nicht, was dieses Feld tut, also kopiere ich die Version, die plausibel aussieht.“ | Unbekannte Feldbedeutung ist eine Forschungsaufgabe, kein Würfelwurf. Lies die Datensatzstruktur, CK/Wiki/Community-Beispiele und tatsächliches In-Pack-Verhalten. |
| „Overwrite ist in Ordnung; MO2 sieht es.“ | Overwrite ist Spill. Ein echter Patch gehört in eine verwaltete Mod-Schicht mit einem Namen, den das zukünftige Du verstehen kann. |
| „Die Antwort sagte ok; der Patch ist fertig.“ | Patch-Akzeptanz ist das Rücklesen des gewinnenden Overrides nach Speichern/Neustarten, mit den beabsichtigten Werten sichtbar und ohne unbeabsichtigte Fracht. |
R6-Progressive-Disclosure-Fähigkeitsprüfungen
Gehe nicht davon aus, dass jeder Daemon r6 ist. Lese xedit_list_capabilities einmal und verzweige
auf die folgenden Unterstützungsschlüssel. Bei Pre-r6-Daemonen falle auf die älteren expliziten
Record-Liste/Child-Walk/Pro-Record-Schleifenmuster zurück; bei r6+-Daemonen verwende die
Ein-Aufruf- oder seitenbewusste Form, um Roundtrips zu reduzieren und Kontext zu erhalten.
| Fähigkeitsschlüssel | Contract | Bevorzuge dieses Muster | KB-Eintrag |
|---|---|---|---|
supports.childGroupNavigation | 0.13 | Navigiere CELL/WRLD/DIAL/QUST ChildGroups durch elements.children-Stubs | xedit.childgroup-navigation.v1 |
supports.createParentSpec | 0.16 / 0.18 | Erstelle Datensätze direkt unter Parent-ChildGroups mit records.create parent | xedit.records-create-parent-spec.v1 |
supports.elementsChildrenPagination | 0.17 | Paginiere elements.children mit limit / offset | xedit.elements-children-pagination.v1 |
supports.reverseNavigation | 0.19 | Füge includeParents:true hinzu und lese relations.parents | xedit.reverse-navigation.v1 |
Für das gesamte r6-Contract-Delta frage den KB-Eintrag xedit.r6-contract-summary.v1 ab.
ChildGroup-Navigation (supports.childGroupNavigation)
Bei r6+-Daemonen gibt elements.children auf CELL-, WRLD-, DIAL- und QUST-Datensätzen
einen virtuellen Child-Eintrag mit kind: "child_group" zurück. Behandle diesen Eintrag als
schreibgeschützten Navigations-Stub, nicht als echtes veränderbares Element.
Verwende es eine Generation nach der anderen:
elements.children({ file, formId, path: "\Child Group" })
elements.children({ file, formId, path: "\Child Group\Persistent" })
elements.children({ file, formId, path: "\Child Group\Temporary" })
elements.children({ file, formId, path: "\Child Group\Visible when Distant" })
elements.children({ file, formId, path: "\Child Group\Block X, Y" })
elements.children({ file, formId, path: "\Child Group\Block X, Y\Sub-Block M, N" })
- Gehe genau die nächste Ebene; bitte nicht um den gesamten Baum, wenn eine Seite oder eine ChildGroup-Bezeichnung ausreicht.
- Die
\Child Group...-Pfade sind synthetisch und SCHREIBGESCHÜTZT. Mutationsverben müssen flache FormID-Locators ({ file, formId }) oder einerecords.create.parent-Spezifikation verwenden; übergib keine synthetischen Locator-Pfade an Mutatoren. - Für WRLD-Zellen verwende
Persistentoder die Block/Sub-Block/Koordinaten-Route, je nach Ziel-Child-Group. - Tiefgehende Referenz:
xedit.childgroup-navigation.v1.
elements.children-Paginierung (supports.elementsChildrenPagination)
Bei r6+-Daemonen akzeptiert elements.children limit und offset:
elements.children({ file, formId, path, limit: 200, offset: 0 })
limitist auf 1-1000 begrenzt und standardmäßig 200.- Antworten enthalten
count,total,offsetundtruncated. - Wenn
truncatedwahr ist, behalte dasselbelimit, addierecountzuoffset, und rufe die nächste Seite ab, bis alles abgedeckt ist. - Gehe nicht davon aus, dass CELL-Child-Groups klein sind: FO4 Vanilla CELL
00000025Temporaryenthält 742 Datensätze. - Tiefgehende Referenz:
xedit.elements-children-pagination.v1.
Rückwärtsnavigation (supports.reverseNavigation)
Bei r6+-Daemonen füge includeParents: true hinzu, wenn du Eigentum oder
Enthaltensein wissen musst, ohne ein zweites Verb. Unterstützte Leseaufrufe umfassen:
records.getrecords.find_by_form_id/records.find_by_editor_idund MCP-Wrapper wiexedit_find_recordrecords.master_or_selfrecords.winning_overrideelements.getelements.children
Die Antwort kann enthalten:
relations.parents: [{ locator, object }, ...]
Eltern sind zuerst die nächsten mit einer Daemon-Tiefenbegrenzung von 16. Dies ist die bevorzugte
Antwort auf „Welche CELL besitzt diese REFR?“ oder „Welche QUST/DIAL-Gruppe enthält dieses
Kind?“. Verwende die Elternkette als Rücklese-Beweis; baue keine benutzerdefinierte
Reverse-Index-Schleife, es sei denn, der Unterstützungsschlüssel fehlt. Tiefgehende Referenz:
xedit.reverse-navigation.v1.
records.create-Parent-Spezifikation (supports.createParentSpec)
Mutierende Datensatzerstellung in ChildGroups ist r6-begrenzt und erfordert weiterhin den
normalen MCP-Mutationszustimmungspfad. Wenn unterstützt, verfasse das Ziel-Elternteil
explizit, anstatt zu versuchen, synthetische \Child Group
…
[für die Übersetzung gekürzt]