前言¶
在文档、评审或方案里补一张架构图、流程图，常见做法是手开 draw.io 或 Mermaid 写一版，再和 AI 来回改文案。图在对话里以代码块或截图出现时，后续改版往往要重新排版，也不方便直接交给同事在 draw.io 里改。
下面介绍 SkillHub 上的 please-drawio-turn（坐标 @user_800d68d6/drawiodo，当前版本 2.6.1）。它在用户提出「画图」类需求时介入，产出 .drawio 文件并配合 draw.io 打开，并带有思考、确认、迭代与版本回溯相关的工作流说明，以及 8 个 Hook Point 安全校验（以 Skill 自带说明为准）。
这是什么¶
please-drawio-turn 是面向 design-media 分类的社区 Skill，发布者为 user_800d68d6，来源标注为 community。SkillHub 页面标明 requires_api_key=false，即不依赖额外 API Key 配置项。
一句话定位：当对话里出现画图、生成图表、架构图、流程图、UML、ER 图、时序图、思维导图等意图时触发，由 Agent 按 Skill 指引生成 draw.io 可编辑文件，而不是只输出一张静态图或一段无法直接打开的伪代码。
核心功能¶
以下能力均来自 SkillHub 官方简介与页面描述，未单独核实的细节不展开。
- 触发范围：画图、图表、架构图、流程图、UML、ER 图、时序图、思维导图等自然语言需求。
- 交付物：生成
.drawio文件，并用 draw.io 打开（本机需已安装或可访问 draw.io 桌面版 / 配套打开方式，具体以 Skill 内步骤为准）。 - 工作流：支持 思考 → 确认 → 迭代 → 版本回溯 的完整流程，适合先对齐结构再改细节。
- 安全校验：内置 8 个 Hook Point 安全校验，在 Skill 执行链路上做约束（具体校验项以 Skill 文档为准）。
SkillHub 统计（以页面抓取为准）：评分 100000，下载 1709 次。
安装与启用¶
安装方式遵循 SkillHub 通用说明：skillhub.cn/install/skillhub.md。官方页面给出的安装提示为：根据该文档安装 @user_800d68d6/drawiodo。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 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、安装 please-drawio-turn 到当前 Agent 的 skills 目录¶
SkillHub 要求安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。
skillhub install user_800d68d6/drawiodo --dir <你的 skills 目录>
常见客户端路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在 Cursor 中示例：
skillhub install user_800d68d6/drawiodo --dir ~/.cursor/skills/
安装后按你所用客户端的要求刷新或重启 Agent，使 Skill 被加载。本 Skill 无需配置 API Key（requires_api_key=false）。
典型用法¶
官方页面未附带独立「示例项目」仓库；可复现的用法即：在已启用该 Skill 的对话里，用自然语言描述图类型与内容，由 Agent 按 SKILL 流程生成文件并打开。
可参考的提示方向（与官方触发描述一致）：
- 「画一张微服务架构图，包含网关、三个业务服务和 Redis。」
- 「用流程图描述用户注册：校验 → 写库 → 发邮件。」
- 「画 ER 图：用户、订单、商品三表及外键关系。」
- 「时序图：客户端、API、数据库在一次查询中的交互。」
经过上面的步骤，Agent 应走 思考与确认 后再落盘 .drawio；若结果不符预期，在同一对话中要求迭代，并依赖 Skill 提供的 版本回溯 能力回到较早版本（具体命令或话术以 Skill 内说明为准）。
适用场景与注意¶
适合谁：需要在方案、设计评审、技术文档里频繁出图，且希望交付物是 draw.io 原生格式、方便人工微调的团队或个人。
限制与注意：
- 依赖本机 draw.io 或 Skill 指定的打开方式；纯 Web Agent 环境若无法写本地文件或调起应用，体验会受限。
- 图为 Agent 生成，复杂版式、企业视觉规范仍需人工在 draw.io 中调整。
- 安全相关行为以 8 个 Hook Point 为准，若企业有合规要求，安装前建议在 SkillHub 页面阅读完整 Skill 说明。
- 版本以 SkillHub 为准，撰写时页面版本为 2.6.1；升级可用
skillhub的更新能力并仍指定正确的--dir。
结尾¶
please-drawio-turn 把「对话里要一张图」收敛为 可编辑的 .drawio 交付，并强调确认、迭代与回溯，适合不想在 Mermaid 与手绘之间反复切换的场景。
官方入口：
