前言¶

写设计文档或评审接口时，经常需要补一张 UML 图。手写 PlantUML 要记语法和布局规则；只用通用对话让模型「画个图」，输出风格往往不统一，也未必能直接落到 SVG、PNG 或 PDF。下面介绍 SkillHub 上的 plantuml-skill：在用户提出画 UML 图时，把自然语言描述转成符合 uml-diagrams.org 风格的 PlantUML，并支持渲染导出。

这是什么¶

plantuml-skill（坐标 @user_15292d5a/yjkj-plantuml-skill，版本 1.0.0）是 SkillHub community 来源的技能，分类为 dev-programming，由发布者 user_15292d5a 维护。官方简介说明：将自然语言转为 uml-diagrams.org 风格的 PlantUML 图，并在用户要求绘制 UML 时使用该 Skill。页面标签标明 requires_api_key=false，不依赖额外 API Key 配置。

核心功能¶

依据 SkillHub 页面与商店元数据，可核实的能力如下：

1. 图类型：支持序列图（sequence）、类图（class）、活动图（activity）、用例图（use case）、组件图（component）、状态图（state）等（简介中以省略号表示还可覆盖相近类型）。
2. 语法风格：生成代码对齐 uml-diagrams.org 所代表的常见 UML / PlantUML 表述习惯，便于与既有文档、示例对照。
3. 导出格式：可将图渲染为 SVG、PNG、PDF。
4. 触发方式：当用户在对话中提出绘制 UML 图的需求时，Agent 按 Skill 指引选用本技能完成生成与导出。

安装与启用¶

安装流程以 SkillHub 官方说明为准：先按 SkillHub 安装与优先源配置 准备 skillhub CLI，再把技能装到当前 Agent 能识别的 skills 目录（安装时必须使用 --dir，否则默认落在 ./skills/ 且可能不被识别）。

1、检查或安装 skillhub CLI¶

command -v skillhub && skillhub --version

若未安装，可使用官方脚本（完整安装含 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装 plantuml-skill¶

将 <skills 目录> 换成当前环境对应路径，例如 Cursor 为 ~/.cursor/skills/，Claude Code 为 ~/.claude/skills/，Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/（完整列表见安装文档第四节）。

skillhub install @user_15292d5a/yjkj-plantuml-skill --dir <skills 目录>

也可在支持 Skill 的客户端中，让 AI 按同一安装文档安装该坐标（SkillHub 页面提供的提示词即指向 https://skillhub.cn/install/skillhub.md 与 @user_15292d5a/yjkj-plantuml-skill）。

安装完成后，按所用客户端要求刷新或重启 Agent，使新 Skill 被加载。

典型用法¶

公开页面未附带固定示例仓库或脚本；用法与官方简介一致，可复现的交互方式如下：

1. 在已启用 plantuml-skill 的 Agent 对话中，明确说明要画的 UML 类型（如序列图、类图）以及 参与对象、消息或状态 等要点。
2. 说明是否需要 导出为 SVG、PNG 或 PDF（可多选其一）。
3. Agent 根据 Skill 生成 PlantUML 源码并完成渲染；你可在对话中要求调整元素命名或关系后再重新导出。

示例表述（仅说明输入形式，非官方固定模板）：

请用 plantuml-skill 画一张序列图：客户端调用 API 网关，网关再调用用户服务；最后导出 PNG。

适用场景与注意¶

适合谁：需要在文档、评审或沟通中快速产出标准 UML 图、又希望少手写 PlantUML 的开发者；希望输出风格贴近 uml-diagrams.org 常见示例的团队。

使用注意：

• 复杂图仍建议在生成后人工核对语义与布局；自然语言描述越具体，结果越稳定。
• 渲染依赖 Skill 内定义的流程与环境（如本地或内置 PlantUML 工具链）；若导出失败，应检查客户端是否允许执行 Skill 中的渲染步骤。
• SkillHub 元数据显示本技能 评分为 100000、下载 904 次、安装 0（统计随商店更新变化，写作时以页面为准）。

结尾¶

plantuml-skill 把「画 UML」收敛为对话内的一步：自然语言描述 → uml-diagrams.org 风格 PlantUML → SVG / PNG / PDF。需要安装或查看详情时，可打开 SkillHub 页面：

• 展示页：https://www.skillhub.cn/skills/user_15292d5a/yjkj-plantuml-skill
• API 坐标页：https://api.skillhub.cn/user_15292d5a/yjkj-plantuml-skill