SuperAPI AI 工具集

map-diff

编程与开发

查看项目

更新于 10-23 23:06

技能介绍

用途:map-diff 用于在代码提交前评估暂存区变更对 Cortex 函数依赖关系的影响,帮助开发者确认哪些下游函数、评估集和业务能力会受影响。

主要能力:读取已提交的 coco-map.json 知识图谱,将暂存文件匹配到已映射函数,沿依赖图追踪直接依赖项和最多 5 跳的传递依赖项,检查共享评估集和业务能力定义的变化,并输出结构化影响报告(含修改函数列表、下游影响、共享评估集、受影响业务能力、暴露的缺口和提交前复查建议)。

使用方式:运行 $map diff。执行前需满足三项前置条件:.cocoplus 已初始化;.cocoplus/map/coco-map.json 已存在(可先运行 $map 生成);暂存区存在非空变更(git diff --staged)。若条件不满足,技能会输出相应提示并退出;若暂存变更未触及任何已映射函数,则提示可安全提交。

适用场景:在提交涉及 Cortex 函数的改动前做影响面检查,识别可能受连带影响的函数与评估集,发现新增依赖未评估函数等缺口。

限制:仅分析暂存区变更,不分析未暂存改动;依赖链追踪最多 5 跳;不创建 git 提交、不修改图谱或项目文件,属于只读分析。