xEdit 自動化 — ハブスキル
このスキルは、すべての xEdit 作業における常時読み込まれるエントリポイントです。「どのパスを使用するか」「絶対にやってはいけないこと」の単一情報源です。特化型タスクスキル(例:xedit-conflict-audit)は、そのルーティング、アンチパターン、検証規律を継承します。それらを再定義することはありません。
ツールボックス概要(プログレッシブディスクロージャー、r6 対応)
フォーク版 xEdit デーモンは、プログレッシブディスクロージャーサーフェスとして扱うのが最適です。
小さな MCP インテントツールから始め、ライブデーモンにどの r6 機能
ブロックをサポートしているか問い合わせ、対応する system.capabilities.supports.* キーが存在する場合にのみ、よりリッチなワンコールパターンに切り替えます。
- 発見とセッション —
xedit_session、xedit_list_capabilities。会話のたびに最初にxedit_sessionを呼び出します。その後、xedit_list_capabilitiesを一度呼び出して、コマンド一覧、contractVersionExpected、r6 のsupports.*アンカーを確認します。 - レコードと競合の読み取り —
xedit_find_record、xedit_read_record、xedit_inspect_conflicts。これらが W2(競合監査)のバックボーンです。W2 に、どのインテントツールでもまだ公開されていない r6 応答ブロックが必要な場合は、アトミックパススルーに分岐します。 - アトミックパススルー —
xedit_call(command、args)。まだインテントツールがないネイティブデーモンコマンド用。完全なパイプライン(検証→状態→ルール→監査)を実行します。インテントツールが適合しない場合は常に使用します。
詳細なリファレンス資料については、最初に構造化 BGS KB を照会します(bgs_kb_query / bgs_kb_get)。詳細リファレンスレコードは knowledge/bgs-kb/packs/core/records/xedit/ にあります(bgs_kb_query / bgs_kb_get で照会可能)。
ルーティングドクトリン(使用するパス)
| タスクの形状 | パス |
|---|---|
| 高頻度の既知インテント(競合の監査、レコードの読み取り、ジョブの実行、パッチの作成) | MCP インテントツール |
| 新規 / デバッグ / ネイティブコマンドの自由な構成 | MCP アトミックパススルー: xedit_call(command、args) — ハーネス内 |
| 探索的なアトミックオペレーションストーム(試行錯誤、繰り返しの読み取り評価、仮説検証) | 読み取り専用調査サブエージェントに委任(このスキルをロード)。サブエージェントは自身のコンテキストを使い、要約を返します |
| 大規模な形式化可能な一括変更 | MCP xedit_run_script(バッチ 4+)ドライラン + スナップショット付き |
| デーモンが明示的にデフォルト(非 MCP)モード、手動デバッグのみ | xedit-client.ps1 の直接使用は許容 — ただし、ユーザーが明示的にリスクを受け入れ、デーモンが -automation-mcp-mode でない場合に限る |
エージェントが MCP をバイパスする理由があってはなりません。 そのためにアトミックパススルーが存在します。
パッチ作成判断
概要
パッチ作成は「赤を消す」ことではありません。それは小さな互換性の 議論です。現在の勝者を保持し、生き残るべき上流の値のみを転送し、 意図が明確な可逆的なパッチプラグインを残します。並べ替えは単一選択の レバーです。パッチングは、2 つの Mod の意図された値を同時にアクティブに 保つ方法です。しかし、原理的に正しいこととパックスケールで正しいことは 異なります。「xEdit は何でも修正できる」からすべての FormID を ステッチする計画なら、その計画はすでに破綻しています。
このセクションは、MCP を通じてパッチを作成または判断しようとしている
ときに使用します。「何が勝ち、何が競合し、これをパッチ vs 並べ替えにする
べきか」という疑問がある場合は、最初に xedit-conflict-audit を使用して
ください。そのスキルがパッチ vs 並べ替えの判断を担当します。このセクションは、
作成しようとしているパッチが適切に形成されているかどうかを判断します。
判断フロー:このパッチは適切に形成されていますか?
digraph patch_authoring_judgment {
// 保留中のシャットダウンセーブはライフサイクル操作をブロックします。
// 以下「ダーティ状態と再起動制御」を参照。再起動は永続性の仕組みではありません。
rankdir=TB;
node [shape=box];
start [shape=doublecircle、label="パッチが必要ですか?"];
audit [label="実際の勝者と競合フィールドを監査
(xedit-conflict-audit がまだの場合)"];
reorder [shape=diamond、label="必要な値を失うことなく
並べ替えで十分ですか?"];
no_patch [shape=doublecircle、label="パッチ不要:並べ替え / 勝者を残す
その後読み取りを確認"];
winner [label="現在の勝者をコピー/ターゲットにする
古い敗者ではない"];
intent [label="転送する各値に名前を付ける
それは何をするのか?なぜ生き残るべきか?"];
noise [shape=diamond、label="変更されていないコピーされた値
または緑色/ITM スタイルのノイズはありますか?"];
clean [label="変更なし/意図なしの値を削除"];
refs [shape=diamond、label="レコード/要素を
削除または削除マークしていますか?"];
referenced [label="referenced_by / 参照監査を実行
結果が不明な場合は停止"];
esl [label="パッチフォームを意図的に選択
通常は安全な場合に ESP フラグ ESL。ソートの自由度が重要な場合はネイティブ ESL/ESM を避ける"];
reversible [shape=diamond、label="分離可能な可逆パッチ
(直接のソース Mod 編集なし、管理されていない上書き流出なし)ですか?"];
fix_shape [label="管理された MO2 Mod に移動
または専用のパッチプラグインを作成"];
verify [label="保存 + 再起動 + 読み取り
勝者のオーバーライドが意図した値を示す"];
pass [shape=doublecircle、label="適切なパッチ"];
start -> audit -> reorder;
reorder -> no_patch [label="はい"];
reorder -> winner [label="いいえ、結合された値が必要"];
winner -> intent -> noise;
noise -> clean [label="はい"];
noise -> refs [label="いいえ"];
clean -> refs;
refs -> referenced [label="はい"];
refs -> esl [label="いいえ"];
referenced -> esl;
esl -> reversible;
reversible -> fix_shape [label="いいえ"];
reversible -> verify [label="はい"];
fix_shape -> verify -> pass;
// コントラクト 0.23 の保留セーブは xedit_flush を使用。再起動だけでは証明になりません。
verify [label="保存 + 保留状態を検査。必要に応じて xedit_flush。新しい読み取り"];
}
遅延セーブの修正: 図の歴史的な
保存 + 再起動 + 読み取りノードは 置き換えられています。session.saveがゼロ以外のsavePendingShutdownCountを 報告する場合、xedit_dirtyを検査し、コントラクト 0.23 デーモンでxedit_flushを 使用します。ツールはドレイン応答を検証し、デーモンが約束した自己終了を確認します。partialまたは未知のlastFlushは永続性の証明にはなりません。 ライブの保留キューが存在する間は、通常の停止/再起動は拒否されたままです。force:trueは状態を放棄し、永続性の証拠にはなりません。
作成チェック
- 勝者を転送する。 ゲームは FormID の最終/勝利オーバーライドを読み取ります。 現在の勝者からパッチを構築し、その後、生き残る必要がある古い Mod の値のみを転送します。
- 変更されていないカーゴは不要。 コピーされた値が意味を変えない場合、それは ITM スタイルのノイズであり、互換性ではありません。意図的に保持する理由を説明できない限り、削除します。
- パッチを別のレイヤーとして。 今日の右端の列だからといって、値をソース Mod に 直接ドラッグしないでください。パッチは、パッチレイヤーを無効化/削除することで 元に戻せるようにする必要があります。他の誰かのプラグインからフィールドを手動で削除するのではありません。
- 参照を保持する。 削除またはマーク削除が計画に入ったら、停止して 最初に参照/読み取りパスを実行します。未知の参照は未知の爆発半径を意味します。
- プラグインフォームを意図的に選択する。 通常の互換性パッチは通常、 安全な場合に ESL フラグを付けた通常の ESP ソート自由度を必要とします。 ネイティブ ESL/ESM のロード順序動作は、無料のクリーンアップアップグレードではありません。
- 良いパッチ vs 応急処置パッチ。 良いパッチは、転送された値ごとに名前付きの意図があり、 競合債務を削減します。応急処置パッチは、レコード全体をコピーし、ソース Mod を編集し、 並べ替えを無関係として扱うため、すべての FormID をステッチしようとします。
KB クエリ規律
この判断セクションはゲームに依存しません。ゲーム固有のパッチングの落とし穴、 レコードファミリーの注意点、現在のツールチェーンの事実については、ここに 固定化するのではなく KB にクエリを実行します。
bgs_kb_query({ query: "xedit パッチ作成の落とし穴", domains: ["xedit"、"load-order"], games: ["<現在のゲーム>"] })
KB が沈黙している場合は [GAP] をマークし、ゲーム固有のドクトリンを
発明する代わりに、パッチングルールをフレームワークレベルに保ちます。
レッドフラグ(STOP)
| 思考 | 現実 |
|---|---|
| 「赤いから、左の値をコピーする。」 | 赤は調査を促すものです。敗者の値が生き残るべきだという判断ではありません。 |
| 「右端の Mod が間違っている。直接編集しよう。」 | そうすると、ソース Mod をパッチにしたことになります。元に戻せるように別のオーバーライドパッチを使用してください。 |
| 「xEdit は何でもパッチできるので、並べ替えは重要ではない。」 | 原理的にはその通りです。しかし、数十万の FormID にわたってはそうではありません。並べ替えを使用して修復債務を削減し、意味のある残りをパッチします。 |
| 「緑色/変更されていないコピーされた値は無害である。」 | それらは意図のないカーゴです。意味を変えないなら、削除してください。 |
| 「ネイティブ ESL は ESP フラグ ESL よりクリーンである。」 | ネイティブ ESL/ESM は通常のソート自由度を犠牲にする可能性があります。それが安全なパッチ形状である場合は、ESP フラグ ESL を使用してください。 |
| 「これは使われていないように見える。削除しよう。」 | 最初に参照元を確認してください。参照知識なしの削除は未知の爆発半径です。 |
正当化
| 言い訳 | 現実 |
|---|---|
| 「1 つのフィールドだけを勝ちプラグインにドラッグするだけだ。」 | 1 つのフィールドでもソース Mod の編集です。パッチレイヤーを作成するか、将来の自分が手動でフィールドを 1 つずつ削除することになります。 |
| 「パッチはすべての Mod が触れたものを保持するべきだ。」 | 意図を保持し、履歴を保持しないでください。一部の編集は Mod にとって重要ですが、一部はシステムルールに負けるべき偶然の作成者の好みです。 |
| 「このフィールドが何をするのかわからないので、もっともらしいバージョンをコピーする。」 | 未知のフィールドの意味は研究タスクであり、サイコロを振ることではありません。レコード構造、CK/ウィキ/コミュニティの例、実際のパック内の動作を読んでください。 |
| 「上書きで問題ない。MO2 が認識するから。」 | 上書きは流出です。本当のパッチは、将来の自分が理解できる名前の管理された Mod レイヤーに属します。 |
| 「応答が OK と言った。パッチは完了した。」 | パッチの受け入れは、保存/再起動後の勝者オーバーライドの読み取りであり、意図した値が表示され、意図しないカーゴがないことを確認します。 |
R6 プログレッシブディスクロージャー機能チェック
すべてのデーモンが r6 であると想定しないでください。xedit_list_capabilities を一度読み取り、
以下のサポートキーに基づいて分岐します。pre-r6 デーモンでは、
古い明示的なレコードリスト / 子ウォーク / レコードごとのループパターンにフォールバックします。
r6+ デーモンでは、ワンコールまたはページ対応フォームを使用して、
ラウンドトリップを減らし、コンテキストを保持します。
| 機能キー | コントラクト | 優先するパターン | KB レコード |
|---|---|---|---|
supports.childGroupNavigation | 0.13 | elements.children スタブを介して CELL/WRLD/DIAL/QUST ChildGroup をナビゲート | xedit.childgroup-navigation.v1 |
supports.createParentSpec | 0.16 / 0.18 | records.create parent を使用して、親 ChildGroups の下に直接レコードを作成 | xedit.records-create-parent-spec.v1 |
supports.elementsChildrenPagination | 0.17 | limit / offset で elements.children をページング | xedit.elements-children-pagination.v1 |
supports.reverseNavigation | 0.19 | includeParents:true を追加し、relations.parents を読み取り | xedit.reverse-navigation.v1 |
r6 コントラクトデルタ全体については、KB レコード xedit.r6-contract-summary.v1 を照会します。
ChildGroup ナビゲーション(supports.childGroupNavigation)
r6+ デーモンでは、CELL、WRLD、DIAL、QUST レコードの elements.children は、
kind: "child_group" の仮想子エントリを返します。そのエントリを
読み取り専用ナビゲーションスタブとして扱い、実際の可変要素としては扱わないでください。
一度に 1 世代ずつ使用します。
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" })
- 正確に次のレベルをウォークします。ページまたは 1 つの ChildGroup ラベルで十分な場合に、 ツリー全体を要求しないでください。
\Child Group...パスは合成されたものであり、読み取り専用 です。 変更動詞は、フラットな FormID ロケーター({ file、formId })またはrecords.create.parentスペックを使用する必要があります。合成ロケーターパスを 変更関数に渡さないでください。- WRLD セルの場合は、ターゲットの子グループに応じて、
Persistentまたは Block/Sub-Block/座標ルートを使用します。 - 詳細なリファレンス:
xedit.childgroup-navigation.v1。
elements.children ページング(supports.elementsChildrenPagination)
r6+ デーモンでは、elements.children は limit と offset を受け入れます。
elements.children({ file、formId、path、limit: 200、offset: 0 })
limitは 1~1000 にクランプされ、デフォルトは 200 です。- 応答には
count、total、offset、truncatedが含まれます。 truncatedが true の場合、同じlimitを維持し、countをoffsetに加算して、 カバーされるまで次のページを取得します。- CELL 子グループが小さいと想定しないでください。FO4 バニラ CELL
00000025Temporaryには 742 のレコードが含まれています。 - 詳細なリファレンス:
xedit.elements-children-pagination.v1。
逆方向ナビゲーション(supports.reverseNavigation)
r6+ デーモンでは、2 番目の動詞なしで所有権または包含関係を知る必要がある場合に、
includeParents: true を追加します。サポートされている読み取り呼び出しは次のとおりです。
records.getrecords.find_by_form_id/records.find_by_editor_idおよび MCP ラッパー(xedit_find_recordなど)records.master_or_selfrecords.winning_overrideelements.getelements.children
応答には次のものが含まれる場合があります。
relations.parents: [{ locator、object }、...]
親は最も近いものが最初で、デーモンの深さ上限は 16 です。これは、
「この REFR を所有する CELL はどれか?」または「この QUST/DIAL グループを含む子はどれか?」
に対する推奨される回答です。読み取りの証拠として親チェーンを使用します。
サポートキーがない限り、カスタムの逆インデックスループを構築しないでください。
詳細なリファレンス: xedit.reverse-navigation.v1。
records.create ペアレントスペック(supports.createParentSpec)
ChildGroup への可変レコード作成は r6 でゲートされており、通常の MCP 変更同意パスが
必要です。サポートされている場合、合成された \Child Group パスを変更しようとする代わりに、
ターゲットの親を明示的に指定します。
…
[truncated for translation]