Excalidraw Diagram Creator 是一个用于生成 .excalidraw JSON 文件的技能,其核心目标是让图表“进行视觉论证”,而不仅仅是展示信息。它适用于用户希望可视化工作流、架构或概念的场景。
用途 该技能用于创建 Excalidraw 图表 JSON 文件,使图表能够表达关系、因果与流程,而文字本身难以做到这一点。它强调图表的结构本身应承载含义。
主要能力
- 生成 .excalidraw JSON 文件。
- 提供设计方法论:同构测试(移除所有文字后结构是否仍能传达概念)与教育测试(观看者能否从图表中学到具体内容)。
- 支持简单/概念型图表与综合/技术型图表两种深度。
- 对技术图表要求先研究真实规范、数据格式、事件名、方法名或 API 端点,并使用真实术语而非通用占位符。
- 支持证据工件,包括代码片段、数据/JSON 示例、事件/步骤序列、UI 模拟、真实输入内容、API/方法名等。
- 采用多缩放层级架构:摘要流程、区块边界、区块内细节。
- 提供视觉模式库:扇出、汇聚、树、螺旋/循环、云、装配线、并排、间隔/断裂。
- 提供线条作为结构、形状含义、颜色含义与现代美学(roughness、strokeWidth)等指导。
使用方式
- 设置:如果用户要求设置该技能(渲染器、依赖等),参见 README.md。
- 自定义:所有颜色与品牌特定样式集中在 references/color-palette.md 中。生成任何图表前应先阅读该文件,并将其作为所有颜色选择的唯一来源,包括形状填充、描边、文字颜色、证据工件背景等。要让自己品牌风格生成图表,编辑 color-palette.md 即可。
- 设计流程:先评估所需深度;若为综合/技术型,先做研究;然后深入理解内容,将概念映射到视觉模式,确保多样性,勾勒流程,生成 JSON,最后必须运行渲染-查看-修复循环直到图表看起来正确。
- 大型/综合图表策略:必须按区块逐段构建 JSON,不要尝试一次性生成整个文件。分阶段进行:第一阶段逐区块构建,使用描述性字符串 ID,按区块命名空间化种子,随进度更新跨区块绑定;第二阶段审查整体,检查跨区块箭头绑定、间距平衡、ID 与绑定引用;第三阶段渲染与验证。
适用场景
- 可视化工作流、架构或概念。
- 解释心智模型或哲学(简单/概念型)。
- 图解真实系统、协议或架构,用于教学或解释(综合/技术型)。
- 展示多种技术如何集成。
限制
- 大型图表受输出 token 限制,必须分区块构建。
- 不要使用编码代理生成 JSON,也不要编写 Python 生成器脚本。
- 颜色不得自行发明,若概念不符合现有语义类别,使用 Primary/Neutral 或 Secondary。
- 默认不使用容器,仅当形状承载含义时才添加;目标为少于 30% 的文字元素位于容器内。
- 关于收费、价格、平台、效果等具体信息暂未提供。