SuperAPI AI 工具集

graph-sync

编程与开发

查看项目

更新于 10-15 21:35

技能介绍

用途:将代码审查知识图谱与当前 git 状态保持一致。通过比较上次同步提交与 HEAD,检测变更文件并重新解析,删除已移除文件,并记录新的 HEAD。

主要能力:读取图谱元数据中的 last_synced_commit,获取当前 HEAD;若不同则运行 git diff --name-status 找出变更、新增、删除的文件,解析变更/新增文件、从图谱移除删除文件,并更新 last_synced_commit。同步后会自动重跑 API 连接器(connect-api)与隐式连接器(connect-implicit),刷新前后端 API 端点边及行为边(如 MESSAGE_BUS、TRIGGERS_EVENT、PRODUCES_EVENT、TRIGGERS_COMMAND_EVENT)。

使用方式:同步已提交变更执行 python .claude/scripts/code_graph sync --json;更新工作区未提交变更执行 python .claude/scripts/code_graph update --json。会话启动时自动运行,手动调用主要用于拉取、合并、切换分支或解决冲突之后。

回退行为:无存储提交时首次同步会扫描磁盘上不在图谱中的文件并加入;提交不可达(如 rebase/force-push 后)自动回退为全量重建;非 git 项目静默跳过。

限制:sync 仅检测已提交变更(last_synced_commit 到 HEAD),未提交/暂存变更需用 update;没有增量子命令,也没有 --files 参数,变更文件由 git 自动检测。相关技能包括 graph-update、graph-build、graph-blast-radius、graph-query。