用途
diagram-quality 是一套针对 agent-uml 协作画布的 PlantUML 图表质量最佳实践，目标是让人与 Claude 之间的设计对话更快收敛。它把图表质量拆成三个优先级层次，分别解决渲染、对话节奏和设计结构问题。
主要能力
技能按优先级组织为三个部分：
-
渲染安全（CRITICAL）：包含 18 条规则，用于防止空白画布并确保生成可交互的 SVG。关键规则包括：每个元素都要有 as Alias，否则元素在画布上不可点击；使用 skinparam backgroundColor transparent，因为默认白色会与 #f4f1ec 画布冲突；从 _presets.md 复制正确的预设，每种图表类型一个块，并与画布 CSS 变量匹配。
-
对话机制（HIGH）：包含 5 张决策表，用于反馈-响应循环。关键表包括：表 4「信号 → 动作」，把标注、聊天、沉默和超时映射到正确的工具调用；表 5「消息内容」，规定 message 参数中应写什么（解释变更并提出聚焦问题）。
-
设计有效性（MEDIUM）：包含 4 条带具体阈值的启发式规则。关键规则包括：渐进式细节分层——L1 上下文 → L2 容器 → L3 类 → L4 行为 → L5 状态；交叉引用可追溯性——每个序列参与者必须映射到一个组件，每个接口恰好属于一个组件边界；分解阈值——组件超过 12 个、类超过 15 个、序列参与者超过 10 个或消息超过 20 条时进行拆分。
使用方式
- 开始会话时：阅读 _conversation.md 表 3（图表类型范围）来决定先创建哪种图表。
- 编写 PlantUML 时：应用 _presets.md 中的 skinparam 预设，然后对照 syn-safety.md 检查与图表类型相关的规则。
- 收到反馈后：查阅 _conversation.md 表 4（信号 → 动作），决定是推送新版本还是以提问回复。
- 导出前：运行 _design.md 启发式 4 中的检查清单。
适用场景
- 每次调用 diagram_upsert 之前——检查语法安全规则并应用正确的 skinparam 预设。
- 每次 design_feedback 响应之后——查阅版本决策表以选择正确的下一步动作。
- 开始新的设计会话时——遵循渐进式细节分层来确定图表顺序。
- 调用 design_export 之前——运行导出就绪检查清单。
- 当图表渲染为空白或元素不可点击时——查阅渲染安全规则。
参考文件
- references/_sections.md：章节定义与顺序。
- references/syn-safety.md：18 条渲染安全规则（含错误/正确示例）。
- references/_presets.md：每种图表类型 5 个可直接复制的 skinparam 预设。
- references/_conversation.md：对话循环的 5 张决策表。
- references/_design.md：4 条带阈值的启发式规则。
- assets/templates/_template.md：新增规则的模板。
- metadata.json：版本与参考信息。
限制
资料未提供该技能的收费、价格、平台支持范围、具体效果数据或安装命令等信息，暂未提供。