案例 01 · 流程图 · 公开 Skill
把一段文字做成一张流程图
一段说清流程的文字,交给 AI 和一个公开 Skill,得到一个能打开的 HTML 文件,里面是一张流程图。这篇写了准备什么、怎么下指令、做完怎么判断算成功。
结果长这样
这是本轮实际生成的文件在浏览器里的截图,不是示意图,也不是仓库自带的示例图。手机上字小,点图可以看全尺寸。
1. 能帮谁解决什么问题
要把一段流程写成图、但不会画图也不会选工具的人。常见场景:活动报名怎么审核、客户询盘怎么转交、售后问题怎么分级。文字你已经有了,缺的是一张别人一眼能看懂的图。
这个案例解决的是其中一件事:一段带分支的文字,变成一张分支关系正确的流程图。它不解决排版美化,也不替你判断流程本身对不对。
2. 使用前提
- 在哪个应用里做:一个能读本地文件的 AI 编程工具。仓库写明支持 Claude Code、Codex、Cursor、GitHub Copilot、Gemini CLI 等。网页版聊天窗口装不了 Skill。
- 要装什么:一个 Skill。终端里运行
npx skills add cathrynlavery/diagram-design;这条命令需要本机已有 Node.js(node -v能显示版本号就是有)。 - 要花多少钱:不花钱。仓库是 MIT 许可,不收费用,也不需要账号或 API key。你用的 AI 工具本身如果收费,那是另一笔。
- 字体:这个 Skill 默认从 Google Fonts 取字体,国内经常打不开。它文档里留了「用系统字体」的开关,本轮就是按系统字体生成的——所以你这张图的样子会和我这张一致,但和仓库示例截图不完全一样。
- 产物:一个自包含的 HTML 文件,图是文件里的 SVG,不依赖外部图片,离线也能打开。
3. 输入材料
就用这一段,虚构的活动报名规则,四十来个字:
收到活动报名 → 检查信息是否完整。完整则发送确认通知,不完整则请报名者补充;补充后重新检查。
这段话里有 4 个环节、1 个判断、1 条回连:
| 原文 | 图里的节点 | 类型 |
|---|---|---|
| 收到活动报名 | 收到报名 | 起始(椭圆) |
| 检查信息是否完整 | 信息完整? | 判断(菱形,两个出口) |
| 完整则发送确认通知 | 发送确认通知 | 结束(椭圆) |
| 不完整则请报名者补充 | 请报名者补充 | 步骤(矩形) |
| 补充后重新检查 | 连线回到「信息完整?」 | 回连线 |
原文没写的环节一个都没加——没有截止时间、没有名额、没有通知方式。多画的每一笔,都是别人读图时的负担。
4. 操作步骤
- 在电脑上新建一个空文件夹,比如
flowchart-test。练手别放进有客户资料的目录。 - 装 Skill:终端运行
npx skills add cathrynlavery/diagram-design。Claude Code 用户可以改用/plugin marketplace add cathrynlavery/diagram-design,再/plugin install diagram-design@diagram-design。装好后你的 AI 工具里应该能看到 diagram-design。 - 先单独说一句环境要求:「用系统字体,不要引 Google Fonts,输出一个自包含的 HTML。」 国内常加载不到 Google 字体,先说省得返工。
- 把下一节那段「可复制的任务描述」整段粘过去。
- 它会先给一份结构:几个节点、几条线、每个节点写什么。这时候对照第 3 节的表核一遍,有没有多出来或漏掉的环节。
- 结构对了,再让它生成文件。文件夹里会出现一个
.html。 - 双击用浏览器打开,再刷新一次,确认能打开、图完整。
- 有条件的话跑仓库自带的两项检查(见「验收」),比自己看着顺眼可靠。
5. 可复制的任务描述
请根据下面这段文字生成一张流程图。要求: 1. 只画文字里写明的环节,不要添加原文没有的步骤(不要加截止时间、名额、通知方式、审核人)。 2. 「检查信息是否完整」画成判断,明确区分「完整」「不完整」两条分支,每条分支的箭头都要写标签。 3. 「完整」的走到「发送确认通知」并结束;「不完整」的走到「请报名者补充」。 4. 补充完成后,连线必须回到「检查信息是否完整」,不能直接结束。 5. 先只给结构:几个节点、几条连线、每个节点上写什么字。我确认后再生成文件。 6. 生成一个自包含的 HTML 文件,图用内联 SVG,不要外部图片,不要外部字体(用系统字体)。 7. 最后告诉我怎么在浏览器里打开它,以及怎么改节点文字。 文字: 收到活动报名 → 检查信息是否完整。完整则发送确认通知,不完整则请报名者补充;补充后重新检查。
6. 验收:怎么算做完了
别看“文件生成成功”就算完。要逐条对,下面每条都能自己看出结果:
| 检查项 | 怎么算通过 | 本轮实测 |
|---|---|---|
| 文字无误 | 节点文字和第 3 节的表一致,没有原文没说的环节 | 通过 |
| 分支正确 | 判断有两个出口,标签分别是「完整」「不完整」 | 通过 |
| 回连正确 | 「补充」那条线绕回判断,不是走到底就结束 | 通过 |
| 文字不出框 | 每个节点里的字都在框内,四周留白不少于 4px | 通过 13 处文字,0 处溢出 |
| 文件能打开 | 双击用浏览器打开,刷新后仍然正常,控制台没报错 | 通过 |
| 官方自检 | 仓库的 self_check.py 与 verify-geometry.py 都无报错 | 通过 0 问题 |
本轮没验证的,别当成已经通过:
npx skills add和/plugin安装命令没有实际执行(本轮没往电脑里新装东西)。安装这一步算未验证。- 在 Claude Code、Codex、Cursor 里能不能自动触发这个 Skill,没有试。本轮的图是把仓库文档的流程走了一遍,由 AI 助手在独立文件夹里生成,不是由这些客户端自动调起的。
- Windows 上没有试。中文系统字体在 Windows 上会换成微软雅黑,宽度略有差别,可能需要重新看一眼有没有出框。
7. 常见问题
- 怎么改节点上的字?
- 在
.html里搜索那句字(比如「请报名者补充」),直接替换成你要的,保存后刷新。12px 字号下一个汉字大约占 12px,200px 宽的框大概能放 16 个字,超了就会挤出来——要么删字,要么把框加宽。让 AI 改的时候说清楚「只改第 3 个节点的文字,不要动坐标」,否则它常会顺手把整张图重排。 - 怎么改方向?现在是上到下。
- 最稳的说法是让它重排:「改成从左到右的布局,判断的两个出口分别在上、下」。自己手动挪要同时改框的位置和连线的起止点,漏一个就错位。
- 安装失败看哪里?
- 先确认
node -v有没有版本号,没有就是没装 Node.js。然后对照仓库 README 的 Install 章节:Claude Code 走/plugin那两条,Codex 走codex plugin marketplace add,其他客户端用npx skills add。三条装的是同一套东西,能用哪条用哪条。 - 字很丑、跟网上的截图不一样。
- 多半是 Google Fonts 没加载到,退回了系统字体。这不是坏了,只是换了字体。想要那个样子就得能连上 Google Fonts。
- 手机上要左右拖动才能看全。
- 这是仓库的设定:图保持原宽度,容器自己横向滚动,避免整页被撑开。想一屏看全,让它出一个窄版(节点文字缩短)。
8. 来源和验证状态
- 官方仓库:github.com/cathrynlavery/diagram-design · MIT 许可 · 第三方开源项目,不是本站作品。
- 资料核对日期:2026-10-30。读了 README 的 Install 与 Quickstart、
SKILL.md、流程图类型说明、样式指南。 - 本轮验证:按文档流程生成实际文件,仓库自带两项检查通过,浏览器渲染逐条量过。详见上面的验收表。
- 本轮未验证:安装命令、各客户端的自动触发、Windows 表现。
9. 下一步
图和文字都对了,就可以把它放进你的方案、文章或说明书里。想找别的工具,回工具库搜。