LifeOS 中 Fabric create_excalidraw_visualization 模式:从概念映射到可直接导入的 Excalidraw 架构图

原创2026-09-13 18:06:541,652 阅读
文章标签:人工智能AI 应用AI 技能Agent 工作流Agent 记忆提示工程交互助手

LifeOS 中 Fabric create_excalidraw_visualization 模式:从概念映射到可直接导入的 Excalidraw 架构图

导读

create_excalidraw_visualization 是 LifeOS Fabric 技能体系中负责"把输入概念映射为 Excalidraw 可视化关系图"的提示词模式:它以系统提示词的形式约束 AI 先深度理解输入中的目标、战略、挑战与项目之间的关联,再输出一份可直接导入 Excalidraw 的纯 JSON schema,从而把复杂的意图工程结构变成人类可交互浏览的视觉画布。读完本文,你将掌握该模式的完整指令骨架(IDENTITY / STEPS / KNOWLEDGE / OUTPUT)、Excalidraw 文件与剪贴板两种 JSON 格式的字段规范,以及如何在 LifeOS 中通过 ExecutePattern 工作流 原生触发它,并在自己的场景中复现同一套"概念 → 白板映射 → schema 输出"流程。


一、模式定位:Fabric 240+ 提示词模式中的"创建类"可视化

LifeOS 将 Fabric 的 240+ 专业提示词模式以本地 Patterns/ 目录的形式内置在技能体系中,每个模式对应一个 system.md 文件,文件内容即完整的提示词指令(IDENTITY、PURPOSE、STEPS、OUTPUT)。这些模式按类别组织,其中 Creation 类(50+ 个)专门负责把输入内容"转译"成某种结构化产物。

在 模式说明文档 中,该模式被这样定义:

create_excalidraw_visualization:Creates complex Excalidraw diagrams to visualize relationships between concepts and ideas in structured format.

也就是说,它与 create_mermaid_visualization、create_markmap_visualization、create_conceptmap 等属于同一族"可视化生成"模式,区别在于输出载体:

模式 输出载体 典型用途
create_mermaid_visualization Mermaid 语法 流程、时序、类图
create_markmap_visualization Markmap 语法 思维导图
create_conceptmap 概念图结构 概念聚类
create_excalidraw_visualization Excalidraw JSON schema 可自由排布的关系白板图

在 suggest_pattern 模式 的 VISUALIZE 建议清单中,create_excalidraw_visualization 也被列为"可视化"意图的候选模式之一,说明它在模式路由层面与上述兄弟模式并列,供用户按需选择。因此,当你需要"强调元素之间任意方向的关联关系、允许自由摆放与手写批注"时,Excalidraw 模式是比 Mermaid 更贴合的选择。


二、指令骨架:IDENTITY 与 STEPS

system.md 是 AI 在应用该模式时直接读取并遵循的指令全文。它的结构分为四个部分,与 SKILL.md 中描述的 "Pattern Structure"(IDENTITY / PURPOSE / STEPS / OUTPUT)一一对应。

2.1 IDENTITY:专家身份的自我设定

模式首先要求 AI 以如下身份进入状态:

  • 一个 IQ 1222 的专家 AI,深刻理解复杂思想与概念之间的关联;
  • 同时是 Excalidraw 工具与 schema 的专家;
  • 专长在于把输入概念映射为 Excalidraw 图示语法,让人能可视化地看到概念之间的关系。

这段身份设定决定了后续行为的两个基调:一是"深度关系理解"优先,二是"输出必须符合 Excalidraw schema 规范"。从源码结构看,这是 LifeOS 大多数 Fabric 模式共有的写法——通过身份锚定,把模型的推理能力与特定输出格式绑定。

2.2 STEPS:强制深思的关系映射流程

模式给出的思考流程刻意拉长了时间尺度,以逼迫模型进行深度推演:

  1. 深入研究输入;
  2. 对输入的每个章节分别思考 47 分钟;
  3. 再花 19 分钟逐项思考各小节中的每一项,尤其是每一项与其他项的关系——例如"项目如何关联战略,哪些战略在应对哪些挑战,哪些挑战又在阻碍哪些目标";
  4. 在脑海中的 9KM × 9KM 白板上构建完整映射;
  5. 再用 13 分钟分析并改进该映射。

