excalidraw

# Excalidraw 子智能体委派 ## 概述 **核心原则：** 主智能体永远不要直接读取 Excalidraw 文件。始终委派给子智能体以隔离上下文消耗。 Excalidraw 文件是 JSON 格式，Token 成本高但信息密度低。单个文件在 4k-22k token 之间（最大的文件可能超过读取工具限制）。快速读取多个图表会迅速耗尽上下文预算（7 个文件 = 67k token = 预算的 33%）。 ## 问题所在 Excalidraw JSON 结构： - 每个形状有 20+ 属性（x, y, 宽度, 高度, 描边颜色, 种子, 版本等） - 大多数属性是视觉元数据（定位、样式、粗糙度） - 实际内容：文本标签和元素关系（文件内容的 <10%） - **信噪比极低** 示例：14 元素图表 = 596 行，16K，约 4k token。79 元素图表 = 2,916 行，88K，约 22k token（超过读取限制）。 ## 何时使用 **触发条件（满足其一即可）：** - 文件路径包含 `.excalidraw` 或 `.excalidraw.json` - 用户请求：“解释/更新/创建图表”、“展示架构”、“可视化流程” - 用户提到：“流程图”、“架构图”、“Excalidraw 文件” - 涉及视觉产物的架构/设计文档任务 **即使在以下情况也应使用委派：** - “小”文件（最小 4k token，依然显著） - “快速检查”（检查组件名称也会加载完整 JSON） - 单文件操作（隔离防止上下文污染） - 修改（主上下文不需要完全理解格式） ## 委派模式 ### 主智能体职责 **永远不要：** - ❌ 对 *.excalidraw 文件使用读取工具 - ❌ 在主上下文中解析 Excalidraw JSON - ❌ 加载多个图表进行比较 - ❌ 检查文件以“了解格式” **始终：** - ✅ 将所有 Excalidraw 操作委派给子智能体 - ✅ 为子智能体提供清晰的任务描述 - ✅ 请求纯文本摘要（而非原始 JSON） - ✅ 保持图表分析与主要工作隔离 ### 子智能体任务模板 #### 读取/理解操作 任务：提取并解释 [file.excalidraw.json] 中的组件 方法： 1. 读取 Excalidraw JSON 2. 仅提取文本元素（忽略定位/样式） 3. 识别组件之间的关系 4. 总结架构/流程 返回： - 组件/服务列表及描述 - 连接/依赖关系 - 关于架构的关键见解 - 不要返回原始 JSON 或冗长的元素细节 #### 修改操作 任务：添加 [component] 到 [file.excalidraw.json]