SKILL.md 2.6 KB
name: "codegraph"
description: CodeGraph — 代码知识图谱 MCP 工具集。为 AI 编程智能体提供语义级代码理解：一次调用获取符号源码、调用链路、影响范围。支持 35+ 语言、17+ Web 框架路由、iOS/RN 跨语言桥接。自动同步文件变更。
CodeGraph
预构建的代码知识图谱 + MCP 服务器。解析代码库后用 SQLite（FTS5）存储所有符号、调用边、文件，通过 MCP 工具暴露给 Agent。自动同步文件变更。
安装
本技能附带原版安装脚本（scripts/install.ps1 / scripts/install.sh），复制本目录后执行：
# 从技能目录运行安装脚本
cd ~/.agents/skills/codegraph/scripts
# macOS / Linux
chmod +x install.sh && ./install.sh
# Windows PowerShell
.\install.ps1
安装脚本自动完成：装 CLI → 连线 Agent → 建索引。完成后重启 Agent。
MCP 工具
codegraph_explore — 主工具，优先用
codegraph_explore query:"AuthService loginUser UserRepository"
codegraph_explore query:"用户登录请求的完整链路"
codegraph_explore query:"app.ts"
返回源码 + 调用路径 + 影响范围。返回的源码视为已 Read，不要再用 Read 重读。
codegraph_node — 读文件 / 看符号
codegraph_node file:"src/services/user.ts"
codegraph_node symbol:"getUserById"
codegraph_node symbol:"getUserById" file:"user.ts"
codegraph_search — 搜符号位置
codegraph_search query:"UserRepo"
codegraph_search query:"getUser" kind:"function"
codegraph_callers / codegraph_callees — 调用关系
codegraph_callers symbol:"handleRequest"
codegraph_callees symbol:"handleRequest"
codegraph_impact — 改代码前看影响
codegraph_impact symbol:"UserService"
codegraph_impact symbol:"UserService" depth:3
codegraph_files — 项目文件结构
codegraph_files
codegraph_files filter:"src/**/*.ts"
工具选择
| 场景 | 工具 |
|---|---|
| 查架构/流程 | codegraph_explore |
| 读文件 | codegraph_node file:"路径" |
| 查符号定义+调用者 | codegraph_node symbol:"名" |
| 搜符号位置 | codegraph_search |
| 改前看影响 | codegraph_impact |
| 查谁调了我 | codegraph_callers |
| 查我调了谁 | codegraph_callees |
反模式
| ❌ 不要 | ✅ 应该 |
|---|---|
Read file |
codegraph_node file |
Grep → Read 循环 |
一次 codegraph_explore |
| 手搓调用链 | codegraph_explore query:"A B C" |
| 直接改代码 | 先 codegraph_impact |