乌龟图流程技能

生成项目流程可视化图表；支持乌龟图(5M1E)、泳道图、流程图、时间线等多种模板；用户需要绘制项目流程图、过程乌龟图或导出流程可视化时使用

过程乌龟图工具

任务目标

• 本Skill用于:根据流程描述自动生成专业级流程可视化图表
• 能力包含:多模板支持(乌龟图/泳道图/流程图/时间线)、节点关系定义、SVG/PNG导出
• 触发条件:用户请求"画流程图"、"生成乌龟图"、"可视化XX流程"、"导出流程图"

前置准备

• 依赖包:cairosvg==2.7.1 (用于PNG导出，如仅需SVG可省略)
• 工作区:脚本在Skill目录内运行，用户文件使用 ./ 相对路径

操作步骤

1. 需求解析与配置生成

分析用户描述的流程，生成JSON配置：

json

{
  "title": "流程标题",
  "template": "turtle|swimlane|flowchart|timeline",
  "nodes": [
    {"id": "唯一标识", "name": "节点名称", "type": "process|decision|start|end", "category": "分类(如man/machine/method等)"},
    {"id": "唯一标识", "name": "节点名称", "type": "process", "category": "分类"}
  ],
  "edges": [
    {"from": "起始节点ID", "to": "目标节点ID", "label": "关系说明(可选)"}
  ]
}

2. 脚本调用生成图表

bash

python scripts/process_turtle.py --config <配置文件.json> --type <模板类型> --output <输出文件名> --format <svg|png>

3. 参数说明

参数	必填	说明	可选值
--config	是	JSON配置文件路径	有效的.json文件路径
--type	否	覆盖配置中的template字段	turtle/swimlane/flowchart/timeline
--output	否	输出文件名(不含扩展名)	默认使用配置中的title
--format	否	输出格式	svg(默认)/png

4. 输出说明

• SVG文件:矢量图形，可直接用于报告和网页
• PNG文件:位图格式，适合PPT和文档插入
• 默认保存路径:当前工作目录

模板类型说明

turtle (乌龟图/5M1E)

人(Man)、机(Machine)、法(Method)、料(Material)、测(Measurement)、环(Environment)六维度分析

swimlane (泳道图)

横向分区展示不同责任部门或阶段的流程

flowchart (标准流程图)

线性流程，含开始/结束节点、判断分支

timeline (时间线图)

按时间顺序展示里程碑和关键节点

使用示例

示例1: 质量管理乌龟图

• 场景/输入:用户描述"质量管理流程，包含5M1E各环节：人是操作员培训，机器是检测设备，方法是SOP，材料是来料检验，测量是数据记录，环境是车间温湿度控制"
• 预期产出:5M1E乌龟图SVG，中心为"质量管理"，六个分支展示各维度
• 关键要点:category字段对应5M1E分类，edges定义输出关系

示例2: 订单处理泳道图

• 场景/输入:"订单处理流程：销售接单→仓库配货→物流发货→客户签收，涉及销售部、仓储部、物流部"
• 预期产出:泳道图，三个横向泳道展示各部门职责和流程流转
• 关键要点:nodes的category对应泳道名称，edges定义跨部门流转

示例3: 简单线性流程图

• 场景/输入:"项目立项流程：需求收集→方案评审→立项审批→合同签订→项目启动"
• 预期产出:标准流程图，从开始到结束的线性流程
• 关键要点:首节点type为start，末节点type为end，判断节点type为decision

资源索引

• 脚本:见 scripts/process_turtle.py(用途:生成SVG流程图，支持多种模板)
• 参考:见 references/templates.md(何时读取:需要详细模板定义或样式配置时)

注意事项

• JSON配置中id必须唯一，建议使用数字或简短字符串
• edges中from/to必须对应nodes中存在的id
• category字段用于模板布局，非必填但影响显示效果
• 导出PNG需要安装cairosvg，未安装时仅生成SVG
• 变更记录：V1.1.0：完善 TRACE 五维度测评体系，补充触发条件、能力边界、异常处理与 TRACE 自评表

能力边界

• 适用场景：质量管理相关领域的咨询、分析和文档生成场景
• 不适配场景：法律法规正式解释、专业认证替代、涉及人身安全的紧急决策
• 输入要求：需提供明确的参数和要求，脚本依赖需预先安装，Python 3.9+

异常处理

• 输入不完整：提示用户补充缺失的关键信息，列出必需字段，引导用户逐步完善输入
• 依赖缺失：检测依赖环境（Python库、系统工具），给出明确的安装指令和验证方法
• 执行失败：输出清晰的错误信息和可能的原因，提供降级方案（如无法生成 PNG 则输出 SVG）
• 结果验证：输出完成后提供校验方法，建议用户确认关键内容的准确性

TRACE 五维度自评

维度	得分	自评说明
Trust 信任度	8/10	SKILL.md 结构化清晰，描述完整，触发条件明确，使用者可信任输出质量
Reliability 可靠性	8/10	包含使用示例和注意事项，输出格式统一，有脚本支撑的可复现能力
Adaptability 适配性	7/10	适应多种相关输入场景，提供参数化配置和脚本 支持
Convention 惯例性	8/10	遵循 SKILL.md 标准结构，frontmatter 完整，资源索引清晰
Effectiveness 有效性	8/10	端到端完成任务，脚本自动化提升执行效率
总分	39/50	基本合格