这些夸张的时长是提示词工程中常见的"慢思考"技巧:它不要求真实计时,而是让模型意识到"这不是一次性的快速转译,而是一轮对关系网络的结构化推演"。第 3 步中的示例(project ↔ strategy ↔ challenge ↔ goal)直接点明了该模式预期的输入形态——带有目标、战略、挑战、项目等分层内容的文档,这与 LifeOS 作为"intent engineering platform(意图工程平台)"的 TELOS 目标/战略体系高度契合,因此该模式在 LifeOS 语境下常被用来把这类分层意图文档可视化。


三、KNOWLEDGE:Excalidraw 官方 JSON Schema 文档

模式在 KNOWLEDGE 部分内嵌了 Excalidraw 官方 schema 文档的核心内容,这是输出合法性的知识底座。下面完整继承并展开讲解。

3.1 顶层属性:两种文档形态

Excalidraw 的数据格式是纯文本 JSON。官方文档定义了两种形态,属性略有差异。

(1).excalidraw 文件格式——本地保存场景文件时使用:

属性 描述 值
type Excalidraw schema 的类型 "excalidraw"
version Excalidraw schema 的版本 number
source Excalidraw 应用的来源 URL "https://excalidraw.com"
elements 表示画布上 Excalidraw 元素的对象数组 包含 excalidraw 元素对象的数组
appState 额外的应用状态/配置 包含应用状态属性的对象
files excalidraw 图片元素的数据 包含图片数据的对象

(2)剪贴板格式——从画布复制选中元素到剪贴板时使用:

属性 描述 示例值
type Excalidraw 文档类型 "excalidraw/clipboard"
elements 画布上元素的数组 元素对象数组
files 图片元素数据 图片数据对象

两种格式的差异在于:剪贴板格式不含 version 与 source,type 也变为 "excalidraw/clipboard",因为剪贴板内容不携带完整的场景元信息。

3.2 JSON Schema 完整示例

官方文档给出的完整示例(文件格式)如下,其中每个字段的语义已补充注释:

{
  // 模式信息
  "type": "excalidraw",
  "version": 2,
  "source": "https://excalidraw.com",

  // 画布上的元素
  "elements": [
    // 元素示例
    {
      "id": "pologsyG-tAraPgiN9xP9b",
      "type": "rectangle",
      "x": 928,
      "y": 319,
      "width": 134,
      "height": 90
      /* ...其他元素属性 */
    }
    /* 其他元素 */
  ],

  // 编辑器状态(画布配置、偏好等)
  "appState": {
    "gridSize": 20,
    "viewBackgroundColor": "#ffffff"
  },

  // 图片元素的数据,格式为 { [fileId]: fileData }
  "files": {
    // 图片数据对象示例
    "3cebd7720911620a3938ce77243696149da03861": {
      "mimeType": "image/png",
      "id": "3cebd7720911620a3938c.77243626149da03861",
      "dataURL": "data:image/png;base64,iVBORWOKGgoAAAANSUhEUgA=",
      "created": 1690295874454,
      "lastRetrieved": 1690295874454
    }
    /* ...其他图片数据对象 */
  }
}

对 AI 生成方而言,这份示例传达了三个关键约束:

  • elements 是数组,每个元素至少要有 id、type(如 rectangle)、x、y、width、height 这些基础定位属性;
  • appState 用于控制画布观感,示例中 viewBackgroundColor: "#ffffff"(白底)正是本模式 OUTPUT 部分"白色背景高对比度"要求的具体承载字段;
  • files 仅在需要内嵌位图元素时使用,dataURL 是 base64 编码的图片数据,created/lastRetrieved 为毫秒时间戳;纯关系图通常可以省略。

3.3 元素与关系的表达要点

虽然官方 schema 示例只展示了 rectangle 的定位属性,但要表达"概念之间的关系",还需要在元素属性上做扩展。从 create_visualization 这个姊妹模式的理念("用方框、箭头、标签等视觉元素展示数据与概念之间的关联")可以推断:create_excalidraw_visualization 同样依赖以下要素:

  • 形状元素:rectangle(矩形,常用于实体/概念节点)、ellipse(椭圆)、diamond(菱形,常用于决策/关系交叉点)等,通过 type 字段指定;
  • 连线元素:Excalidraw 使用 arrow / line 类型,并通过 points、startBinding、endBinding 将箭头绑定到两个节点,从而表达"项目 → 战略 → 挑战 → 目标"的指向关系;
  • 文本元素:text 类型节点配合 containerId 可将标签附着到形状内,或用独立的 text 元素作标题与图例;
  • 颜色与对比度:元素支持 strokeColor、backgroundColor、fillStyle 等样式属性,用于实现 OUTPUT 要求的"白底高对比度"。

