diagram-generatorlisted
Install: claude install-skill iDWong/dev-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.