AI导哈

智能体工作流

codegraph

onsager-ai/dev-skills

Pre-indexed code knowledge graph (MCP, SQLite + tree-sitter) for faster, lower-token exploration of brownfield codebases. Use when starting work on a repo larger than ~500 files or when the task involves cross-file traversal — "where is X used", "what calls Y", "what breaks if I change Z", "trace flow from A to B", "explain this subsystem". Skip for single-file edits or sessions shorter than the cold-start cost. Triggers include "codegraph", "code graph", "index this repo", "where is X defined", "find callers of", "callees of", "blast radius of changing X", "explore this codebase". Cuts the grep + Read loops needed to orient, via O(1) SQLite lookups and FTS5 search over 8 MCP tools — but it's an unsound tree-sitter approximation, so grep stays the completeness backstop for renames/exhaustive callers.

  • 833 次安装
  • 7 星标
  • 收录于

安装命令

npx skills add https://github.com/onsager-ai/dev-skills --skill codegraph

SKILL.md

codegraph

Local code graph exposed as 8 MCP tools. Accelerates exploration with O(1) SQLite lookups and FTS5 search — slashing the grep + Read loops needed to orient in a codebase.

It does not replace grep. Codegraph is a tree-sitter approximation of the call graph, not a compiler-grade one: it is fast and low-token but unsound (it has false negatives). Treat it as the accelerator for orientation and traversal, and keep grep as the source of truth for completeness. See Soundness & limits below — this distinction is load-bearing, not a footnote.

When to use

  • Brownfield repo where structure is non-obvious
  • Task involves: "where is X used", "what breaks if I change Y", "trace flow from A to B"
  • Long-running session — cold-start cost amortizes over multiple queries

When NOT to use

  • Single-file edits or trivial lookups
  • Session likely shorter than cold-start cost (see references/spike.md for per-repo numbers)
  • Repo not initialized AND no cached .codegraph/ AND short session

Soundness & limits — read before trusting a result