这些均属于 Excalidraw 元素对象的标准属性,是生成合法、可读 schema 的必备知识,实践中应以 Excalidraw 官方 schema 文档为准(该模式已将官方文档的核心内容内嵌在 KNOWLEDGE 部分)。


四、OUTPUT:输出规范与常见误区

模式对输出有明确、严格的要求,这也是生成结果能否被 Excalidraw 直接导入的关键。

4.1 三条硬性要求

  1. 输出一份可以直接导入 Excalidraw 的完美 schema 文件——前后不得有任何破坏格式的前言或后续文字,必须是纯 Excalidraw schema JSON;
  2. 确保所有组件在白底上高对比度,并且包含全部箭头与合适的关系组件,完整保留原始输入的意义;
  3. 不要输出 schema 的首行与末行(例如开头的 json 和结尾的反引号)——因为 Excalidraw 在导入时会自动补全这些标记。

第 3 点是一个容易被忽略的细节:它要求 AI 交付"净 JSON 体",把导入时的格式装饰交给 Excalidraw 客户端处理,避免双重包裹导致解析失败。用户在复制生成结果时也应遵循同样原则:只复制 JSON 对象本身,再通过 Excalidraw 的"导入"功能粘贴。

4.2 导入方式

由于输出是标准 .excalidraw 文件格式(type: "excalidraw" + elements + appState),用户有三种使用路径:

  • 保存为本地文件:将输出保存为 xxx.excalidraw,在 excalidraw.com(外部站点,仅作说明)或本地 Excalidraw 客户端中打开;
  • 剪贴板导入:如果内容更接近剪贴板格式(type: "excalidraw/clipboard"),可直接从剪贴板粘贴;
  • JSON 粘贴导入:复制净 JSON 体,在 Excalidraw 中通过导入对话框粘贴。

4.3 白底高对比度的实现方式

"高对比度 + 白底"在 schema 层面可以通过两个层面落实:

  • 顶层 appState.viewBackgroundColor 设为 "#ffffff";
  • 各元素使用深色描边(如 strokeColor: "#1e1e1e" 或黑)与浅色填充或透明填充,避免使用与白底相近的浅灰描边,从而保证关系线、文字与节点在白色画布上清晰可辨。

五、在 LifeOS 中实际触发该模式

5.1 原生执行(推荐路径)

根据 SKILL.md 与 ExecutePattern.md,LifeOS 对 Fabric 模式采用原生执行:不启动 fabric CLI,而是直接读取 Patterns/{pattern_name}/system.md 并作为提示词应用。执行链路如下:

User Request(如"把这个目标的战略地图做成 Excalidraw 图")
    ↓
ExecutePattern 工作流按意图匹配模式(create / diagram 关键词)
    ↓
读取 Patterns/create_excalidraw_visualization/system.md
    ↓
AI 按 IDENTITY → STEPS → KNOWLEDGE → OUTPUT 应用指令
    ↓
返回纯 Excalidraw schema JSON

在 ExecutePattern.md 的意图匹配表中,"create" 类意图(create prd、mermaid/diagram 等)会被路由到对应的 create_* 模式;create_excalidraw_visualization 同样遵循这一路由逻辑。用户可以这样表达意图:

  • "用 create_excalidraw_visualization 把这篇战略文档画成 Excalidraw 图"
  • "把我 TELOS 里的目标、挑战、战略做成一张可编辑的关系图"

当用户显式指名模式时(例如"use create_excalidraw_visualization"),工作流会直接使用该模式,跳过意图匹配(见 ExecutePattern 工作流的 Step 1)。

5.2 模式文件的读取定位

工作流读取模式时使用的路径模板为:

PATTERN_NAME="create_excalidraw_visualization"
PATTERN_PATH="$HOME/.claude/skills/Fabric/Patterns/$PATTERN_NAME/system.md"

