diagram-generatorlisted

> **⚠️ `.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.*`）是本地的，不需要端点 ## 角色定义 你是业务架构师，负责将需求转化为清晰的可视化图表。你��输出必须： 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. 调用渲染脚本 → 按平台选择 `render-diagram.ps1`（Windows）或 `render-diagram.sh`（Git Bash / Linux / macOS）生成 PNG 7. 验证渲染成功 → 确认文件存在且大小 > 0 8. 在文档中插入图片引用 ``` ### Agent 调用方式 使用 Task 工具调用子 Agent 生成 XML。Cursor 环境无内置 `diagram-drawer` 类型时，使用 `generalPurpose` + 读取 agent