图解

支持使用Mermaid、Graphviz及多种图表语法自动生成流程图、思维导图、UML及数据可视化图表。

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

Diagram Tools

专业版增值服务

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

功能能力

1. Mermaid 图表

使用 Mermaid 语法生成各类图表：

• Flowchart 流程图
• Sequence 时序图
• Class 类图
• State 状态图
• ER 数据库图
• Gantt 甘特图
• Pie 饼图
• Mindmap 思维导图
• Timeline 时间线

2. Graphviz 图表

使用 DOT 语言生成：

• 有向图/无向图
• 层级图
• 树形图

3. 数据图表

• 柱状图
• 折线图
• 饼图

快速开始

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

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

快速上手

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

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

适用范围

• 📊 流程图设计
• 🧠 思维导图
• 📈 数据可视化
• 🔄 架构图
• 📑 UML 图
• 📅 时间线图

使用指南

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

输入定义

参数名	类型	必填	说明
content	string	否	处理的内容输入
mode	string	否	处理模式, 可选值: json/text/markdown
style	string	否	输出风格, 参考 references/style.md

输出规范

json

{
  "success": true,
  "data": {
    "result": "处理结果",
    "status": "success",
    "metadata": {
      "template_used": "reviewer",
      "word_count": 0,
      "style": "专业"
    }
  },
  "error": null
}

输出模板参考: assets/output.json

异常应对

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达

安装与配置

运行环境

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

依赖说明(补充)

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

API Key 配置

• 通过环境变量 API_KEY 设置LLM服务的API密钥

可用性分类

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

API Key配置方式:

bash

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

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

案例展示

流程图

思维导图

时序图

常见问题排查

问题	可能原因	解决方案
技能调用无响应	LLM服务不可达	检查网络连接和API Key配置
输出格式异常	输入参数不符合规范	参考输入格式章节校验参数
执行超时	处理数据量过大	分批处理或增加超时时间
权限错误	运行环境权限不足	检查文件系统和命令执行权限

边界条件与限制

• 单次输入内容长度不超过10,000字符
• 并发请求不超过10个
• 依赖Agent平台内置LLM服务
• 不适用于需要人工判断的复杂决策场景
• 所有API Key通过环境变量配置，不硬编码在代码中

安全须知

• 无硬编码密钥: 所有API Key和凭证通过环境变量加载
• 无敏感信息泄露: 日志中对敏感字段进行脱敏处理
• 凭证存储安全: 配置文件建议加入.gitignore
• 最小权限原则: 仅授予完成任务所需的最小权限
• 数据传输加密: 所有API调用使用HTTPS加密传输

安全风险防范

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

问答汇总

Q1: 如何开始使用Diagram Tools？

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

错误恢复

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

创新特色

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
创建流程图	1小时	5分钟	55分钟	5%
更新思维导图	2小时	15分钟	1小时45分钟	3%
生成数据图表	30分钟	10分钟	20分钟	4%
构建架构图	4小时	1小时	3小时	6%
设计UML图	3小时	30分钟	2小时30分钟	7%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
易用性	高	低	中	高
生成速度	快	慢	中	快
学习成本	低	高	中	高
功能丰富度	高	低	中	高
成本	低	高	中	高

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
手动绘图效率低	长时间手动绘制图表，影响工作效率	个人、团队效率	使用自动化工具快速生成图表	时间节约20%
图表更新困难	图表更新频繁，手动修改耗时	团队协作	自动化工具支持图表实时更新	效率提升30%
图表质量参差不齐	手动绘制图表质量难以保证	图表展示效果	自动化工具生成高质量图表	图表质量提升10%

常见问题FAQ

Q1: 如何使用图解技能生成流程图？

A: 使用图解技能生成流程图，您需要在AI Agent对话中调用本技能，并提供相应的Mermaid语法代码作为输入参数。

Q2: 支持哪些类型的思维导图？

A: 支持多种类型的思维导图，包括传统的分支型思维导图、鱼骨图、树状图等。

Q3: 图解技能是否支持自定义样式？

A: 是的，图解技能支持自定义输出风格，您可以在调用技能时指定输出风格参数。

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

A: 支持，图解技能可以批量生成多种类型的图表，您只需提供相应的输入数据即可。

Q5: 图解技能的API Key如何配置？

A: 通过环境变量 API_KEY 设置LLM服务的API密钥，配置方式为 export API_KEY="${API_KEY:?请设置环境变量}"。

边界条件与错误处理

边界条件

边界场景	触发条件	处理方式	预期结果
输入内容过长	输入内容超过10,000字符	截断输入内容	生成图表失败
并发请求过多	同时发起超过10个请求	限制并发请求	请求失败
网络连接中断	网络连接中断	重试请求	请求失败
运行环境不满足	运行环境不符合要求	提示错误信息	生成图表失败

错误处理方案

错误码	原因	处理方式	恢复策略
401	API Key错误	检查API Key配置	重新配置API Key
403	权限不足	检查运行环境权限	修改运行环境权限
500	内部服务器错误	重试请求	重新发起请求
503	服务不可达	检查网络连接	检查网络连接或联系服务提供商
504	请求超时	增加超时时间	增加超时时间后重试请求

功能介绍

• 自动化执行: 图表工具技能 - 支持 Mermaid、Graphviz、流程图、思维导图等多种图表生成
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果