飞书 UML 图生成

要解决什么问题

团队在飞书里写方案、复盘和 SOP 时，经常需要可编辑的流程图、时序图或泳道图。只在对话里贴一段 PlantUML 字符串，同事还得自己复制、找工具渲染，再截图贴回文档——画板里的节点也无法在飞书里直接改。

本技能针对的是「生成 PlantUML → 在目标 Docx 里建画板 block → 把 UML 写进画板」这一整条链路，而不是单纯解释或展示 PlantUML 语法。

工作方式

调用前需要明确或推断：feishu_url（可写入的文档链接）、diagram_kind（流程图、泳道图、时序图、类图、组件图、用例图、ER 图等）、diagram_requirement（文字逻辑；若上传图片则先识别节点、连线与角色再结构化）。可选 parent_block_id 指定插入位置。

Agent 先按规范写出完整 PlantUML（@startuml / @enduml，优先稳定基础语法），写入临时 .puml 文件后执行辅助脚本；脚本通过环境变量读取 FEISHU_APP_ID、FEISHU_APP_SECRET 等凭证，构造飞书画板 API 所需的 JSON payload 并完成写入。返回 ok: true 时告知用户图已进文档；失败时保留 PlantUML 便于排查权限与语法。

适用边界与注意

• 用户只想学习、修改或查看 PlantUML、没有要求写入飞书时，不应调用本技能。
• 目标文档须允许飞书应用写入；Wiki 链接失败时可改用真实 Docx 链接或 document_id。
• 不要在 SKILL、脚本、日志或回复中硬编码 app_secret、tenant_access_token；密钥应只放在本地环境变量。
• 用户 URL 与流程描述按不可信输入处理；PlantUML 以文件或 JSON 传参，避免拼接未转义的 shell。