用途:graph-update 属于代码智能类技能,目标是把工作区中未提交的改动(已暂存与未暂存)更新进知识图谱。它检测变更文件并重新解析,使图谱与当前工作区保持一致。
主要能力:将工作区与基准提交(默认 HEAD~1)做差异比较;找出新增、修改、删除的文件;重新解析新增与修改的文件,从图谱中移除已删除文件;随后重新运行 API 连接器与隐式连接器(与 sync 相同)。
使用方式:通过 Bash 运行 python .claude/scripts/code_graph update --json,并报告更新、新增、删除的文件数;若无变更则报告工作区干净、图谱已是最新。可用选项:--base 指定比较的基准提交(默认 HEAD~1)、--repo 指定仓库根路径(默认 .)、--json 以 JSON 输出结果(默认关闭)。
适用场景:会话中途编辑文件后(工作区脏、尚未提交);graph-sync 报告已是最新但本地有改动时;对未提交工作运行 graph-blast-radius 之前;以及在 graph-sync 末尾作为第 4 步被显式调用。
相关技能:graph-sync(同步已提交变更,其第 4 步会调用本技能)、graph-build(全量或增量构建图谱)、graph-blast-radius(分析变更的结构影响)、graph-query(查询代码关系)。
限制与约束:资料强调执行需基于证据(file:line)且置信度超过 80% 才行动,需保持任务跟踪同步,不得跳过强制工作流或技能门禁;若某必需步骤或工具在当前环境无法运行,应先停止并询问用户,不得擅自调整。资料未提供该技能的收费、价格、平台支持范围或效果数据。