Diagrams for Agents
先选视觉，再画它。默认使用“本地模式”，这样用户的源材料会保留在他们的机器上。只有当用户要求自动判断框架、更强的证据支撑或使用API/MCP结果时，才使用“验证模式”。
工作流程
-
阅读所提供的上下文，识别读者需要做出的决策。
-
阅读 references/visual-selection.md。选择一个支持的系列和一个目标预设。
-
如果需要品牌化输出，请阅读 references/brand.md。在保存之前，提出提取的标记。
-
使用 assets/spec.example.json 作为模板创建JSON规范。将用户的完整源内容放在
source字段中；当所选系列要求时，为每个声明附加一条精确的evidence引用。 -
渲染并验证：
node <skill-dir>/scripts/render.mjs input.diagrams-for-agents.json output.html --svg output.svg --receipt output.receipt.json node <skill-dir>/scripts/validate-artifact.mjs output.html -
显示HTML工件，并报告所选的系列、任何故意省略的内容，以及证据基础是
local-exact-quote还是verified。
模式选择
本地模式 — 默认
- 无需账户、API密钥、托管的渲染器或内容上传。
- 支持的系列：
swot、quadrant、comparison、flow、timeline、architecture。 - 生成源文件可编辑的HTML及内嵌SVG，可选的独立SVG，以及机器可读的收据。
- 渲染器会拒绝不支持的系列、不安全的主题值、重复的ID、悬空的连接以及缺少精确引用证据的情况。
验证模式 — 显式启用
阅读 references/verified-mode.md。在可用时优先使用已安装的 render_diagram MCP工具。否则，仅当用户确认愿意将所提供的上下文发送给“Diagrams for Agents”API后，再调用其API。
以下情况适合使用验证模式：
- 用户希望“Diagrams for Agents”从更广泛的业务框架目录中做出选择；
- 编造或证据薄弱的业务声明代价高昂；
- 应用程序需要稳定的
VisualPayload和托管渲染URL； - 本地的六个系列集无法如实表示所需决策。
切勿将本地模式描述为等同于验证模式。精确的子字符串检查只能证明来源，而不能证明分析的准确性。
Mermaid重绘
对于Mermaid流程图，请先转换：
node <skill-dir>/scripts/import-mermaid.mjs source.mmd draft.diagrams-for-agents.json
导入器支持 flowchart/graph 节点和有向箭头。对于不支持的Mermaid语法，它会有意拒绝而非静默丢弃。检查生成的标签，如有需要添加原始上下文和证据，然后正常渲染。
输出规则
- 每个图表只有一条主导的阅读路径。
- 最多使用九个主节点；超出此范围应将概览与详情分开。
- 最多使用一种强调色，且最多用于两个聚焦元素。
- 优先删除而非缩小字号。
- 确保最终工件在静态帧中仍然有用。
- 切勿为了填充框架槽位而编造缺失的事实。
- 未经明确说明模式变更，切勿将本地内容发送到网络服务。