前言¶
接手一个陌生项目，最先碰到的问题通常是“这个代码的结构长什么样”。读源码是最笨但最可靠的办法，可惜成本很高：一个中等规模的工程，光是把类与类的依赖关系理清楚就要花上半天，更别说还要整理成能放进文档的图。另一个常见场景是写技术文档或做代码评审，口头描述“这个模块调用了哪些接口”很容易漏项，画一张图比写三段话更清楚。
下面介绍 SkillHub 上的 程序代码UML图生成-万维易源。它做的事是：接收你上传的代码文件和自定义的分析要求，生成 UML 图和一份深度的代码文本分析报告，再把两者融合成一份结构化的交付物。适合代码结构梳理、架构设计还原、技术文档编写、代码评审、遗留项目接手这类场景。
这是什么¶
一句话定位：一个把代码文件解析为 UML 图和文字分析报告的 Skill，输出是两者合并后的结构化交付物。
- 名称：程序代码UML图生成-万维易源
- 坐标：
@showapi/code-uml-text-analysis-showapi - 版本：1.0.1
- 发布者：万维易源
- 来源类型：enterprise（企业来源）
- 分类：dev-programming
- 官方地址：https://api.skillhub.cn/showapi/code-uml-text-analysis-showapi
- SkillHub 页面：https://www.skillhub.cn/skills/showapi/code-uml-text-analysis-showapi
社区数据（以 SkillHub 页面抓取结果为准）：评分 100000，下载 11745 次。
核心功能¶
- 代码文件解析：接收用户上传的代码文件，识别其中的类、接口、依赖关系等结构信息。
- UML 图生成：根据解析结果产出 UML 图，用于表达代码的结构与依赖。
- 深度代码文本分析报告：除了图，还会输出文字形式的分析内容，说明代码的结构逻辑。
- 融合为结构化交付物：图与报告不是分开的两份文件，而是按逻辑合并成一个完整的结构化结果，便于直接用于文档、评审或归档。
- 自定义分析要求：可以在上传代码的同时给出自己的分析要求，输出会按这些要求组织。
安装与启用¶
该 Skill 采用通用 SKILL.md 格式，可在支持 Skill 的 Agent 环境（Cursor、Claude Code 等）中加载。
两个环境事实需要注意：
- 该 Skill 标签为
requires_api_key=true，即需要 API Key。使用前要先准备好万维易源侧的密钥并正确配置，否则调用会失败。 - 公开资料中未给出统一的安装命令或目录路径。请以官方页面 https://api.skillhub.cn/showapi/code-uml-text-analysis-showapi 与 SkillHub 页面 https://www.skillhub.cn/skills/showapi/code-uml-text-analysis-showapi 的说明为准，不要照抄第三方写法。
具体配置字段（密钥名称、放置位置、环境变量写法）同样以官方页面为准，这里不推测。
典型用法¶
官方公开资料中没有给出逐条可复现的调用命令，因此下面只描述调用逻辑，命令以官方页面为准。
- 准备代码文件：把需要分析的源码整理成可上传的形式。
- 明确分析要求：写清楚你关心什么，例如“只要类之间的依赖关系”或“重点说明模块划分与调用入口”。
- 提交任务：在 Agent 环境中通过该 Skill 发起分析，传入代码文件和自定义分析要求。
- 取回交付物：获得融合后的结构化结果，其中包含 UML 图和对应的文字分析。
适用场景与注意¶
适合的场景：
- 代码结构梳理：快速看清一个陌生仓库的组成。
- 架构设计还原：把现有实现反向整理成架构图。
- 技术文档编写：为文档提供可直接使用的图与说明。
- 代码评审：用结构化结果对照检查依赖是否合理。
- 遗留项目接手：降低读源码的起步成本。
需要注意的地方：
- 需要 API Key，未配置密钥时无法调用。
- 该 Skill 属于 enterprise 来源，安装和调用受来源方策略约束。
- 上传的代码可能包含内部实现细节，涉及敏感代码时要确认数据使用范围。
- 输出质量取决于代码本身的可解析程度：结构混乱、大量动态反射或宏生成的代码，图的准确性会下降，必要时应人工复核。
结尾¶
这个 Skill 的价值在于把“读代码—画图—写报告”这条链路缩短成一次调用：你给代码文件和分析要求，它返回 UML 图与文字报告融合后的结构化交付物，可以直接用于文档、评审和架构还原。官方地址：https://api.skillhub.cn/showapi/code-uml-text-analysis-showapi
