SuperAPI AI 工具集

map-explain

编程与开发

查看项目

更新于 10-23 23:07

技能介绍

map-explain 是 CocoPlus 中用于查询已构建知识图谱的只读解释工具。其核心用途是:针对一个具体的 Cortex 函数、业务能力或领域词汇,用业务语言输出结构化说明,帮助理解该元素在项目中的角色和关联。\n\n主要能力:\n- 解释函数:输出域级描述、Cortex API 类型、文件路径、Schema 位置、所属业务能力、直接与传递依赖、下游依赖、评估覆盖情况以及最后分析时间。\n- 解释业务能力:输出能力描述、实现该能力的函数列表、评估健康度、能力内跨函数依赖结构以及最后分析时间。\n- 解释领域词汇:输出定义、关联函数、别名以及最后分析时间。\n- 目标匹配不区分大小写,精确匹配失败时进行子串模糊匹配。\n\n使用方式:\n命令为 $map explain <target>,其中 <target> 为必填参数,可以是函数名、业务能力名或模式元素名。执行前需确保 .cocoplus/ 已初始化,且 .cocoplus/map/coco-map.json 已存在(需先运行 $map 生成)。该工具为只读操作,不写入任何文件,不创建 git 提交,不修改 coco-map.json,也不获取外部文档。依赖链分析最多追溯 3 跳,更深层分析属于 $map 的职责。\n\n适用场景:\n- 开发者需要快速理解某个 Cortex 函数的作用及其上下游关系。\n- 团队需要以业务视角查看某业务能力由哪些函数实现、评估覆盖是否完整。\n- 需要确认领域词汇在代码中的关联函数和别名。\n\n限制与错误处理:\n- 若 .cocoplus/ 未初始化,提示先运行 $pod init。\n- 若 coco-map.json 不存在,提示先运行 $map。\n- 若目标未找到,输出可用函数和能力列表,并建议运行 $map 刷新。\n- 若 coco-map.json 解析错误,输出警告并建议重新运行 $map。\n- 评估基线缺失时标记为 Gap detected。\n\n该技能不提供外部文档获取功能,该职责属于 CocoScout。