knowledge-graph
[UDS] Trace impact chains across specs, decisions, and code via a knowledge graph, with a Markdown fallback when no engine is present. Use when: asking what a spec or decision affects, finding which code implements an artifact, tracing dependencies between specs, ADRs, and modules. Not for: plain text search with no spec or decision anchor — use Grep; authoring the spec itself — use /sdd. Keywords: knowledge graph, impact chain, traceability, spec impact, decision graph, 知識圖, 影響鏈, 規格追蹤.
ソース情報
- リポジトリ
- AsiaOstrich/universal-dev-standards
- ソースの最終更新活動
- 2026年8月17日 06:20
- 検出された SKILL.md の言語
- 英語
- スター
- 80
- フォーク
- 14
インストール方法
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
ソースファイルを確認
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
ファイルエクスプローラー
2 ファイルSKILL.md を表示中
SKILL.md
ソースの指示 · 読み取り専用プレビュー- name
- knowledge-graph
- scope
- partial
- description
- [UDS] Trace impact chains across specs, decisions, and code via a knowledge graph, with a Markdown fallback when no engine is present. Use when: asking what a spec or decision affects, finding which code implements an artifact, tracing dependencies between specs, ADRs, and modules. Not for: plain text search with no spec or decision anchor — use Grep; authoring the spec itself — use /sdd. Keywords: knowledge graph, impact chain, traceability, spec impact, decision graph, 知識圖, 影響鏈, 規格追蹤.
- allowed-tools
- Read, Glob, Grep, Bash(curl:*)
- argument-hint
- [artifact id, e.g. XSPEC-205 | 產物 id]
# Knowledge Graph | 知識圖
> **Language**: English | [繁體中文](../../locales/zh-TW/skills/knowledge-graph/SKILL.md)
Answer structural questions across specs, decisions, and code — *"what is the full impact chain of XSPEC-205?"* — using the [Knowledge Graph Memory](../../core/knowledge-graph-memory.md) relationship schema. Works with or without a graph engine.
回答橫跨規格、決策與程式碼的結構性問題——*「XSPEC-205 的完整影響鏈是什麼？」*——依據[知識圖記憶標準](../../core/knowledge-graph-memory.md)的關係 schema。有無圖引擎皆可運作。
> **Implements**: XSPEC-237 Phase 5 — knowledge-graph skill (EngramGraph opt-in)
## Mode Selection | 模式選擇
Detect which mode to use **before** answering:
| Condition | Mode |
|-----------|------|
| `ENGRAM_URL` set, or a local graph engine responds on `/health` | Service mode (engine) |
| Otherwise | Degraded mode (Markdown) |
## Workflow | 工作流程
1. **Resolve the target** — normalise the argument to a canonical id (`XSPEC-205`, `DEC-062`, a function name).
2. **Choose mode** — probe for a graph engine (service) else fall back (degraded).
3. **Service mode (AC-5b)** — issue a single multi-hop query and present the returned chain, including cross-domain links (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. **Degraded mode (AC-5a)** — with no engine, read the target document, follow its `impacts`/`impacted_by`/`supersedes`/`related` front-matter and inline `[[ref]]` links by reading the linked files, and assemble the chain manually (bounded by reading depth).
5. **Present the chain** — list the connected Specs and Decisions, the edge type for each hop, and (if present) each node's `confidence`, highest first.
6. **State the mode used** — always say whether the answer came from the engine or Markdown fallback, so completeness is clear.
## Relationship Schema | 關係 schema
See [knowledge-graph-memory](../../core/knowledge-graph-memory.md). Front-matter fields: `related`, `impacts`, `impacted_by`, `supersedes`, `implements`. Edge derivation: Decision `impacts` Spec → IMPACTS; Decision `supersedes` Decision → SUPERSEDES.
關係欄位與邊推導見[知識圖記憶標準](../../core/knowledge-graph-memory.md)。
## Next Steps Guidance | 下一步引導
- If degraded mode hit a reading-depth limit, tell the user a graph engine (e.g. EngramGraph) would give a complete chain, and how to set `ENGRAM_URL`.
- If a referenced id was not found, surface it as a dangling reference to fix.
- Offer to add missing `impacts`/`impacted_by` front-matter to the documents you traversed.
## Reference | 參考
- Standard: [core/knowledge-graph-memory.md](../../core/knowledge-graph-memory.md)
- Engine (opt-in): [EngramGraph](https://github.com/AsiaOstrich/EngramGraph) — `engramgraph`
- Detailed guide: [guide.md](guide.md)
GitHubで見る