SuperAPI AI 工具集

code-visualizer

通用与其它

查看项目

更新于 10-15 22:32

技能介绍

用途:自动生成与维护可视化的代码流程图。该技能分析 Python 模块结构,提取导入关系,生成 mermaid 图,并监控“代码已改、图未更新”的过期情况。

主要能力:一是模块分析,解析 Python 文件提取导入语句、类定义与继承、函数导出(all)和模块依赖;二是图表生成,输出模块关系(flowchart)、类层次(classDiagram)与数据流图;三是过期检测,对比文件修改时间戳、Git 历史与图中模块完整性,输出新鲜度报告;四是 PR 架构影响展示,标出新增、修改、未变模块及依赖变化。

使用方式:调用 analyze_python_modules 与 extract_import_relationships 做分析,再委托 mermaid-diagram-generator 生成 mermaid 语法,复杂架构委托 visualization-architect。常见触发语句如“为某模块生成代码流程图”“我的架构图是否最新”“这个 PR 带来哪些架构变化”。依赖 mermaid-diagram-generator 技能与 Python 3.8+,Git 可选。

适用场景:新模块建图、PR 评审中展示架构影响、检查图表是否过期、可视化导入依赖、重构前理解模块依赖。

限制:过期检测基于时间戳而非语义,触动文件、重排格式或 Git 更新 mtime 都可能误报,逻辑变更、内部重构、函数签名变化难以识别;仅分析导入关系,运行时依赖、配置连接、鸭子类型不可见;目前只支持 Python,不做运行时与动态分析,动态导入可能漏检;跨仓库依赖与外部包内部不可分析;不同场景准确率有差异(新模块检测约95%+,导入关系约90%+,过期检测约70-80%)。不适合安全审计、运行时依赖分析、跨语言项目与高度动态代码库。