用途：graph-query 是 easyplatform 仓库中的代码智能技能，用于通过结构化知识图谱查询代码之间的关系与连接，例如相关文件、调用者、被调用者、导入、测试、继承和文件结构。
主要能力：支持 callers_of、callees_of、imports_of、importers_of、children_of、tests_for、inheritors_of、file_summary 等查询模式，并提供自然语言别名（如 who_calls、depends_on、subclasses_of）。可用 connections 命令一次返回文件摘要、导入、被导入、调用者和测试覆盖；用 trace 沿多种边类型做 BFS 全流程追踪；用 search 按关键字查找节点；用 find-path 查找两节点间最短路径；用 batch-query 批量查询多个文件。
使用方式：先确认 .code-graph/graph.db 存在，否则需先运行 $graph-build。查询通过 Bash 执行，例如 python .claude/scripts/code_graph query <pattern> <target> --json，复合查询用 python .claude/scripts/code_graph connections <target> --json，追踪用 python .claude/scripts/code_graph trace <target> --direction both --depth 3 --json。建议始终加 --json 以获得结构化输出，可用 --limit、--filter、--node-mode 控制结果规模。
适用场景：需要了解某函数被谁调用、某文件依赖什么、哪些测试覆盖某函数、类继承关系，或排查跨文件系统流程时使用。
限制：需 Python 3.10+ 及 tree-sitter、tree-sitter-language-pack、networkx；图谱须先构建。该技能只做查询，不负责重建图谱、变更影响分析、批量导出或生成图表，这些分别由 $graph-build、$graph-blast-radius、$graph-export 处理。结果需以 file:line 证据支撑，置信度需高于 80% 才可行动。