name: neo4j-design description: 幫助Agent為專案進行Neo4j圖資料模型設計、Cypher查詢設計、圖索引設計，並提供場景化使用指南。當用戶需要設計圖資料庫Schema、最佳化圖查詢、規劃知識圖譜/推薦系統/反欺詐方案時觸發。 version: 1.0.0 metadata: clawdbot: emoji: "🕸️" requires: anyBins: ["cypher-shell"] os: ["linux", "darwin"]

Neo4j 圖資料庫設計與使用助手

觸發條件

當用戶出現以下意圖時啟用本 Skill： - 設計 Neo4j 圖資料模型 / 圖譜 Schema - 節點 / 關係 / 屬性設計 - Cypher 查詢最佳化 - 圖索引設計（B-tree/Text/Vector/Full-text） - 知識圖譜 / 推薦系統 / 反欺詐方案 - "如何設計 xxx 的圖譜"

設計流程（Agent 執行路徑）

0. 版本檢查 → 載入 references/version-major.md 對比使用者版本，識別廢棄項和重大變更。同時載入所有 version-X.Y.md（X.Y ≤ 使用者目標版本），後續設計過程中 Agent 從已載入的上下文中自主匹配深度特性
1. 需求分析 → 理解業務實體、關係型別、查詢模式（遍歷深度/過濾條件/聚合）
2. 圖模型設計 → 節點標籤設計、關係型別設計、屬性設計、反規範化策略
3. 索引設計 → 屬性索引（B-tree/Text/Vector）、全文索引、約束設計
4. 查詢設計 → Cypher 查詢模式、路徑遍歷、聚合、子查詢
5. 效能最佳化 → 索引提示、引數化查詢、避免笛卡爾積、LIMIT 提前
6. 使用指引 → 載入 references/usage-guide.md，給出場景化操作
7. 生產建議 → 載入 references/best-practices.md，給出叢集/高可用/監控建議
8. 模板參考 → 載入 references/patterns.md，匹配業務圖模型模板

快速參考

節點與關係命名鐵律

節點標籤設計原則

關係設計原則

屬性型別速查

小蔥技能站7w4.net發現了升級外掛。

索引型別速查

漸進式載入

詳細內容按需載入 references/：

版本參考文件啟用規則

1. 模組啟用時 — 始終載入 references/version-major.md，Agent 需主動對比使用者使用的 Neo4j 版本（注意 CalVer 2025.01+ 和語義版本 5.x 的差異），若存在廢棄項或重大變更，立即提示使用者
2. 深度特性 Step 0 自動載入 — 版本檢查時載入所有 version-X.Y.md（X.Y ≤ 使用者目標版本）。設計過程中 Agent 從已載入的上下文中自主檢索匹配相關特性，使用者無需指定版本號
3. 深度特性按大版本拆分，小版本持續追加 — CalVer 按年份拆分（version-2025.md），5.x 按大版本拆分（version-5.0.md）。更新時在檔案中新增 ## X.Y.Z 版本節即可，不單開檔案

硬規則

1. 設計規範內容來自權威資料（Neo4j 官方文件/Cypher 手冊/圖資料庫最佳實踐），不編造
2. 所有節點必須有關鍵屬性上的唯一約束或索引
3. 關係必須有型別且有方向，不可使用無型別關係
4. 遍歷深度必須有上限（[*1..N]），禁止 [*] 無限深度
5. 查詢必須引數化（$param），禁止字串拼接 Cypher
6. 屬性值禁止儲存 JSON 字串（應建模為節點和關係）
7. 圖模型設計優先於查詢最佳化：先建模業務真實關係，再考慮查詢效能最佳化

整體質量較好，內容專業且覆蓋面廣，版本歷史記錄詳盡，命名規範和硬規則設計合理。優點是結構清晰、參考文件按需載入、包含6類業務模板；不足是缺少實際使用示例和常見問題解答，部分高階功能依賴新版 Neo4j，可能不適用於所有使用者環境。對於需要 Neo4j 圖資料庫設計的使用者來說，是一個可靠的專業工具。