涉及 Excalidraw/架构图/流程图时…

只要任务涉及 `.excalidraw`/`.excalidraw.json`、图表/流程图/架构可视化，就把所有 Excalidraw 读取、解析、修改、创建、比较操作交给子代理，只接收文本摘要。

适用场景

解决思路

1. 触发条件：文件路径包含 `.excalidraw` 或 `.excalidraw.json`；用户要求解释/更新/创建图表、展示架构、可视化流程；用户提到 flowchart、architecture diagram、Excalidraw file；或架构/设计文档任务涉及可视化工件时，启动本做法。
2. 即使面对“小”文件、快速检查、单文件操作或修改任务，也按委派处理；不要用文件大小或“只看看”作为直接读取的理由。
3. 主 agent 绝不使用 Read 工具读取 `*.excalidraw` 文件。
4. 主 agent 绝不在主上下文中解析 Excalidraw JSON。
5. 主 agent 绝不加载多个图表做比较。
6. 主 agent 绝不为了“理解格式”而检查 Excalidraw 文件。
7. 始终把所有 Excalidraw 操作委派给子 agent，包括读取/理解、修改、创建、比较。
8. 给子 agent 提供清晰的任务描述；主 agent 只接收子 agent 的文本摘要，不接收原始 JSON 或冗长元素细节。
9. 在主上下文之外隔离图表分析，避免污染主工作上下文。
10. 读取/理解模板：让子 agent 读取 Excalidraw JSON；只提取文本元素，忽略定位/样式；识别组件间关系；总结架构/流程；返回组件/服务列表及描述、连接/依赖关系、关键架构洞察；不要返回原始 JSON 或冗长元素细节。
11. 修改模板：让子 agent 读取文件识别已有元素；找到目标已有组件及其位置；为新组件创建元素 JSON；添加箭头元素表示连接；写回更新后的文件；返回变更确认、新元素位置、创建的元素 ID。
12. 创建模板：让子 agent 为指定数量组件设计布局；创建带文本标签的矩形元素；添加箭头表示关系；使用一致样式（颜色、字体）；写入指定 `[file.excalidraw.json]`；返回文件已创建确认、包含组件摘要、文件位置。
13. 比较模板：让子 agent 读取两个文件；从每个文件提取文本标签；识别结构差异；比较组件关系；返回架构关键差异、各自独有组件、关系/流程差异；不要返回两个文件的完整元素细节。
14. 当想直接读取时，用反借口规则阻止：如“直接读更高效”“省 token”“一次性分析最优”“JSON 很简单”“需要理解格式”“在合理范围内”“只快速检查组件”“文件很小（16K）”；对应做法都是委派给子 agent，必要时让子 agent 提取文本。
15. 红色警报出现时改用 Task 工具 + 子 agent：准备用 Read 工具读 `.excalidraw` 文件、快速检查存在哪些组件、修改前理解结构、加载文件看内容、并排比较多张图、解析 JSON 只提取文本。
16. 快速参考映射：理解图表 -> 主 agent 用“Extract and explain”模板委派，子 agent 返回组件列表 + 关系；修改图表 -> 用“Add [X] connected to [Y]”模板委派，子 agent 返回确认 + 变更；创建图表 -> 用“Create showing [description]”模板委派，子 agent 返回文件位置 + 摘要；比较图表 -> 用“Compare [A] vs [B]”模板委派，子 agent 返回关键差异（不是原始 JSON）。
17. 按实现示例操作：用户问某个 `.excalidraw.json` 展示什么架构时，主 agent 不要读取文件，而是说明会用子 agent 提取细节；派发 Task 工具（general-purpose 子 agent），任务为“Extract and explain components in ...”；收到约 500 token 摘要后，再用摘要回答用户，保持主上下文不变。
18. 用 token 预算数据作为决策检查：单个大文件直接读约 22k tokens（45% 预算），委派后摘要约 500 tokens，节省 98%；两文件比较直接读约 18k tokens，委派后 diff 摘要约 800 tokens，节省 96%；修改任务直接读约 14k tokens，委派后确认约 300 tokens，节省 98%；读取全部 7 个项目图约 67k tokens（200k 预算的 33%），委派后约 2k tokens，节省 97%。
19. 记住“Iron Law”：主 agent 永不读取 Excalidraw 文件，无例外；不因“快速检查”“小文件”“理解格式”“一次性分析”“最优效率”而破例；始终委派，子 agent 隔离是低成本/免费的。
20. 理解为什么直接读不划算：Excalidraw JSON 每个元素有 20+ 属性，大多是视觉元数据（位置、样式、粗糙度）；真正内容只是文本标签和元素关系（<10%）；token 成本来自体积而非复杂度；因此不要把“结构简单”当作直接读的理由。

适用边界 · 注意事项

• 不适用于不涉及 `.excalidraw`/`.excalidraw.json`、图表/流程图/架构可视化或 Excalidraw 文件的任务；一旦涉及 Excalidraw 图表，则没有例外。