graph-code 是一个“代码智能”技能,围绕一份结构化代码知识图谱展开工作。图谱由 Tree-sitter 解析出的节点和边构成,保存在本地 SQLite 数据库 .code-graph/graph.db 中,并通过 python .claude/scripts/code_graph 命令行工具进行操作。
主要能力 该技能以“每次调用一种模式”的方式运行,共六种模式:
- build:构建、更新或同步图谱,支持 --scope=full|update|sync,首次使用会安装图谱工具。
- query:查询关系,包括调用者、被调用者、导入、被导入、测试、继承、文件结构、搜索、find-path 与批量查询。
- trace:追踪完整系统流程,穿过 CALLS、事件、消息总线与 API 端点,可指定方向、深度、边类型与节点模式。
- blast-radius:分析当前 git 变更的结构性影响,包括受影响文件与函数、测试缺口和风险等级。
- connect-api:检测前端到后端的 API 连接,并创建 API_ENDPOINT 边。
- export:导出完整或过滤后的 JSON 图谱快照,或将单个文件导出为 Mermaid 图(--format=json|mermaid,默认 JSON)。
使用方式 模式可通过 --mode=build|query|trace|blast-radius|connect-api|export 指定,也可用第一个参数直接写模式名。未指定模式且自然语言请求只匹配唯一意图时选择对应模式,否则应展示模式调度表并询问,不做猜测。每种模式执行前需先完整阅读对应的 references/mode-<x>.md 文件。CLI 应始终加 --json 以获得结构化输出。若 .code-graph/graph.db 不存在,会明确报告“图谱未构建”,提示运行 build 模式或改用 grep,并停止该模式,这不视为错误。工作过程中要求跟踪任务进度,并用 file:line 证据支撑结论(置信度需高于 80% 才据以行动)。
适用场景 适合需要理解代码结构关系的任务,例如查找某函数被谁调用、某模块依赖哪些文件、某文件对应的测试、某类被谁继承;追踪“某个操作触发后发生什么”的跨模块或前后端流程;评估一次改动的影响面与风险;以及导出图谱数据或生成 Mermaid 图用于可视化。
限制与注意事项 图谱可能已过时或不完整,例如滞后于未提交的修改或未索引的路径,因此技能明确将其定位为“提示”而非“证明”,重要结论需用 grep 或阅读文件核实。对于低风险或局部改动可跳过图谱。该技能不强制其他技能或工作流使用;blast-radius、connect-api、connect-implicit、export、export-mermaid、review-context、describe 等 CLI 动词本身不是技能,JSON 与 Mermaid 导出统一由 export 模式负责。具体安装与环境前提、各模式的详细参数和输出格式,资料中指向对应模式说明文件,本介绍未展开的部分暂未提供。