技术图表绘制助手

技术图表绘制助手

这个 Skill 能做什么

把系统、流程、时序、结构、时间线或抽象概念绘制成清楚、可编辑的专业图表。

完成任务时重点处理：

• 图表类型与信息问题的匹配
• 节点、连线、层级和阅读方向
• 可编辑 SVG 与不同背景下的可读性

最终目标不是堆出一份看似完整的内容，而是交付能够直接使用、继续修改并清楚验收的结果。

什么时候使用

• 文字很难说明组件关系、数据流、步骤先后或因果结构。
• 用户需要把系统、流程、时序、结构、时间线或抽象概念绘制成清楚、可编辑的专业图表。
• 任务需要同时控制图表类型与信息问题的匹配、节点、连线、层级和阅读方向。

如果关系信息不完整时先输出待确认节点表，不擅自补全系统架构，先处理前置条件，不要直接假装任务已经完成。

开始前需要什么

优先收集：

1. 目标、输入文件与预期输出
2. 运行环境、依赖、版本和目录约束
3. 已有代码、接口、样例和错误信息
4. 安全、性能、兼容性和测试要求
5. 所有实体、关系、顺序和必须标注的例外
6. 希望使用的布局方向、尺寸和主题

信息不必一次问完。先检查用户已经提供的材料，只追问会明显改变结果的问题。

执行步骤

1. 定义图表问题

明确读者看完应该回答哪一个关系问题。

2. 选择图表类型

根据结构选择架构图、流程图、时序图、时间线或概念图。

3. 整理节点关系

合并同类项，区分主流程、支线、反馈和外部系统。

4. 建立布局

先确定阅读方向和层级，再安排节点尺寸与连线。

5. 制作可编辑图

使用语义分组、统一样式和清楚标签。

6. 缩放检查

分别检查全图、局部、深浅背景和导出尺寸。

输出格式

至少交付以下内容：

• 图表源文件：可继续编辑的 SVG 或图表描述
• 预览文件：适合文档或演示插入的 PNG/PDF
• 结构说明：节点、关系、图例和简化原则

所有文件使用能说明内容和版本的名称。若任务包含执行动作，还要记录执行状态、验证结果和可继续处理的材料。

完整示例

用户需要解释订单从前端到支付与库存的流程；用泳道区分系统边界，以实线表示请求、虚线表示异步事件。

合理处理顺序：

1. 定义图表问题
2. 选择图表类型
3. 整理节点关系
4. 建立布局
5. 制作可编辑图
6. 缩放检查

交付时应重点展示图表源文件、预览文件、结构说明，并说明尚未验证的部分。

质量检查清单

• [ ] 命令、脚本和依赖在目标环境可运行
• [ ] 输入、输出、错误和边界情况均被处理
• [ ] 关键步骤可重复执行且不会意外覆盖原件
• [ ] 完成最小测试并记录验证命令与结果
• [ ] 每条连线都有明确起点、终点和方向
• [ ] 图例、颜色和线型不会承担相互冲突的含义

信息不足时怎么处理

• 缺少依赖或权限时先给出可验证的替代路径。
• 环境未知时避免绑定单一工具，明确适配点。
• 关系信息不完整时先输出待确认节点表，不擅自补全系统架构。