Communitygithub.com

Zimzheng/prompt-to-canvas

将用户提供的内容转化为精美、可编辑的 Excalidraw 画布的 AI Agent 技能。

prompt-to-canvas 是什么?

该技能指导 AI Agent 将用户提供的内容(如文本、数据、概念等)直接转化为结构清晰、视觉精美的 Excalidraw 画布。它并非简单的图表生成器,而是通过内置的风格目录和设计规则,让 Agent 自主决定信息的核心论题、布局结构、层级关系、标签和连接线,从而创建信息图、架构图、时间线、仪表盘等专业视觉作品。技能支持在本地编辑器打开并编辑生成的画布,并允许用户选择或让 Agent 推荐视觉风格(如专业、活泼、大胆等)。整个过程包括理解用户意图、询问视觉偏好、选择风格、构建 SVG、转换为 Excalidraw 场景 JSON 并最终在本地打开,结果可导出为 PNG 或 SVG。该技能适用于 Claude Code、Cursor、Codex 等支持 AI Agent 的开发平台。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add Zimzheng/prompt-to-canvas

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

提示词到画布

一个设计系统技能,用于将用户提供的内容转化为精美、可编辑的 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/ 存在。

如果缺少任何内容,请告知用户缺少什么并停止。

如何执行对话

  1. 理解画布。 识别内容、目的和受众。如果信息模糊到足以影响最终产品,请在构建前提出一个简短的问题。
    • 当主机支持结构化或可选项时,使用它们。否则,以紧凑的文本形式提问。
    • 提供 2-3 个推断选项,将推荐的选项放在首位,并在提示已有足够上下文时,包含一个用用户语言表达的“由 Agent 选择”选项。
  2. 询问视觉感受。 询问视觉风格:安静、专业、活泼、大胆、品牌感、颜色偏好或氛围。如果用户没有偏好,则主动提出由 Agent 选择。如果用户已经指定了风格或明确的氛围,则跳过此步骤。
    • 当主机支持时,使用可选项。
    • 将选项映射到目录级别:克制、平衡或大胆。
  3. 选择风格。 使用 CATALOG.md 选择一个风格。仅从目录表中选择;不要比较多个 design.md 文件。用一行告诉用户选择的风格及其原因。
  4. 构建画布。 读取 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 编辑。
  1. 打开编辑器。 使用:
node scripts/open-editor.mjs --scene scene.json

每次调用都会启动一个独立的本地编辑器 URL。对于每个新画布、备选模板或重新生成的版本都这样做,而不是重复使用旧的 URL。默认情况下,脚本会前进到一个新的可用端口,并通过唯一的无缓存 URL 提供场景。当 open-editor.mjs 进程停止或主机会话结束时,该端口会被释放。

  1. 交付。 给用户打印的本地 URL。说明编辑器支持中文/英文界面切换、刷新安全的本机自动保存以及 PNG/SVG 导出。主动提议以另一种风格重新渲染相同的内容。

文件

冒烟测试

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

相关技能