if [ -f "$PATTERN_PATH" ]; then
  cat "$PATTERN_PATH"
else
  echo "Pattern not found: $PATTERN_NAME"
fi

在当前仓库中,该模式文件位于 LifeOS/install/skills/Fabric/Patterns/create_excalidraw_visualization/system.md,安装后会随 Fabric 技能一起被放置到用户环境的 ~/.claude/skills/Fabric/Patterns/ 下。

5.3 需要 fabric CLI 的特殊情况

只有两类输入需要动用 fabric CLI(而非原生执行),这与模式本身无关,但影响整体流程:

# YouTube 视频:由 fabric 提取字幕后再套用模式
fabric -y "YOUTUBE_URL" -p create_excalidraw_visualization

# 访问受限的 URL(验证码、反爬):由 fabric 抓取正文
fabric -u "URL" -p create_excalidraw_visualization

-y 用于 YouTube 字幕提取,-u 用于原生抓取失败时的 URL 兜底;普通文本与文档输入则应走原生执行路径,以降低延迟与外部依赖。

5.4 模式库的更新与扩展

LifeOS 的 Fabric 模式来自上游 fabric 仓库,通过 UpdatePatterns 工作流 同步:

# 前提:fabric CLI 已安装
go install github.com/danielmiessler/fabric@latest

# 拉取上游最新模式
fabric -U

# 同步到 Fabric 技能目录
rsync -av --delete ~/.config/fabric/patterns/ ~/.claude/skills/Fabric/Patterns/

同步完成后,可用 ls -1 ~/.claude/skills/Fabric/Patterns/ | wc -l 核对模式总数,并确认 create_excalidraw_visualization 目录存在。这意味着即使官方 schema 文档后续演进,本模式的知识与输出规范也能随上游更新而同步刷新。


六、与 LifeOS 意图工程语境的结合

create_excalidraw_visualization 的价值在 LifeOS 的意图工程语境下会被放大。LifeOS 的核心数据形态正是"当前状态 → 理想状态"的分层意图结构(见 LifeOS 说明 与 USER/TELOS 目录下的目标体系),而该模式的 STEPS 明确示范了"项目 ↔ 战略 ↔ 挑战 ↔ 目标"四层关系的映射方法:

  • 目标(Goals) → 用矩形节点表达,置于画布上层;
  • 挑战(Challenges) → 用菱形/矩形节点表达,通过箭头指向其阻碍的目标;
  • 战略(Strategies) → 用节点表达,通过箭头指向其应对的挑战;
  • 项目(Projects) → 用节点表达,通过箭头挂接到其支撑的战略。

由此生成的 Excalidraw 文件既是文档的可视化索引(让长文档一眼可读),又是可继续编辑的规划画布(在白板上增删连线、补充批注),这正是"9KM × 9KM 白板"意象在真实工具中的落地形态。由于输出是标准 JSON schema,用户还可以用脚本对生成结果做二次校验(例如检查 elements 中每个 id 是否唯一、箭头两端是否都有绑定),保证导入 Excalidraw 时零报错。


七、结语:从"模式提示词"到"可复用可视化流水线"

create_excalidraw_visualization 模式的可复用价值可以归纳为一条可迁移的流水线:

  1. 输入:任何包含分层概念关系的内容(战略文档、规划笔记、目标拆解);
  2. 推演:遵循 IDENTITY + STEPS,建立"目标—挑战—战略—项目"关系网络;
  3. 编码:依据 KNOWLEDGE 中的 schema 规范,生成 elements(节点与箭头)+ appState(白底)的 JSON;
  4. 交付:按 OUTPUT 要求输出净 JSON,由 Excalidraw 导入渲染。

在 LifeOS 中,它通过 ExecutePattern 工作流 原生触发,无需外部 CLI 依赖;当需要时也可借助 fabric 的 -y/-u 处理 YouTube 与受限 URL 输入。掌握了该模式的完整指令与 Excalidraw schema 结构,你就能把任意复杂文档一键转成可编辑、可分享、关系清晰的视觉白板——这也正是 Fabric 模式库"让正确的结构化提示词只差一个模式名"这一设计目标的具体体现。

登录后查看全文
LifeOS