FlowForge 是一个用于生成 draw.io 图表的技能，可将流程、结构或概念输出为专业的 draw.io XML 文件。它支持 13 种图表类型：flow、flow-vertical、compare、layers、loop、tree、hub、columns、matrix、funnel、timeline、sequence、swimlane。
用途与适用场景：用于绘制流程图、架构图、对比图等可视化需求。它可以处理直接给出的概念，也可以读取文档并识别其中适合配图的位置。示例用法包括 /FlowForge "OAuth 2.0 authorization code flow"、/FlowForge path/to/design-doc.md、/FlowForge "CI/CD pipeline" --type loop、/FlowForge "Monolith vs Microservices" --type compare --theme morandi、/FlowForge "System Architecture" --lang en。
使用方式：工作流包含五步。第一步理解与提议：若给的是文档，则完整阅读，找出 1 到 3 个适合配图的位置，记录插入位置、主题与推荐类型；若给的是概念，则确定核心信息并选择类型。随后提交一份合并提案并请求一次确认，提案包含图表类型与主题、ASCII 草图。若请求已明确指定类型与主题，或无人类可回应时，可跳过确认并使用默认值。第二步生成 draw.io XML：读取布局算法、应用主题颜色、使用元素模板。第三步校验：运行 python3 {skill_dir}/scripts/validate.py <file.drawio> --theme <theme>，检查 XML 格式、id 唯一性、箭头引用、边样式、画布边界、节点重叠、z 序、字体大小、文本适配估算与主题颜色合规，修复所有 ERROR。第四步视觉自检：若 draw.io CLI 可用则运行 bash {skill_dir}/scripts/render.sh <file.drawio> 导出 PNG 并检查。第五步保存与交付：保存 .drawio 文件，报告路径、打开方式。迭代时读取当前文件、按反馈修改、另存为 {name}_v2.drawio、重跑校验与渲染。
配置：可选 ./.flowforge.json，包含 defaultTheme、outputDir、language。默认 defaultTheme 为 tech-blue，可选主题包括 morandi、mint、terracotta、indigo。language 为 auto 时匹配用户语言，技术缩写保持英文。每次调用的 --theme、--lang 覆盖配置。
图表类型与选择：顺序步骤用 flow 或 flow-vertical；两个对象对比用 compare；3 个以上并列概念用 columns 或 hub；分层系统用 layers；迭代/循环用 loop；一个核心多个分支用 hub 或 tree；组件交互用 sequence；随时间变化用 timeline；多标准评估用 matrix；渐进筛选用 funnel；跨角色/系统步骤用 swimlane。
颜色与设计原则：每个主题有 4 个基础色和 6 个扩展色。3 到 5 个节点建议用 2 到 3 种颜色，6 到 8 个节点用 3 到 4 种，9 个以上用 4 到 5 种。主色应占主导，强调色最多 1 到 2 处。标题应使用叙事性标题，标签使用用户语言，技术缩写保持英文。节点间箭头使用 edgeStyle=orthogonalEdgeStyle。
常见问题：富节点标题重复、箭头忽略出入点、value 属性中的 HTML 实体、填充框在子元素之后绘制导致遮挡、画布过小、遗漏 parent="1"、菱形文本溢出、蛇形布局换行箭头、循环返回箭头穿过中心、宽度计算差一、分支/合并箭头斜向。
支持文件与示例：references/layouts.md 提供全局常量与 13 种布局算法；themes.md 提供 5 个主题、10 种语义色、7 种文本色与色彩节奏示例；xml-reference.md 提供画布样板、元素模板与箭头方向表；examples.md 提供坐标计算与示例索引；scripts/validate.py 用于校验；scripts/render.sh 用于导出 PNG。示例 .drawio 文件包括 flow-cicd.drawio、compare-monolith-vs-micro.drawio、loop-ml-training.drawio、tree-storage-decision.drawio、hub-agent-capabilities.drawio、timeline-llm-history.drawio。