菜单
Auto-build and continuously update the project knowledge graph (.gsd-graph/) for brownfield onboarding and ongoing work — enable, sync, status, ask
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/open-gsd/gsd-graph --skill gsd-graph命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
基于 SOC 职业分类
| name | gsd-graph |
| description | Auto-build and continuously update the project knowledge graph (.gsd-graph/) for brownfield onboarding and ongoing work — enable, sync, status, ask |
Invoke this skill with /skill:gsd-graph or /gsd-graph.
Banner (show first):
GSD > GRAPH
@opengsd/gsd-graph builds a local knowledge graph from project docs (not plain RAG). Store: .gsd-graph/graph.v1.json.
When this project has a graph store, route questions about the project THROUGH THE GRAPH before re-reading .planning/, docs/, or README files — that is the entire token-savings point of the tool.
If the gsd-graph MCP server is registered (check for graph_* tools), prefer these over file reads:
| Question shape | Tool |
|---|---|
| "why/how does A relate to B", multi-hop questions | graph_answer (citations included) |
| "how does A connect to B" | graph_why |
| "what are the main areas / overview" | graph_answer (auto community themes) or graph_communities |
| find a concept / fuzzy name | graph_resolve, graph_query |
| "what changed" | graph_diff |
| session-start briefing | read resources gsd-graph://report and gsd-graph://communities |
record a learned fact (if graph_assert present) | graph_assert (episodes survive rebuilds) |
Without MCP, use the CLI equivalents: gsd-graph ask, why, top, query, assert. Only fall back to reading the underlying files when the graph abstains AND its suggestions don't resolve the question — then consider gsd-graph sync (stale graph) before a manual doc crawl.
command -v gsd-graph./node_modules/.bin/gsd-graphnpx gsd-graph (after local npm install @opengsd/gsd-graph)npx -y @opengsd/gsd-graph (zero-install scoped package)node bin/gsd-graph.jsIf missing: npm install @opengsd/gsd-graph.
npx gsd-graph enable # after local install
# or: npx -y @opengsd/gsd-graph enable
npx gsd-graph ask "…" # multi-hop answer with citations
npx gsd-graph sync # incremental after doc changes
npx gsd-graph status
One command replaces the old multi-step installer + sync.
$ARGUMENTS)| Argument | Action |
|---|---|
enable | gsd-graph enable (full brownfield + auto_update) |
sync | Incremental gsd-graph sync |
sync --full | Full re-extract |
status | gsd-graph status |
ask / answer / query | Q&A and search |
update | Alias of sync |
| (empty) | Print usage |
gsd-graph enable
# install-only (no corpus):
gsd-graph enable --skip-sync
Writes .gsd-graph/config.json (enabled, auto_update). Mirrors into .planning/config.json → gsd_graph only if that file already exists. Installs skill under ~/.agents/skills and ~/.claude/skills. Copies hooks to .gsd-graph/hooks/.
With auto_update: true, PostToolUse Bash should run:
.gsd-graph/hooks/gsd-graph-update.sh
Detached incremental sync after commits on the default branch. Not in CI. Status: .gsd-graph/.last-sync-status.json.
.planning/, docs/, README and similar top-level md. Not full src/. Override: sync --corpus <path>.
enablegraph.json / GRAPH_REPORT.md as SoT — only graph.v1.jsonGSD > GRAPH
enable One-shot setup + full graph
sync [--full] Incremental (or full) rebuild
status Freshness and counts
ask <question> Grounded multi-hop answer
query <term> Term seed-expand