Agent Skills
返回列表
TuGraph Cypher 生成

TuGraph Cypher 生成

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8e432120/sy-tugraph-cypher。

技能介绍

你在写什么查询

很多团队把 OpenCypher 教程或 ChatGPT 生成的语句直接丢进 TuGraph,结果在 CREATE、 RETURN 或 WHERE 里报错。根因往往不是「不会写图查询」,而是 TuGraph 与标准 OpenCypher 在 Schema、Label 和 语法子集 上并不一致:节点/边必须 恰好一个 Label、必须先建 Schema 才能用,且 不能 创建无 Label 节点。

技能如何帮你对齐 TuGraph

本技能把 TuGraph 当作独立方言来约束生成结果,而不是泛泛的「图数据库 Cypher」。它会强调三条架构差异(单 Label、强 Schema、禁止无 Label 节点),并给出 不支持特性速查表,例如:

  • RETURN * 不能一次返回全部变量
  • WHERE 里不能写 (a)-[]->(b) 这类路径过滤
  • 不支持 node["prop"] 动态属性、CREATE p = (a)-[:R]->(b) 整路径创建
  • CALL proc($param) 过程参数、SKIP rand() 等非常量 SKIP/LIMIT
  • 反引号变量名、 all()/any() 等谓词、以及去重版 UNION(仅 UNION ALL)

需要细节时,技能会指向 references/quick-reference.md(算子、子句、函数示例)与 references/procedures.md(内置过程签名),避免你在文档外猜语法。

适用边界

内容基于 TuGraph DB 4.5.1;新版本可能增删特性,上线前仍建议对照官方 Release 说明。本技能侧重 可执行的 Cypher 与方言差异,不替代 TuGraph 集群运维、权限或性能调优。

使用场景

  • 从 Neo4j 或通用 OpenCypher 示例迁移到 TuGraph 时,改写 `CREATE`/`MATCH` 以符合单 Label 与先建 Schema 的约束
  • 在 TuGraph 4.5.1 上调试报错语句,对照不支持列表排查 `RETURN *`、`WHERE` 路径模式或 `UNION` 等非 `UNION ALL` 写法
  • 为新业务建模后编写首批图查询,避免生成无 Label 节点或动态属性 `node["prop"]` 等会直接失败的语法
  • 需要调用内置过程时,按 `references/procedures.md` 核对过程名与参数签名,避免 `CALL proc($param)` 这类不支持形式

适合人员

  • 负责 TuGraph 接入的后端工程师,要把业务 API 里的图查询写成可执行且符合方言的子集
  • 维护 TuGraph 实例的 DBA,需要在建表/建 Label 之后帮业务方审查 Cypher 是否触犯强 Schema 与单 Label 规则
  • 从 Neo4j 迁到 TuGraph 的数据平台同学,要批量改掉 `RETURN *`、谓词函数和整路径 `CREATE` 等不兼容写法
  • 写图分析脚本的数据工程师,要在 Agent 辅助下快速查算子、子句与过程文档而不是背完整手册