前言¶
在做系统设计或技术方案时，最常见的问题之一就是：用户只说一句“帮我画个架构图”，却不知道该用什么工具、在哪打开，甚至不知道如何导出为可编辑的格式。很多时候，我们只能手动在 Visio、draw.io 或其他工具里画一个粗糙的草图，既费时又难以维护。
ascii-drawio 是一个可以在命令行直接生成专业技术架构图的 Skill，它将自然语言描述的图表需求转换为 draw.io XML 格式，并在当前工作目录保存为 .drawio 文件。对于需要快速输出可编辑架构图、或者习惯在终端完成所有设计工作的开发者来说，这是一个能直接落地的工具。
这是什么¶
ascii-drawio 是一个由社区维护的 Skill，用于将技术架构图、流程图、拓扑图等可视化需求转换为 draw.io 可编辑文件。它基于通用 SKILL.md 格式，运行在支持该格式的客户端（如 Cursor、Claude Code 等）中。
核心功能¶
- 输出为 draw.io XML 格式：生成的文件可直接用 draw.io 打开并继续编辑。
- 支持多种图表类型：
- 技术架构图
- 流程图
- 泳道图
- 鱼骨图
- 实体关系图（ER 图）
- 序列图
- 拓扑地图
- 思维导图
- 其他系统/架构可视化需求
- 保存到当前工作目录：文件以 .drawio 为扩展名。
安装与启用¶
Skill 由社区贡献，无官方安装包。在支持通用 SKILL.md 格式的客户端中，通常通过以下方式启用：
- 从官方地址获取 SKILL.md 文件：
curl -O https://api.skillhub.cn/user_66d13c7c/ascii-drawio
-
将 SKILL.md 放入客户端的 skills 目录（路径视客户端而定，例如 Cursor 为 ~/.cursor/skills 或 ~/.cursor/extensions）。
-
重启客户端或重新加载技能列表，使其生效。
注意：此 Skill 不需要 API Key，标签为 requires_api_key=false。
典型用法¶
在支持该 Skill 的对话界面中，直接用自然语言描述图表需求即可。例如：
- “画一个电商系统的技术架构图，包含网关、微服务、数据库和缓存层”
- “帮我画一个用户登录流程的泳道图”
- “生成一个微服务拓扑地图”
Skill 会根据描述生成对应的 draw.io XML 文件，并保存到当前工作目录。
适用场景与注意¶
适合以下场景：
- 需要快速输出可编辑架构图的设计阶段
- 习惯在终端/对话中完成设计工作的开发者
- 需要将图表导出为 draw.io 格式以便后续编辑的场景
注意：
- 仅在用户明确要求绘制图表时触发，不要在只涉及文本编辑的需求上使用。
- 生成的文件依赖 draw.io 进行查看和编辑，确保本地或云端有可用的 draw.io 环境。
短结尾¶
ascii-drawio 让你无需离开命令行就能生成可编辑的架构图，适合需要快速输出专业图表的开发者。官方地址：https://api.skillhub.cn/user_66d13c7c/ascii-drawio
