SuperAPI AI 工具集

code-cartographer

编程与开发

查看项目

更新于 10-16 07:08

技能介绍

用途

Code Cartographer 用于分析和映射遗留代码库中的架构、数据流与风险,将复杂、缺乏测试的代码转化为可视化图表与可操作建议。

主要能力

  • 定位目标:根据函数名或文件路径,使用 Glob 查找文件、Grep 定位具体函数或类。
  • 映射调用关系:追溯调用方(谁使用了它)和被调用方(它使用了什么)。调用栈向上最多 5 层,依赖树向下最多 3 层。
  • 检测副作用:识别全局状态变更(全局变量、单例修改、静态类变量)、外部系统交互(数据库查询、HTTP 请求、文件系统操作、环境变量读取)以及隐藏行为(事件监听、定时器注册、日志监控、抛出的异常)。
  • 过滤噪声:排除 node_modules、vendor、third_party、dist、build、out、.next 等目录,以及测试文件和生成文件,聚焦 src、lib、app 下的应用代码和自定义业务逻辑。
  • 可视化与总结:生成 Mermaid 流程图,标注外部系统与全局状态,并给出风险清单和简明摘要。

使用方式

输入函数名或文件路径即可触发分析。工作流分为五步:

  1. 使用 Glob 查找文件,再用 Grep 定位函数或类。
  2. 追踪调用方与被调用方,限制分析深度以避免无限递归,在标准库、框架方法、第三方库边界处停止。
  3. 扫描目标及其直接依赖中的风险信号,涵盖全局状态修改、外部系统交互、隐藏行为。
  4. 排除 vendor、node_modules、构建产物、测试与生成文件,聚焦自定义业务逻辑。
  5. 输出 Mermaid 流程图、"Don't Touch" 列表和英文简明摘要。

Mermaid 图使用颜色编码:红色/粉色(#ff9999)表示外部系统(数据库、API),橙色(#ffcc99)表示全局状态或副作用,蓝色/白色表示纯函数与本地逻辑。

"Don't Touch" 列表用于标识:被 5 个以上文件调用的高耦合文件、包含关键副作用(数据库模式、认证逻辑、支付处理)的文件、缺乏测试且修改敏感状态的文件。

适用场景

适用于以下请求:

  • "这个函数是做什么的?"
  • "这段代码在代码库中被用在哪里?"
  • "我想重构但担心破坏其他部分。"
  • "梳理 [功能/模块] 的架构。"
  • "调用它会有什么副作用?"
  • "谁依赖这个文件?"

限制

不适用于简单语法问题、单行代码解释,也不用于生成新代码。分析设有搜索深度限制:调用栈最多向上 5 层,依赖树最多向下 3 层,并在框架和库边界停止。