메뉴
node-graph(ノードエディタ)関連のシステム開発、不具合修正、機能追加を行う際の必須リファレンス。nodeEditor/ディレクトリ配下のコードを変更・追加・デバッグする場合、ノードやエッジの新規タイプ追加、レシピエッジの修正、保存/読み込み処理の変更、PropertiesPanel関連の修正、コンテキストメニューやツールバーの変更時に使用する。「ノードグラフ」「ノードエディタ」「nodeEditor」「エッジ」「レシピエッジ」「ノード追加」に関連するタスクで自動トリガーする。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
node-graph(ノードエディタ)関連のシステム開発、不具合修正、機能追加を行う際の必須リファレンス。nodeEditor/ディレクトリ配下のコードを変更・追加・デバッグする場合、ノードやエッジの新規タイプ追加、レシピエッジの修正、保存/読み込み処理の変更、PropertiesPanel関連の修正、コンテキストメニューやツールバーの変更時に使用する。「ノードグラフ」「ノードエディタ」「nodeEditor」「エッジ」「レシピエッジ」「ノード追加」に関連するタスクで自動トリガーする。
mooreseditor（Tauri アプリ）の外部プラグインを作成・ビルド・デプロイ・デバッグする。Use When — 「プラグインを作りたい」「プラグインのビルド方法」「node-graph のような新しいタブを追加」「plugin.json」「PluginManifest」「HostAPI」「プラグインがロードされない」「does not provide an export named エラー」と言われた場合。npm SDK、external starter、共有依存、HostAPI 契約、Tauri FS スコープのトラブルシュートを扱う。
Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.
会話中に行った作業を再利用可能なスキル（SKILL.md）に変換する。引数不要で起動し、会話履歴から手順・判断・スクリプトを抽出して、暗黙知を徹底的に言語化した高品質なスキルを生成する。Use When: 「スキル化して」「この作業をスキルにして」「/create-skill」で起動。作業完了後に「これスキルにしたい」と言われた場合にも使用。
| name | node-graph-reference |
| description | node-graph(ノードエディタ)関連のシステム開発、不具合修正、機能追加を行う際の必須リファレンス。nodeEditor/ディレクトリ配下のコードを変更・追加・デバッグする場合、ノードやエッジの新規タイプ追加、レシピエッジの修正、保存/読み込み処理の変更、PropertiesPanel関連の修正、コンテキストメニューやツールバーの変更時に使用する。「ノードグラフ」「ノードエディタ」「nodeEditor」「エッジ」「レシピエッジ」「ノード追加」に関連するタスクで自動トリガーする。 |
このシステムには3つの独立したデータソースがある:
NodeEditorContextのuseReducer） — キャンバス上のノード位置・エッジ接続のランタイム表現jsonData: Column[]） — items.json, blocks.json等。App.tsxが所有。ノードエディタはprops経由で参照・変更核心原則: 保存時に全て再構築する。 research依存関係、clearedActions、spatialUnlockの結果は全てexportToMaster()内で毎回ゼロから計算される。中間状態をキャッシュしない。これにより、保存すれば必ず整合性のとれたデータが得られる。
ノードの表示名(displayName)やエッジのレシピラベルはnodeGraph.v1.jsonに保存しない。毎レンダリングでresolveDisplayNames()とresolveEdgeRecipeLabels()がjsonDataから解決する。マスタデータ側で名前が変わっても、グラフは常に最新の名前を表示する。
最重要ルール。 スキーマのフィールド名（itemName, blockGuid等）を直接参照してはならない。全てSchemaMetaを介して動的に解決する。
// NG: フィールド名をハードコード
const name = record.itemName;
// OK: SchemaMetaから動的に解決
const name = meta.nameField ? record[meta.nameField] : null;
既知の違反箇所: spatialUnlock.tsのgetItemGuidForNodeがrecord?.itemGuidをハードコードしている。新しいコードでこのパターンを踏襲しない。
レシピレコード（craftRecipes, machineRecipes）のライフサイクルはエッジが管理する。エッジ作成時にレシピを生成、エッジ削除時に他のエッジから参照されていなければレシピも削除（recipeCleanup.ts）。
React FlowのdeleteKeyCode="Delete"とカスタムuseDeleteHandlerが両方同じキー押下を処理する。React FlowはonEdgesChange(remove)を発火し、useDeleteHandlerはdeleteSelected()を呼ぶ。レシピクリーンアップも二箇所で走る。setJsonDataのfunctional updaterにより実害はないが、この二重構造を理解せずに片方だけ変更すると不整合が生じる。
handleEdgeEditConfirmはエッジのrecipeRefsを新しい参照で置換するが、古いレシピレコードのクリーンアップは行わない。エッジ削除時のみクリーンアップが走る。エッジ編集で参照を差し替えると、旧レシピがマスタデータに残る可能性がある。
patchResearchColumnはif (dependencies)で分岐しており、researchノードから全dependencyエッジを削除するとdependencyMap.get(guid)がundefinedになり、古いprevResearchNodeGuidsがクリアされない。
onNodesChangeはノードの選択やドラッグでもonMarkDirty()を呼ぶ。つまりノードをクリックしただけでApp側が「未保存変更あり」と認識する。レイアウト変更とデータ変更を区別していない。
exportToMaster()内の処理順序は重要:
validateGraph() — 孤立エッジ除去。必ず最初。 これがないと存在しないノードへのエッジが依存関係マップに入るcalculateUnlockedItems() — 空間位置からresearch→item割当buildResearchDependencyMap() — cleanedEdgesから依存関係構築patchResearchColumn() — research masterデータ書き込みbuildNodeGraphFile() — グラフファイルシリアライズvalidateGraphを後に回すと、孤立エッジが依存関係データを汚染する。
useNodeExportでsetJsonData(updatedColumns)がawait onRequestSave()の前に呼ばれる。保存が失敗してもReact状態は既に更新済みで、ディスクのデータとReact状態が乖離する。
guidFieldはtype: "uuid" && autoGenerated: trueのフィールドのみ検出。手動入力UUIDスキーマではnullになり、レコード検索が全て失敗するnameFieldは"name"を含むstringフィールドを優先、なければ最初のstringフィールド。"title"等は検出されない場合があるgetItemGuidForNodeがrecord?.itemGuidをハードコードしている（前述の違反）nodeTypesとedgeTypesはNodeCanvas.tsxでモジュールスコープ定数として定義。インラインで定義すると無限レンダリングになる。新しいノード/エッジタイプ追加時もこのパターンに従うdefaultViewportは初回マウント時のみ適用。コンポーネントがマウント済みの状態でLOAD_GRAPHしても、React Flowのビューポートは更新されないDate.now()を使用。同一ミリ秒で2つのエッジ作成するとID衝突する（ノードはカウンター付きで安全）resolveDisplayNamesはuseMemo([state.nodes, ...])で呼ばれるが、ノードドラッグでstate.nodesの参照が変わるため、ドラッグ中に毎フレーム全ノードの名前解決が走る。内部はO(N*M)のlinear scan