Neo4j 图数据库设计

要解决什么问题

在 Neo4j 里做知识图谱、推荐或反欺诈时，常见痛点不是「会不会写 Cypher」，而是模型一错后面全错：标签堆叠、无方向关系、把 JSON 塞进属性、遍历不设上限，都会在数据量上来后变成慢查询或难维护的图。

本技能面向「设计 Neo4j 图数据模型 / Schema」「节点·关系·属性怎么命名」「Cypher 与索引怎么选」这类意图，把官方惯例和工程约束收成可执行的检查清单，而不是泛泛介绍图数据库概念。

技能如何工作

触发后，Agent 按渐进式加载走设计路径：先做版本检查（对照 version-major.md 及不高于目标版本的 version-2025.md、version-5.0.md），再进入图模型与索引设计，必要时拉取 design-spec.md、usage-guide.md、best-practices.md、patterns.md。

命名与建模有明确表格约束：节点标签 PascalCase（如 User）、关系类型 UPPER_SNAKE_CASE（如 PLACED）、属性 camelCase；单标签优先，多标签只用于横切维度；关系必须有类型和方向，高基数多对多可考虑中间节点。

索引按场景选型：B-tree / 复合 / 全文 / Text（5.x+）/ Vector（语义与 RAG，需 VECTOR 类型与维度配置）/ Point 等，并强调关键属性上的唯一约束或索引。

硬规则包括：遍历深度必须带上限（如 [*1..N]，禁止 [*]）、Cypher 必须参数化（$param）、禁止用 JSON 字符串代替图结构、优先把业务关系建对再谈查询优化。

适用边界

• 内容以 Neo4j 官方文档与 Cypher 手册为据，不编造特性；具体 DDL 与业务模板在 patterns.md 等参考里按需展开。
• 若你的 Neo4j 版本较旧，向量索引、原生 VECTOR、Text 索引等能力可能不可用，Step 0 版本对比应优先处理废弃项与重大变更。
• 本技能侧重设计与规范，生产集群运维、迁移细节需结合 usage-guide.md 与现场环境自行验证。