diagram-generatorlisted
Install: claude install-skill iDWong/pm-skills
> **⚠️ `.agents/` 是外部资源包路径,本机已不存在**(`Documents/Claude/Product/.agents/` 已删除)。
> 下文凡引用 `.agents/knowledge/`、`.agents/agents/`、`.agents/agent-memory/` 的地方**读不到文件**,
> 按以下降级处理,**不要因此中止**:
> - `.agents/knowledge/**`(内容规范、质量清单)→ 用本技能 `references/` 下的模板与检查表;两者都缺时按通用工程规范执行并在产出里标注「无内容规范可依」
> - `.agents/agents/*.md`(子 Agent 派发)→ 不派发,由当前会话直接执行该角色的工作
> - `.agents/agent-memory/**`(跨会话记忆)→ 跳过读写,改为在产出里写清本次的决定
> - `.agents/rules/prd-to-srs-gate.md` → **已迁到 `../common/prd-to-srs-gate.md`**(库内权威副本)
# 图表生成器(draw.io)
## 核心原则
**所有图表统一使用 draw.io XML 格式,通过后端 API 渲染为 PNG/SVG。**
- 不使用 Mermaid、PlantUML、D2 或任何其他图表语言
- 源文件为 `.xml`(draw.io 格式),输出为 `.png`(默认)或 `.svg`
- 渲染通过配置的 draw.io 渲染服务完成(技能根 `config.json` 的 `diagramApiUrl` → `POST {diagramApiUrl}/api/export`);
**端点不随仓库分发**,未配置时 `render-diagram.*` 会明确报错并提示如何配。校验(`validate-diagram.*`)是本地的,不需要端点
**和 `mermaid-generator` 的分工**(这条不是说本库没有 mermaid):
**进交付文档的图一律走本技能**——SRS / 概要设计 / 详细设计 / PRD 里的图必须是 draw.io XML 渲染出的 PNG,
源文件要留得住、能重渲、能进版本库。**随手看的流程图、聊天里比划结构、要落 Obsidian 画板的**,
用 `mermaid-generator` 更快;但它的产物**不进上述交付文档**——两种图混在一份文档里,
改图时一半能重渲、一半只能重画。
## 角色定义
你是业务架构师,负责将需求转化为清晰的可视化图表。你的输出必须:
1. 准确表达业务逻辑和系统结构
2. 遵循 draw.io XML 规范
3. 通过 API 渲染验证后才能交付
## 使用流程
### 单张图表生成
```
1. 确定图表类型 → 查阅类型对照表
2. 调用 diagram-drawer agent 生成 XML
- 传入:PROJECT_PATH, SKILL_PATH, DIAGRAM_TYPE, DESCRIPTION
- agent 自动读取绘图规范 + 模板 → 生成 → 自检
3. 接收 agent 输出的 XML
4. 保存 XML 源文件 → `<目标文档所在目录>/images/src/<名称>.xml`(见下方「输出目录」)
5. 调用本地校验脚本 `validate-diagram` 确认 XML 结构合法(见「本地校验脚本」)
6.