| name | workflow-diagram-skill |
| description | Use when 用户想用一句话生成流程图、工作流图解、开发流程图、AI 流程图或任何步骤型图解，支持多风格输出（flat icon / 暖白手账风 / dark / cute），并提供现成模板一键出图。 |
workflow-diagram-skill - 一句话生成流程图
核心原则：用户不需要描述节点和箭头，只需要说「画个 XXX 流程图」，skill 自动匹配模板或理解语义生成 SVG + PNG。
适用场景
- 开发/AI 工作流：vibe coding、Claude Code / Codex 开发流程、AI 学习路径、LLM 原理图
- 通用流程：入职、毕业、程序员上班、会议组织
- 学术/医疗：博士生研究流程、医学报告大会流程
- 内容创作：短剧 AI 视频制作、小红书起号流程
- 自定义流程：用户提供步骤，skill 生成图解
触发词
| 类型 | 示例 |
|---|
| 现成模板 | 画个 vibe coding 流程图、生成 Claude Code 开发流程图、短剧 AI 视频制作流程图 |
| 通用流程 | 画个入职流程图、毕业流程图、程序员上班流程图 |
| 自定义步骤 | 帮我画一个 XXX 的流程图，步骤是：A → B → C |
| 一句话生成 | 画一个 AI Agent 学习流程，我要找工作、帮我画程序员成长路径 |
| 风格切换 | 用草图风格、换成 dark 风格、扁平风格 |
| 风格切换 | 用 cute 风格、可爱风格、插画风格 |
🎨 可选风格（4 种）
直接说想要的风格即可切换：
| 风格 | 说明 | 适合 |
|---|
| flat (默认) | clean、圆角、蓝色箭头 | 文档/PPT |
| sketchy | 暖白手账风、铅笔灰边框 | 公众号/视频 |
| dark | 深色背景、高对比 | 技术博客/Github |
| cute | 马卡龙配色、圆润胶囊 | 小红书/知识付费 |
📌 快速切换：说「换成 cute 风格」「用 dark 风格」即可
📐 布局方式
| 布局 | 说明 | 适合 |
|---|
| vertical (默认) | 上下分阶段 | 步骤多/有分组 |
| horizontal | 左右横向 | 步骤少/线性流程 |
📌 切换：说「横向布局」「改成左右」即可
〰️ 箭头样式
| 箭头 | 说明 | 适合 |
|---|
| straight (默认) | 直线箭头 | 简洁/正式 |
| curved | 曲线箭头 | 柔和/活泼 |
📌 切换：说「用曲线箭头」「改成曲线」即可
📋 全部内置模板（25 个）
AI/开发（6个）
vibe-coding · claude-code · codex · ai-learning · llm-internals · rag-flow
学习流程（4个）
english-learning · finance-learning · coding-learning · exam-cert
日常流程（6个）
fitness-flow · morning-routine · house-buying · travel-flow · healthy-life · side-hustle
工作流程（4个）
onboarding · programmer-daily · meeting-flow · product-launch
学术/医疗（3个）
phd-research · graduation · medical-conference
内容创作（2个）
short-drama-ai-video · xiaohongshu-start
📌 直接说：「画个 vibe coding 流程图」「生成英语学习流程」「画一个副业赚钱流程」
🤖 推荐的模型/平台组合
| 场景 | 推荐组合 | 说明 |
|---|
| 快速原型 | Codex + Cursor | 在线沙盒，即开即用 |
| 本地开发 | Claude / Grok + VSCode | 完全离线，数据不外出 |
| 深度定制 | Claude + Windsurf | 超长上下文，适合大型项目 |
| 国内白嫖 | 通义千问 / DeepSeek + VSCode | 免费额度够用 |
| 全栈开发 | Claude + Cursor | 前端/后端/数据库一把梭 |
📌 画这类图：可以说「画个 Claude Code + Cursor 开发流程图」「画个 Codex 工作流」
🆕 自定义复杂流程
如果内置模板不满足需求，直接给步骤就能画。复制下面的格式修改：
画一个 [主题] 流程图，步骤是：
1. [步骤1]
2. [步骤2]
3. [步骤3]
4. [步骤4]
可选：换成 [sketchy/dark/cute] 风格
示例：
画一个 AI PPT 制作流程图，步骤是：
1. 主题确认
2. 大纲生成
3. 内容填充
4. AI 生图
5. 排版美化
6. 导出分享
用 cute 风格
📌 节点超过 8 个会自动分组，不用担心太乱
工作模式
A. 现成模板（一键出图）
- 提取用户话题关键词。
- 在
references/templates.md 中按 id / name / tags / category 模糊匹配。
- 命中模板后读取其
nodes 和 edges。
- 默认风格为
flat，用户可指定 sketchy / dark / cute。
- 调用
scripts/generate_diagram.py 生成 SVG，再调用 scripts/svg2png.py 渲染 PNG。
- 输出文件路径并展示 PNG。
B. 自定义流程（用户给步骤）
- 从用户输入中提取流程名称和步骤列表。
- 如果步骤 ≤8 个，直接按顺序垂直排列；如果步骤多，自动分组或换横向布局。
- 用户没说风格时默认
flat。
- 同样调用脚本生成 SVG + PNG。
C. 一句话智能生成（用户只给主题）
当用户只给一个模糊主题（如「学习 AI Agent」「如何应聘大厂」）时：
- 理解意图：分析用户的描述，提取核心需求
- 生成步骤：根据领域知识，自动推断合理的步骤结构
- 调用脚本：用生成的节点数据调用
generate_diagram.py
示例处理：
- 用户说「帮我画一个学习 AI Agent 和大模型的流程，要精细一点，要去应聘当牛马」
- Skill 自动分析：
- 主题：AI Agent + 大模型学习路径
- 受众：求职者（想去大厂）
- 自动生成：基础概念 → 机器学习 → 深度学习 → LLM → Agent 开发 → 项目实战 → 面试准备 → 大厂应聘
- 自动选择合适风格（默认 flat）
- 生成 SVG + PNG
📌 怎么说都行：
- 「画个 AI 学习流程，我要找工作」
- 「帮我画一个程序员成长路径」
- 「生成一个产品从 0 到 1 的流程图」
- 「画一个去大城市闯荡的流程」
C. 风格切换
flat： clean、圆角、实色图标、蓝色主流程箭头，适合文档/PPTsketchy： 暖白手账风、铅笔灰边框、手写字体，适合公众号/视频dark： 深色背景、高对比，适合技术博客/Githubcute：马卡龙配色、圆润胶囊节点、可爱描边图标，适合公众号/小红书/知识付费
输出规格
- SVG：矢量源文件，可二次编辑
- PNG：2x 分辨率，直接可用
- 默认保存到当前工作目录：
{topic}-diagram.svg 和 {topic}-diagram.png
- 节点标题 ≤6 字，副标题 ≤14 字，保证可读性
硬性规则
- 不要问用户「节点怎么连」，模板优先、语义推断兜底。
- 风格只在用户明确指定或上下文已提及时切换，默认
flat。
- 节点超过 8 个时必须分组（用虚线容器），禁止一条长流程塞到底。
- 必须同时输出 SVG 和 PNG，不能只输出一个。
- 生成后必须展示 PNG 并给出文件路径。
模板索引
现成模板定义在 references/templates.md，分类如下：
- AI/开发：vibe-coding、claude-code、codex、ai-learning、llm-internals、rag-flow
- 通用职场：onboarding、programmer-daily、meeting-flow
- 学术医疗：phd-research、graduation、medical-conference
- 内容创作：short-drama-ai-video、xiaohongshu-start
第三方依赖
- Python 3.10+
puppeteer-core（用于 PNG 渲染， skill 内 scripts/svg2png.py 已包含安装检测）- Microsoft Edge / Google Chrome（用于 headless 截图）
红线
- 不生成包含敏感信息、歧视、违法内容的图解。
- 不替代用户做专业决策（如医疗诊断流程仅作示意）。
- 不承诺图形美观度 100% 符合用户预期，但提供 SVG 源文件便于二次调整。
常见问题
Q：用户说「画个图」但没给主题怎么办？
A：列出 3-5 个热门模板让用户选，例如：vibe coding、入职流程、Claude Code 开发流程。
Q：没有匹配模板怎么办？
A：按用户描述抽取步骤生成通用流程图；如果描述不清，反问步骤。
Q：风格参数怎么传？
A：scripts/generate_diagram.py --style flat|sketchy|dark|cute --template vibe-coding -o output.svg
