Diagram

核心用法

Diagram 技能是专为技术沟通设计的可视化工具，支持将文字描述转换为多种标准化图表格式。用户只需描述系统架构、业务流程或数据模型，即可自动生成对应的图形化表示。

主要工作流程：
1. 分析用户描述，识别适合的图表类型（流程图、时序图、架构图、ER 图等）
2. 选择最优格式：Mermaid 为默认推荐（兼容 GitHub/Notion 等平台），PlantUML 处理复杂场景，ASCII 用于快速 inline 展示
3. 遵循"从简到繁"原则，先生成核心版本，再按需迭代

输出能力： 支持原始代码块（便于用户二次编辑）、PNG/SVG 图片导出、HTML 交互页面三种形式。

显著优点

• 格式标准化：采用 Mermaid/PlantUML 行业通用语法，输出可在主流文档平台直接渲染
• 认知减负：将复杂系统转化为直观图形，大幅降低技术沟通成本
• 灵活迭代：支持从极简草图逐步细化，避免过度设计
• 多场景覆盖：涵盖软件架构全生命周期需求——从需求分析到系统设计再到文档沉淀

潜在局限

• 依赖外部渲染工具（如 Mermaid Live Editor 或 CLI）生成最终图片
• 极度复杂的系统可能需要手动拆分多图，自动生成分图能力有限
• 美学定制（配色、字体）受限于语法本身，精细调整需人工介入
• ASCII 模式在移动端显示效果较差

适合人群

软件工程师、系统架构师、产品经理、技术写作者，以及任何需要将抽象概念可视化的技术团队成员。

常规风险

• 图表与实际代码实现可能产生偏差，需保持同步更新
• 过度简化可能导致关键细节遗漏，建议在关键节点人工复核
• 敏感系统架构图输出需注意信息安全合规要求

核心用法

Diagram Skill 是一套纯文档型的图表生成指南系统，帮助用户通过文字描述快速生成技术图表。支持 Mermaid（默认）、PlantUML、ASCII 三种格式，覆盖流程图、时序图、架构图、ER 图、类图、状态图、时间线、思维导图等 8 种图表类型。

使用流程采用四步迭代：识别图表类型 → 选择输出格式 → 绘制最小版本 → 按需添加细节。内置快速参考和常见请求映射表，帮助用户将口语化描述（如"画一下我的 API 流程"）准确转换为对应图表类型。

显著优点

1. 零门槛上手：纯 Markdown 文档，无需安装，即开即用
2. 多格式兼容：Mermaid 支持 GitHub/Notion/文档平台直接渲染；PlantUML 适合复杂场景；ASCII 方便聊天场景快速沟通
3. 工程化规范：提供明确的设计原则（从简开始、最多 10-15 节点）、命名规范（系统大写、动作小写）和反模式警示
4. 实用工具链：包含 mermaid-cli 渲染命令、HTML 嵌入方案等完整工作流

潜在局限

• 非自动执行：本 Skill 仅为指南文档，不具备自动生成图表的 AI 能力，需用户手动编写 Mermaid/PlantUML 代码
• 无实时预览：不提供交互式编辑器或即时渲染反馈
• 格式依赖：Mermaid 语法在不同平台存在渲染差异（如 GitHub 支持度 vs. 官方完整特性）

适合人群

• 技术写作者、架构师需要快速绘制系统文档图表
• 开发团队进行代码评审、方案讨论时的可视化沟通
• 需要学习 Mermaid 语法的初学者作为速查手册

常规风险

本 Skill 为纯静态文档，无可执行代码、无外部依赖、无网络请求，风险等级极低。文档中唯一的 bash 代码块（npx @mermaid-js/mermaid-cli）为官方工具使用示例，属于正常引用。