知識圖
語言: 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。
下一步引導
- 降級模式若觸及讀取深度上限,告知使用者圖引擎(如 EngramGraph)可給出完整鏈,以及如何設定
ENGRAM_URL。 - 若參照的 id 找不到,標示為待修的懸空參照。
- 主動提議為遍歷過的文件補上缺漏的
impacts/impacted_byfront-matter。
參考
- 標準:core/knowledge-graph-memory.md
- 引擎(opt-in):EngramGraph —
engramgraph - 詳細指南:guide.md