# lark-create-plantuml

> 生成和校验飞书画板可用的 PlantUML（安全子集）。当用户需要根据自然语言生成 PlantUML，或提供 PlantUML 并要求在飞书画板可用/降级修复/去除不兼容语法时使用。

- Author: maifeng
- Repository: DreamCats/my-skills
- Version: 20260107190129
- Stars: 4
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/DreamCats/my-skills
- Web: https://mule.run/skillshub/@@DreamCats/my-skills~lark-create-plantuml:20260107190129

---

---
name: lark-create-plantuml
description: 生成和校验飞书画板可用的 PlantUML（安全子集）。当用户需要根据自然语言生成 PlantUML，或提供 PlantUML 并要求在飞书画板可用/降级修复/去除不兼容语法时使用。
---

# Lark Create PlantUML

## 概览

生成或修复适配飞书画板的 PlantUML，严格使用安全子集。输出时仅给出一个 PlantUML 代码块；若发生降级或移除，需在代码块外用简短条目说明。

## 快速流程

1) 用户给出自然语言描述  
推断图类型 → 按安全子集生成 PlantUML → 输出代码块。  

2) 用户给出 PlantUML  
运行 `scripts/sanitize_plantuml.py` 进行规则检查与降级 → 输出修正版代码块 + 变更说明。

## 图类型判断（用户未说明时）

- **流程/步骤/审批/规则** → 活动图/流程图
- **调用链/接口交互/消息顺序** → 时序图
- **角色-功能** → 用例图
- **结构/类/关系** → 类图
- **组件/模块/技术路线图** → 组件图（容器+组件盒子）
- **架构图/企业架构/分层架构** → 优先 ArchiMate 兼容模板（无 sprite）；用户明确要求原生态时再输出原生模板
- **实体/字段/表关系** → ER 图
- **思维导图/层级梳理** → 思维导图（不稳定时改用活动图模拟）
- **状态图** → 优先转为活动图表达状态流转，并在说明中标记转换原因

## 安全子集参考

使用并遵守 `references/plantuml-safe-subset.md` 的语法清单。若存在冲突，以“安全子集”为准。

## ArchiMate 兼容性（飞书 PlantUML 1.2023.13）

- ArchiMate sprite 库随 PlantUML 版本发布，飞书画板版本较旧，sprite 不完整。
- 出现 `No such internal sprite: archimate/xxx` 时，说明引用了旧版不存在的元素，需移除该 `sprite` 行并改用“无 sprite 兼容模板”或组件图表达。
- 默认输出无 sprite 兼容模板；仅当用户明确要求原生态/接受失败风险时保留 `sprite` 与 `skinparam`。

## 输出规范

- 只输出一个 PlantUML 代码块（默认 `@startuml`...`@enduml`，思维导图用 `@startmindmap`...`@endmindmap`）。
- 若有降级/移除，代码块外以简短条目说明修改点。
- 不输出多余的伪代码或额外图示。
- 类图成员块可用，但请避免可见性标记（`+` `-` `#` `~`）。
- 输出时不要包含行首缩进（飞书画板粘贴解析更稳定）。
- 避免方向控制指令（如 `left to right direction`）。
- ArchiMate 默认使用无 sprite 兼容模板；若用户要求原生语法，可保留 `!include` / `skinparam` / `sprite` / `legend`，仍需无缩进；渲染失败则改用无 sprite 模板或组件图。

## 脚本

使用 `scripts/sanitize_plantuml.py` 对用户给定的 PlantUML 进行自动降级：

```bash
python3 scripts/sanitize_plantuml.py input.puml --output fixed.puml --report report.txt
python3 scripts/sanitize_plantuml.py input.puml --output fixed.puml --report report.txt --allow-archimate
python3 scripts/sanitize_plantuml.py input.puml --output fixed.puml --report report.txt --archimate-safe
python3 scripts/sanitize_plantuml.py input.puml --output fixed.puml --report report.txt --archimate-raw
```

行为：
- 移除 `!define` 等预处理/宏指令
- 移除 `skinparam` 等样式指令
- 清理常见颜色标记
- 检测到 ArchiMate 时移除 `sprite` 及其引用，保留结构关系
- 缺失 `@startuml/@enduml` 时自动补齐  

读取 `report.txt` 生成变更说明。检测到 ArchiMate 语法时默认进入兼容模式；如需保留 `sprite/skinparam`，显式使用 `--archimate-raw`。