SuperAPI AI 工具集

insight-diagram

通用与其它

查看项目

更新于 10-15 23:46

技能介绍

用途:分析任意代码库,生成系统架构图、流程图及多种 UML 图,并渲染为 HTML+SVG,保存到 docs/ 目录,用于软件项目文档可视化。

主要能力:覆盖结构性图形(架构图、类图、对象图、组件图、部署图、包图、复合结构图、剖面图)与行为性图形(流程图、用例图、活动图、状态机图、序列图、通信图、定时图、交互概览图、泳道图)。examples/ 目录提供 13 个已完成 HTML 示例作为样式与结构模板;包图、复合结构图、剖面图、状态机图、定时图无对应示例,需参考最相近示例。

使用方式:先读取 CLAUDE.md、扫描源码(如 /*.go、/.py、**/.ts)、读取入口文件并用 Grep 提炼组件、关系、类型、流程与部署信息;随后用 AskUserQuestion 让用户多选图表类型,默认推荐 architecture + sequence + flowchart;逐张生成时先阅读对应示例,再调用 /architecture-diagram(须指定 light 风格),输出到 docs/<标识>.html。生成后必须运行几何校验:python3 skills/insight-diagram/scripts/review_svg.py docs/<标识>.html --min-gap 8(批量可传 docs/*.html),修正 ERROR 后再继续。批量顺序为 architecture → component → deployment → package → composite-structure → profile → class → object → usecase → flowchart → activity → state-machine → swimlane → sequence → communication → timing → interaction-overview。

适用场景:软件项目架构与流程文档、团队沟通、设计评审等需要图形化表达的场合。

限制:示例中的业务数据为虚构案例,须替换为目标项目真实信息;风格固定为 light Claude 风格;不得出现 SVG 元素遮盖与框重叠;无对应示例的图表类型需自行参照相近示例;脚本仍可能对生命线底部消息、泳道边界等设计本意报出 WARNING,需人工核对。具体收费、平台支持范围等信息暂未提供。