菜单
node-graph(ノードエディタ)関連のシステム開発、不具合修正、機能追加を行う際の必須リファレンス。nodeEditor/ディレクトリ配下のコードを変更・追加・デバッグする場合、ノードやエッジの新規タイプ追加、レシピエッジの修正、保存/読み込み処理の変更、PropertiesPanel関連の修正、コンテキストメニューやツールバーの変更時に使用する。「ノードグラフ」「ノードエディタ」「nodeEditor」「エッジ」「レシピエッジ」「ノード追加」に関連するタスクで自動トリガーする。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| 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）。
キーボード削除（Delete/Backspace）はReact FlowのdeleteKeyCodeのみが処理し、レシピクリーンアップはuseGraphChangeHandlersのonEdgesChange(remove)で走る。useDeleteHandlerのhandleDeleteSelectedはツールバー/コンテキストメニュー専用（keydownリスナーは削除済み）。エッジ編集ダイアログ表示中はdeletionDisabledでdeleteKeyCodeが無効化される。削除経路を変更する場合はこの一本化を崩さないこと。
handleEdgeEditConfirmは全edgeTypeでエッジを更新し（recipe⇔dependency/visualの型変更可）、旧recipeRefsのうちどのエッジからも参照されなくなったレシピはcleanupOrphanedRecipesAfterEdgeUpdate（recipeCleanup.ts）で削除される。注意: このヘルパーは更新後エッジ自身（同一ID）を「使用中」集計に含める設計。removeRecipesFromJsonData（削除用、同一IDをスキップする）と混同して使うと、維持中のレシピまで削除するデータ破壊になる。
patchResearchColumnはprevResearchNodeGuidsをdependencyMap.get(guid) ?? []で常に上書きする（重複GUID・自己ループも除去済み）。ただしキャンバス上にノードが存在するレコードのみが再計算対象であり、ノードを削除したresearchレコードの旧依存は凍結されたまま残る（未解決・設計判断待ち。docs/node-graph-audit-handover-2026-07.md参照）。
選択のみの変更（type: 'select'）とマウント時のdimensions計測（resizing/setAttributesなし）はdirtyにしない。position/remove/add/ユーザーリサイズは従来どおりdirty。SET_NODES/SET_EDGESアクションはmarkDirty?: booleanを持つ。
exportToMaster()内の処理順序は重要:
validateGraph() — 孤立エッジ除去。必ず最初。 これがないと存在しないノードへのエッジが依存関係マップに入るcalculateUnlockedItems() — 空間位置からresearch→item割当buildResearchDependencyMap() — cleanedEdgesから依存関係構築patchResearchColumn() — research masterデータ書き込みbuildNodeGraphFile() — グラフファイルシリアライズvalidateGraphを後に回すと、孤立エッジが依存関係データを汚染する。
useNodeExportはonRequestSave()の成功後にsetJsonDataとdirtyクリアを行い、isSavingRefで多重保存を防ぐ。この順序を崩すと保存失敗時に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のビューポートは更新されない（未解決）generateEdgeId()（useNodeOperations.ts）で生成する（2026-07修正済み。Date.now()単独のID生成を新規コードで復活させないこと）validateAndMigrateがitem/block/researchノードのmasterGuidを検証し、不正ノードとそれに接続するエッジをロード時に除外する（2026-07追加）resolveDisplayNamesはuseMemo([state.nodes, ...])で呼ばれるが、ノードドラッグでstate.nodesの参照が変わるため、ドラッグ中に毎フレーム全ノードの名前解決が走る。内部はO(N*M)のlinear scanmooreseditor（Tauri アプリ）の外部プラグインを作成・ビルド・デプロイ・デバッグする。Use When — 「プラグインを作りたい」「プラグインのビルド方法」「node-graph のような新しいタブを追加」「plugin.json」「PluginManifest」「HostAPI」「プラグインがロードされない」「does not provide an export named エラー」と言われた場合。npm SDK、external starter、共有依存、HostAPI 契約、Tauri FS スコープのトラブルシュートを扱う。
node-graph(ノードエディタ)関連のシステム開発、不具合修正、機能追加を行う際の必須リファレンス。nodeEditor/ディレクトリ配下のコードを変更・追加・デバッグする場合、ノードやエッジの新規タイプ追加、レシピエッジの修正、保存/読み込み処理の変更、PropertiesPanel関連の修正、コンテキストメニューやツールバーの変更時に使用する。「ノードグラフ」「ノードエディタ」「nodeEditor」「エッジ」「レシピエッジ」「ノード追加」に関連するタスクで自動トリガーする。
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」で起動。作業完了後に「これスキルにしたい」と言われた場合にも使用。