ai-spector-graph
Traceability graph operations: analyze data-source, index refresh, graph validate, impact, visualize, semantic search (CocoIndex), natural language graph lookup, doc summaries, and layer sync audit (design drift since baseline). Use when the user asks to analyze sources, refresh or validate the graph, see impact, visualize traceability, find docs by concept, or check doc drift since baseline. Do not use for writing SRS, basic design, HTML prototype, or formal document sign-off.
- License 许可
- MIT
- 最近更新
- 2026-07-08
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- ai-spector-graph
- description
- Traceability graph operations: analyze data-source, index refresh, graph validate, impact, visualize, semantic search (CocoIndex), natural language graph lookup, doc summaries, and layer sync audit (design drift since baseline). Use when the user asks to analyze sources, refresh or validate the graph, see impact, visualize traceability, find docs by concept, or check doc drift since baseline. Do not use for writing SRS, basic design, HTML prototype, or formal document sign-off.
02 资源文件 11
- 参考文档references/analyze.md3.5 KB
- 参考文档references/graph-commands.md445 B
- 参考文档references/impact.md7.5 KB
- 参考文档references/index.md3.2 KB
- 参考文档references/link-graph.md1.4 KB
- 参考文档references/search.md2.4 KB
- 参考文档references/summary.md1.5 KB
- 参考文档references/sync-audit.md5.2 KB
- 参考文档references/sync-graph.md1.4 KB
- 参考文档references/validate-graph.md1.3 KB
- 参考文档references/visualize-graph.md723 B
03 SKILL.md 正文
AI Spector — Graph
Core: ../ai-spector/skill.md · Workflow: ../../WORKFLOW.md
Route by intent
Read one runbook section for the user's intent, then execute it end-to-end:
| Intent | Runbook section |
|---|---|
| Analyze / ingest data-source | references/analyze.md |
| Refresh graph after doc edits | references/index.md |
| Validate graph | references/validate-graph.md |
| Impact / what to regenerate | references/impact.md |
| Visualize in browser | references/visualize-graph.md |
| Semantic relatesTo links | references/link-graph.md |
| Repair graph from registry | references/sync-graph.md |
| Human doc summaries | references/summary.md |
| Semantic search / find docs by concept | references/search.md |
| Layer sync audit / design drift | references/sync-audit.md |
Checklist
- [ ] Matched runbook section read completely
- [ ] MCP first (ai-spector server) → CLI fallback (npx ai-spector) — see ai-spector/skill.md
- [ ] On failure: pause → report → fix per ai-spector/references/cli-failures.md
- [ ] No .docops/guide/ links
Shared references
04 同仓库更多 Skills
ai-spector
暂无简介
ai-spector
Core AI Spector skill: setup, upgrade, adopt, check, docops CLI, work sessions (resume/route/pause), course link, and onboarding help. Use when the user says help, I'm stuck, where am I, or what's next about project setup; project init/setup, upgrade, adopting existing docs, workspace check, Writer contract bootstrap (docops init/migrate), resuming or managing active work sessions, or learning via the course. Do not use when the user clearly wants generation, graph ops, or contract review/comments — use the matching skill instead.
ai-spector-graph
Traceability graph operations: analyze data-source, index refresh, graph validate, impact, visualize, semantic search (CocoIndex), natural language graph lookup, doc summaries, and layer sync audit (design drift since baseline). Use when the user asks to analyze sources, refresh or validate the graph, see impact, visualize traceability, find docs by concept, or check doc drift since baseline. Do not use for writing SRS, basic design, HTML prototype, or formal document sign-off.
ai-spector-generate
All document generation: SRS, basic design, detail design, HTML prototype; incremental feature/section changes (resolve-task); and template pack import. Use for "generate SRS/basic design/detail design", "write chapter N", "add feature", "update section", "I want to add…", "HTML prototype", Capability-gated for Writer cloud UI only — local adapter (`.ai-spector/engine.json`) uses MCP/CLI work sessions even when `capabilities.generate` is false.
ai-spector-contract
Writer contract operations: document sign-off (review_approve), comment resolution (doc threads C-NNN and prototype batches B-NNN), translation sync, and language status. Use for review queue, approve doc by logical path (srs/01-overview), pending client review, resolve C-NNN threads, B-NNN prototype batches, resolve translations, or check language status. NOT for graph, generate, or setup — use the matching skill instead.
ai-spector
Core AI Spector skill: setup, upgrade, adopt, check, docops CLI, work sessions (resume/route/pause), course link, and onboarding help. Use when the user says help, I'm stuck, where am I, or what's next about project setup; project init/setup, upgrade, adopting existing docs, workspace check, Writer contract bootstrap (docops init/migrate), resuming or managing active work sessions, or learning via the course. Do not use when the user clearly wants generation, graph ops, or contract review/comments — use the matching skill instead.