提示词到画布
一个设计系统技能,用于将用户提供的内容转化为精美、可编辑的 Excalidraw 画布。 Agent 负责布局设计,使用内置风格目录指导视觉方向,构建 SVG 源代码,将其转换为可编辑的 Excalidraw 场景 JSON,并在本地编辑器中打开。
这不是一个自动图表生成器或模板填充工具。风格提供调色板和氛围;Agent 决定内容主题、结构、分组、层级、标签和连接线。
除非用户明确要求使用其他语言,否则在画布上的可见文本(包括标题、章节标签、注释和说明)应使用用户的主要交互语言。保留技术术语、产品名称、API 名称、缩写、代码标识符、指标和带引号的来源短语的原语言,以保持清晰。
何时使用
- 用户想要一个可编辑的画布、信息图、图表、架构图、时间线、对比图、仪表盘、概念图或演示文稿级的视觉作品。
- 用户提供了内容并要求“画出来”、“可视化”、“做成画布”、“做一个作品集板块”,或直接命名此技能。
- 结果应该是精美、可编辑、可导出且具有视觉风格的。
第 0 步:前提条件
运行 scripts/preflight.sh,或手动检查:
- Node 20 或更新版本。
assets/editor/index.html存在。scripts/svg-to-scene.mjs、scripts/validate-scene.mjs和scripts/open-editor.mjs存在。CATALOG.md、RULES.md、templates/和assets/styles/存在。
如果缺少任何内容,请告知用户缺少什么并停止。
如何执行对话
- 理解画布。 识别内容、目的和受众。如果信息模糊到足以影响最终产品,请在构建前提出一个简短的问题。
- 当主机支持结构化或可选项时,使用它们。否则,以紧凑的文本形式提问。
- 提供 2-3 个推断选项,将推荐的选项放在首位,并在提示已有足够上下文时,包含一个用用户语言表达的“由 Agent 选择”选项。
- 询问视觉感受。 询问视觉风格:安静、专业、活泼、大胆、品牌感、颜色偏好或氛围。如果用户没有偏好,则主动提出由 Agent 选择。如果用户已经指定了风格或明确的氛围,则跳过此步骤。
- 当主机支持时,使用可选项。
- 将选项映射到目录级别:克制、平衡或大胆。
- 选择风格。 使用
CATALOG.md选择一个风格。仅从目录表中选择;不要比较多个design.md文件。用一行告诉用户选择的风格及其原因。 - 构建画布。 读取
RULES.md、rules/canvas-rules.md、rules/visualization-strategy.md以及仅选定的templates/<slug>/design.md,然后:- 使用
rules/analysis-prompt.md作为私有的编辑检查清单:确定受众、作品用途、核心论点、关键实体、关系、权衡以及 3-6 个值得在画布上突出的主张。 - 画布上的可见文本(包括标题、章节标签、注释和说明)应与用户的主要交互语言匹配,除非用户另有要求。技术术语、产品名称、API 名称、缩写、代码标识符、指标和带引号的来源短语可在更清晰的情况下保留原语言。
- 首先在约 1600-1700px 宽的逻辑空间内组合
diagram.svg。使用原生 SVG 形状:rect、circle、ellipse、line、polyline和text。确保每个可见标签都是文本。 - 保持 Excalidraw 无限画布背景为白色。如果所选风格包含彩色纸张/背景,则将其绘制为场景内的可编辑矩形;切勿将该颜色放入
appState.viewBackgroundColor中。 - 保持风格选择独立于 Excalidraw 画布背景。根据内容、受众、正式程度和氛围选择风格;模板纸张/背景颜色作为视觉作品的一部分,作为场景内的可编辑矩形保留。
- 仅将完成的作品内容放置在画布上。关于提示、来源、文件路径、所选风格或流程的上下文信息应放置在聊天回复中。
- 将所选风格作为视觉系统应用:调色板、密度、笔画、拐角处理、层级、重点纪律和布局氛围。
- 将 SVG 转换为可编辑的 Excalidraw 场景 JSON:
- 使用
node scripts/svg-to-scene.mjs --svg diagram.svg --out scene.json
- 验证场景:
node scripts/validate-scene.mjs --scene scene.json
当存在明确的语言/文字预期时,也进行验证:
node scripts/validate-scene.mjs --scene scene.json --expected-language <language-code>
- 检查打开的编辑器或渲染的导出。修复文本裁剪、间距过紧、层级弱化、意外重叠、陈旧的示例文本以及风格漂移。优先修复
diagram.svg并重新转换;仅对 Excalidraw 特定的清理使用场景 JSON 编辑。
- 打开编辑器。 使用:
node scripts/open-editor.mjs --scene scene.json
每次调用都会启动一个独立的本地编辑器 URL。对于每个新画布、备选模板或重新生成的版本都这样做,而不是重复使用旧的 URL。默认情况下,脚本会前进到一个新的可用端口,并通过唯一的无缓存 URL 提供场景。当 open-editor.mjs 进程停止或主机会话结束时,该端口会被释放。
- 交付。 给用户打印的本地 URL。说明编辑器支持中文/英文界面切换、刷新安全的本机自动保存以及 PNG/SVG 导出。主动提议以另一种风格重新渲染相同的内容。
文件
CATALOG.md:35 种风格,包含氛围、正式程度和调色板签名。RULES.md:风格系统共享的 SVG 媒体规则。templates/<slug>/design.md:每种风格的一个调色板和氛围指南。assets/styles/:风格预览图片。rules/analysis-prompt.md:私有的内容塑造检查清单。rules/canvas-rules.md:Excalidraw 场景和验证规则。rules/visualization-strategy.md:布局和风格保真度指导。scripts/preflight.sh:依赖项和资源检查。scripts/svg-to-scene.mjs:SVG 到可编辑 Excalidraw 的转换器。scripts/validate-scene.mjs:场景模式验证器。scripts/open-editor.mjs:本地编辑器服务器和场景加载器。默认情况下,它为单独的生成分配一个新的端口。
冒烟测试
scripts/preflight.sh
node scripts/svg-to-scene.mjs --svg test-diagram.svg --out test-scene.json
node scripts/validate-scene.mjs --scene test-scene.json
node scripts/open-editor.mjs --scene test-scene.json --no-open