图解

用Mermaid、PlantUML或ASCII从描述自动生成架构图、流程图和时序图，支持中文交互及多场景应用。

核心功能: 本技能提供中文交互、化工作流场景等能力。

Diagram

专业版专属特性

能力	免费版	付费版
基础功能	支持	支持
DiagramASCII从描述生成	不支持	支持
高清分辨率与无损输出	不支持	支持
批量生成与风格预设	不支持	支持
自定义模型微调	不支持	支持
商用版权授权	不支持	支持

能力概览

• Generate diagrams from descriptions with Mermaid, PlantUML, or ASCII for architecture, flows, seq

开始使用

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

场景示例

场景	输入	输出
图表生成	架构描述和图表类型	Mermaid/PlantUML/ASCII图表
流程图绘制	业务流程描述	标准流程图和泳道图
架构图创建	系统组件和关系	系统架构图和部署图

不适用于：需要交互式动画和3D可视化的场景

使用说明

1. 确认运行环境满足依赖说明中的要求
2. 根据适用场景选择合适的使用方式
3. 执行操作并检查输出结果
4. 如遇错误，参考错误处理章节

输入规范

参数名	类型	必填	说明
description	string	是	图表内容描述
format	string	否	输出格式, 可选: mermaid/plantuml/ascii, 默认: mermaid

输出规范

json

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

安装与配置

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

工具依赖

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

问答汇总

Q1: 如何开始使用Diagram？

A: 请参考使用流程和依赖说明章节，确保运行环境满足要求后调用本技能。

错误恢复

错误场景	原因	处理方式
LLM响应超时或无响应	网络延迟或模型负载过高	请求重试；确认Agent平台LLM服务正常
输入内容格式不正确	用户输入不符合skill预期格式	检查输入是否符合skill使用说明中的格式要求，参考示例章节
执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息
命令执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求；检查命令权限设置

技术创新

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
架构图绘制	4小时	10分钟	3小时50分钟	5%
流程图设计	2小时	30分钟	1小时30分钟	3%
时序图生成	3小时	20分钟	2小时40分钟	4%
系统部署图创建	5小时	1小时	4小时	6%
大规模图表批量生成	8小时	2小时	6小时	7%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
易用性	高	低	中	高
成本	低	高	中	高
生成速度	快	慢	较快	快
图表质量	高	低	中	高
可定制性	中	低	高	高
学习曲线	低	高	中	高

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
重复劳动	需要手动绘制大量图表，耗时费力	降低工作效率，增加错误率	自动化生成图表，减少人工操作	时间节约50%
设计一致性	手动绘制图表难以保证一致性，影响项目质量	影响项目进度和团队协作	提供风格预设，确保图表风格统一	准确率提升10%
更新维护	图表更新和维护需要重新绘制，效率低下	影响项目迭代速度	自动更新图表，提高维护效率	时间节约30%

常见问题FAQ

Q1: Diagram技能支持哪些图表类型？

A: Diagram技能支持架构图、流程图、时序图等多种图表类型，满足不同场景的需求。

Q2: Diagram技能的输出格式有哪些？

A: Diagram技能支持Mermaid、PlantUML和ASCII三种输出格式，可根据需求选择。

Q3: Diagram技能的适用场景有哪些？

A: Diagram技能适用于项目管理、任务规划、进度跟踪、团队协作等场景，尤其适合独立开发者、企业团队和自动化工作流。

Q4: Diagram技能是否支持批量生成图表？

A: 支持，Diagram技能可以批量生成图表，提高工作效率。

Q5: Diagram技能是否需要安装额外的软件？

A: 不需要，Diagram技能基于Mermaid、PlantUML和ASCII技术，无需额外安装软件。

诊断与修复

错误现象	可能原因	诊断步骤	解决方案
无法生成图表	输入格式错误	检查输入格式是否符合要求	修正输入格式
图表样式不正确	格式配置错误	检查格式配置是否正确	修正格式配置
图表内容缺失	数据源问题	检查数据源是否正常	修复数据源
图表生成缓慢	系统资源不足	检查系统资源使用情况	优化系统资源或升级硬件
API Key配置错误	API Key错误或未配置	检查API Key是否正确配置	重新配置API Key

安全规范

1. 确保输入的描述内容不包含敏感信息，避免信息泄露。
2. 定期更新技能依赖的LLM API，以保持技能的安全性和稳定性。
3. API Key应妥善保管，避免泄露到版本控制系统。
4. 对生成的图表进行内容审查，确保图表内容符合法律法规和道德规范。
5. 避免在公共场合分享技能使用过程中的敏感信息。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

功能介绍

• 自动化执行: 用Mermaid/PlantUML/ASCII从描述生成图,架构/流程/时序全覆盖。Generate diagrams
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果

错误恢复方案

针对图解使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

图解通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

图解通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

依赖说明

运行环境

• Agent 平台: 支持SKILL.md的任意AI Agent
• 操作系统: Windows / macOS / Linux

可用性分类

• 分类: MD（纯Markdown指令，通过自然语言驱动Agent完成操作）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent完成操作。