knowledge-graph
[UDS] 透過知識圖追蹤規格、決策與程式碼之間的影響鏈；沒有引擎時以 Markdown 後備方案運作。 Use when: 想知道某份規格或決策會影響到什麼、找出哪些程式碼實作了某個產物、追蹤規格、ADR 與模組之間的相依關係。 Not for: 沒有規格或決策錨點的純文字搜尋——請用 Grep；撰寫規格本身——請用 /sdd。 Keywords: knowledge graph, impact chain, traceability, spec impact, decision graph, 知識圖, 影響鏈, 規格追蹤, 相依關係.
소스 정보
- 저장소
- AsiaOstrich/universal-dev-standards
- 최근 소스 활동
- 2026년 8월 20일 06:47
- 감지된 SKILL.md 언어
- 중국어
- 스타
- 75
- 포크
- 13
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
파일 탐색기
2 개 파일SKILL.md 표시 중
SKILL.md
소스 지침 · 읽기 전용 미리보기- name
- knowledge-graph
- source
- ../../../../skills/knowledge-graph/SKILL.md
- source_version
- 1.0.0
- translation_version
- 1.1.0
- last_synced
- 2026-08-17T00:00:00.000Z
- status
- current
- description
- [UDS] 透過知識圖追蹤規格、決策與程式碼之間的影響鏈；沒有引擎時以 Markdown 後備方案運作。 Use when: 想知道某份規格或決策會影響到什麼、找出哪些程式碼實作了某個產物、追蹤規格、ADR 與模組之間的相依關係。 Not for: 沒有規格或決策錨點的純文字搜尋——請用 Grep；撰寫規格本身——請用 /sdd。 Keywords: knowledge graph, impact chain, traceability, spec impact, decision graph, 知識圖, 影響鏈, 規格追蹤, 相依關係.
- allowed-tools
- Read, Glob, Grep, Bash(curl:*)
- scope
- partial
- argument-hint
- [artifact id, e.g. XSPEC-205 | 產物 id]
# 知識圖
> **語言**: [English](../../../../skills/knowledge-graph/SKILL.md) | 繁體中文
依據[知識圖記憶標準](../../../../core/knowledge-graph-memory.md)的關係 schema，回答橫跨規格、決策與程式碼的結構性問題——*「XSPEC-205 的完整影響鏈是什麼？」*。有無圖引擎皆可運作。
> **Implements**: XSPEC-237 Phase 5 — knowledge-graph skill（EngramGraph opt-in）
## 模式選擇
回答**前**先判斷使用哪種模式：
| 條件 | 模式 |
|------|------|
| 設定了 `ENGRAM_URL`，或本機圖引擎 `/health` 有回應 | 服務模式（引擎）|
| 否則 | 降級模式（Markdown）|
## 工作流程
1. **解析目標**——將參數正規化為標準 id（`XSPEC-205`、`DEC-062`、函式名）。
2. **選擇模式**——探測圖引擎（服務）否則後備（降級）。
3. **服務模式（AC-5b）**——送出單一多跳查詢，呈現回傳的鏈（含跨域連結 code → spec → decision）：
```bash
curl -s -X POST "$ENGRAM_URL/graph/impact-analysis" \
-H 'content-type: application/json' \
-d '{"nodeId":"XSPEC-205","maxHops":3}'
```
4. **降級模式（AC-5a）**——無引擎時，讀取目標文件，沿其 `impacts`/`impacted_by`/`supersedes`/`related` front-matter 與內文 `[[ref]]` 連結讀取被連結檔案，手動組出鏈（受讀取深度限制）。
5. **呈現鏈**——列出相連的 Spec 與 Decision、每跳的邊型別、以及（若有）各節點的 `confidence`，高者在前。
6. **說明使用的模式**——務必告知答案來自引擎或 Markdown 後備，以明確完整度。
## 關係 schema
見[知識圖記憶標準](../../../../core/knowledge-graph-memory.md)。front-matter 欄位：`related`、`impacts`、`impacted_by`、`supersedes`、`implements`。
## 下一步引導
- 降級模式若觸及讀取深度上限，告知使用者圖引擎（如 EngramGraph）可給出完整鏈，以及如何設定 `ENGRAM_URL`。
- 若參照的 id 找不到，標示為待修的懸空參照。
- 主動提議為遍歷過的文件補上缺漏的 `impacts`/`impacted_by` front-matter。
## 參考
- 標準：[core/knowledge-graph-memory.md](../../../../core/knowledge-graph-memory.md)
- 引擎（opt-in）：[EngramGraph](https://github.com/AsiaOstrich/EngramGraph) — `engramgraph`
- 詳細指南：[guide.md](guide.md)
GitHub에서 보기