代码图谱上下文

Name: 代码图谱上下文
Author: CodeGraphContext

其他社区

作者仓库星标 3,585
作者仓库 CodeGraphContext

解读按原文结构重写，命令、链接、术语均保留；右侧可核对作者原始 SKILL.md

方法与流程

Core workflow：Install: pip install codegraphcontext (or pipx install codegraphcontext). With uv, uv tool install codegraphcontext or uvx codegraphcontext … is supported; if a parser fails with ModuleNotFoundError: treesittercsharp, run with an explicit extra package, e.g.…

适用与边界

When to use this skill：Indexing or re-indexing a codebase for AI or CLI queries. Explaining how to install and run cgc, choose a database backend, or wire MCP into an editor. Interpreting CGC tools: codegraphfindcode, analyzecoderelationships, addcodetograph, etc.
当前原文没有单列不适用场景或限制。

原文中的明确线索

要点：「Install」、「uv」、「Configure」、「Index」、「Query」、「OpenCode」、「indexing the workspace」、「fuzzy symbol search」
文件与命令：cgc、codegraphfindcode、analyzecoderelationships、addcodetograph、pip install codegraphcontext、pipx install codegraphcontext、uv tool install codegraphcontext、uvx codegraphcontext …

流狐整理：以上内容来自当前 SKILL.md 的章节与原词；未补写作者没有声明的工具、兼容性或能力。

CodeGraphContext (CGC)

When to use this skill

Indexing or re-indexing a codebase for AI or CLI queries.
Explaining how to install and run cgc, choose a database backend, or wire MCP into an editor.
Interpreting CGC tools: codegraph_find_code, analyze_code_relationships, add_code_to_graph, etc.

Core workflow

Install: pip install codegraphcontext (or pipx install codegraphcontext). With uv, uv tool install codegraphcontext or uvx codegraphcontext … is supported; if a parser fails with ModuleNotFoundError: tree_sitter_c_sharp, run with an explicit extra package, e.g. uvx --with tree-sitter-c-sharp codegraphcontext ….
Configure: Optional ~/.codegraphcontext/.env for DEFAULT_DATABASE, Neo4j URI, or Kùzu path. Run cgc doctor if connections fail.
Index: From the repo root, cgc index . (or cgc index --force . to rebuild). Ensure CLI and MCP use the same config so they see the same graph.
Query: CLI (cgc find, cgc query, …) or MCP tools after cgc mcp setup / cgc mcp start in the client config.

MCP setup (short)

Run cgc mcp setup and pick the editor, or add a server entry that runs cgc with args mcp start and the same env as the CLI.
OpenCode: Follow the vendor MCP docs for registering a stdio server, then point the command at cgc with arguments mcp, start (same as other editors). Official OpenCode MCP overview: OpenCode MCP servers.

Agent behavior

Prefer indexing the workspace before deep graph queries if the user has not indexed yet.
For fuzzy symbol search on Kùzu/Falkor backends, matching is typo-tolerant (edit distance); on Neo4j, full-text fuzzy uses Lucene-style terms—preserve original casing in queries when fuzziness matters for camelCase symbols.
If Repository.path is missing in the DB, that row is skipped for path checks and a warning is logged when repositories are listed; suggest cleaning stale Repository nodes (see Neo4j example in logs) if it keeps happening.

References in this repo

CLI entry: codegraphcontext.cli.main
MCP server and tool wiring: codegraphcontext.server, tool_definitions.py
User-facing setup detail: docs/docs/setup_workflows.md, docs/docs/guides/mcp_guide.md
Published copy of this skill (for docs / GitHub): docs/docs/agent_skill_codegraphcontext.md

流狐档案作者与许可取自来源；运行、权限和网络为流狐检测或估算

流狐分类: 通用
作者声明 Agent: 未找到明确声明；不据此推断已兼容或已测试
静态检查: 88 / 100 · 启发式扫描，不代表运行安全
作者 / 版本 / 许可: @CodeGraphContext · 未声明 license
流狐 Token 估算: 低消耗
流狐接入估算: 即装即用
是否需要外部 API Key: 未发现要求
检测到的系统要求: 未声明
底层运行要求: 未声明
检测到的文件与系统行为: 只读
允许写入 / 修改
读取环境变量
检测到的网络行为: 仅限本地
安装命令数: 无（仅作为资料）

档案由构建时根据 SKILL.md 与安装命令自动衍生，可能与作者实际意图存在差异。

需要注意： 未限定 allowed-tools，默认拥有全部工具权限。

输出预览 codegraphcontext.preview

作者没有在当前 SKILL.md 中定义固定输出样例。

SKILL.md SKILL.md

# CodeGraphContext (CGC)

## When to use this skill

- Indexing or re-indexing a codebase for AI or CLI queries.
- Explaining how to install and run `cgc`, choose a database backend, or wire MCP into an editor.
- Interpreting CGC tools: `codegraph_find_code`, `analyze_code_relationships`, `add_code_to_graph`, etc.

## Core workflow

1. **Install**: `pip install codegraphcontext` (or `pipx install codegraphcontext`). With **uv**, `uv tool install codegraphcontext` or `uvx codegraphcontext …` is supported; if a parser fails with `ModuleNotFoundError: tree_sitter_c_sharp`, run with an explicit extra package, e.g. `uvx --with tree-sitter-c-sharp codegraphcontext …`.
2. **Configure**: Optional `~/.codegraphcontext/.env` for `DEFAULT_DATABASE`, Neo4j URI, or Kùzu path. Run `cgc doctor` if connections fail.
3. **Index**: From the repo root, `cgc index .` (or `cgc index --force .` to rebuild). Ensure CLI and MCP use the same config so they see the same graph.
4. **Query**: CLI (`cgc find`, `cgc query`, …) or MCP tools after `cgc mcp setup` / `cgc mcp start` in the client config.

## MCP setup (short)

- Run `cgc mcp setup` and pick the editor, or add a server entry that runs `cgc` with args `mcp` `start` and the same env as the CLI.
- **OpenCode**: Follow the vendor MCP docs for registering a stdio server, then point the command at `cgc` with arguments `mcp`, `start` (same as other editors). Official OpenCode MCP overview: [OpenCode MCP servers](https://opencode.ai/docs/ko/mcp-servers/#_top).

## Agent behavior

- Prefer **indexing the workspace** before deep graph queries if the user has not indexed yet.

…

证据边界与执行链路

作者原文负责流程事实；流狐只索引当前章节、要点、文件与命令。

章节    -> When to use this skill → Core workflow → MCP setup (short) → Agent behavior → References in this repo
要点    -> Install · uv · Configure · Index · Query · OpenCode · indexing the workspace · fuzzy symbol search
文件/命令 -> cgc · codegraphfindcode · analyzecoderelationships · addcodetograph · pip install codegraphcontext · pipx install codegraphcontext · uv tool install codegraphcontext · uvx codegraphcontext …
内容 SHA-256 -> fb49767a439a