知识图
语言: English | 简体中文
依据知识图记忆标准的关系 schema,回答横跨规格、决策与代码的结构性问题——「XSPEC-205 的完整影响链是什么?」。有无图引擎皆可运作。
Implements: XSPEC-237 Phase 5 — knowledge-graph skill(EngramGraph opt-in)
模式选择
回答前先判断使用哪种模式:
| 条件 | 模式 |
|---|---|
设定了 ENGRAM_URL,或本机图引擎 /health 有响应 |
服务模式(引擎) |
| 否则 | 降级模式(Markdown) |
工作流程
- 解析目标——将参数规范化为标准 id(
XSPEC-205、DEC-062、函数名)。 - 选择模式——探测图引擎(服务)否则后备(降级)。
- 服务模式(AC-5b)——发出单一多跳查询,呈现返回的链(含跨域链接 code → spec → decision):
curl -s -X POST "$ENGRAM_URL/graph/impact-analysis" \ -H 'content-type: application/json' \ -d '{"nodeId":"XSPEC-205","maxHops":3}' - 降级模式(AC-5a)——无引擎时,读取目标文件,沿其
impacts/impacted_by/supersedes/relatedfront-matter 与正文[[ref]]链接读取被链接文件,手动组出链(受读取深度限制)。 - 呈现链——列出相连的 Spec 与 Decision、每跳的边类型、以及(若有)各节点的
confidence,高者在前。 - 说明使用的模式——务必告知答案来自引擎或 Markdown 后备,以明确完整度。
关系 schema
见知识图记忆标准。front-matter 字段:related、impacts、impacted_by、supersedes、implements。边推导:Decision impacts Spec → IMPACTS;Decision supersedes Decision → SUPERSEDES。
下一步引导
- 降级模式若触及读取深度上限,告知用户图引擎(如 EngramGraph)可给出完整链,以及如何设定
ENGRAM_URL。 - 若引用的 id 找不到,标示为待修的悬空引用。
- 主动提议为遍历过的文件补上缺漏的
impacts/impacted_byfront-matter。
参考
- 标准:core/knowledge-graph-memory.md
- 引擎(opt-in):EngramGraph —
engramgraph - 详细指南:guide.md