用 diagram-design 技能包给智能体装上专业图表能力：44 种图型、品牌风格门与旧图重绘实操

# 路线A：skills CLI，装进当前项目的技能目录
npx skills add https://github.com/cathrynlavery/diagram-design --skill diagram-design
# 也可用 --agent 参数指定目标客户端，例如 --agent claude-code

# 路线B：Claude Code 插件市场（plugin 形态，带斜杠命令）
claude plugin marketplace add cathrynlavery/diagram-design
claude plugin install diagram-design@diagram-design

# 已在 Claude Code 会话里也可以直接用斜杠命令：
#   /plugin marketplace add cathrynlavery/diagram-design
#   /plugin install diagram-design@diagram-design

路线 A 的通用性更好：skills CLI 面向所有支持 SKILL.md 的客户端，装进的是项目级技能目录（.claude/skills/ 一类），换客户端不用重装。路线 B 是 Claude Code 原生插件形态，除了技能本体还注册了斜杠命令，团队里统一用 Claude Code 的话管理更顺手。安装完成后重启一次会话让技能被发现。

# 出图前先做品牌接入（对话内进行）：
# 「先从 https://example.com 提取品牌色与字体，
#  更新 style guide 后再开始画图」

# 或手工粘贴令牌（对齐自家设计系统）：
#   paper:  #FFFFFF
#   ink:    #1F2937
#   accent: #0F62FE

# 定稿后让 skill 存成 profile，
# 项目根目录生成 .diagram-design 标记指向它

这一步值得认真做：默认配色的珊瑚橘落在自家产品文档里，一眼就是「AI 生成的」。六种接入方式里，给官网 URL 让它自动抽取是最常用的——skill 会读站点配色与字体生成令牌；本地有设计系统目录（token 文件、Figma 导出物）时选目录扫描更准。存成 profile 后，这个项目之后的出图都会自动套用，风格门也不再重复发问。

# 架构图示例：
# 「画一张订单系统架构图：客户端到 API 网关，
#  网关后面是订单服务与库存服务，共享 PostgreSQL
#  与 Redis，事件走 Kafka。用 diagram-design 的
#  架构图类型，输出内联 SVG。」

# 时序图示例：
# 「下单流程时序图：客户端、网关、订单服务、支付服务
#  四方，包含支付超时重试与幂等校验两个分支」

# 甘特图、桑基图、Wardley 地图、鱼骨图、用户旅程……
# 类型直接点名，skill 会加载对应版式参考

提示词的套路不复杂：点名类型（或者描述场景让它帮你选）、列清楚节点、说清连接关系、把分支与例外单独交代。skill 自己的「何时不该用」清单同样值得记住——快速示意用 wiretext 之类的轻量方案、罗列性质用表格、只有一个形状的「图」直接写句子。选对场景，出图质量才有下限。

# 三类来源都支持：
#   draw.io    —— .drawio / .drawio.png / .drawio.svg
#   Mermaid    —— .mmd 源文件
#   Excalidraw —— .excalidraw 文件

# 重绘提示词示例：
# 「把 docs/legacy-auth.drawio 重绘成新版风格，
#  尺寸对齐 16:9，保留全部分支判断，不要增删节点」

重绘解决的是老项目的真实痛点：文档里的 draw.io 图三年没人敢改，Mermaid 手写长图改一处断一处。重绘时可以指定目标尺寸与细节档位，输出直接对齐新风格。流程上建议分两步——先让它解析原图结构给你确认节点清单，确认无误再生成，避免边改边猜。

# 增量修改示例：
# 「把 Redis 从核心路径挪到旁路，标注只读副本」
# 「给支付失败分支加 annotation callout，
#  注明超时 3 秒触发熔断」
# 「整张图转 sketchy 手绘风格，其余不变」

skill 把「描述行为的语义模式」与「描述版式的类型参考」分开维护，所以挪节点、改流向、加标注这类行为级修改都是增量对话，不需要推倒重来。annotation callout（注释标注原语）、可访问动效、sketchy 手绘变体都是可选项，按需在对话里点名开启。改图的黄金动作是删：节点总在耦合时合并、连线显而易见时去掉，删到「不能再删」才算完成。

# 导出（对话内完成）：
#   「导出 SVG 和 2 倍 PNG」
# 自包含 HTML 直接进 docs/ 仓库或贴进协作工具

# 团队规范化三件事：
#   1) 定制好的 style guide 与 profile 提交进仓库
#   2) 项目根放置 .diagram-design 标记指向 profile
#   3) 新成员装好 skill 即自动继承品牌皮肤

自包含 HTML 意味着每张图都是一个可评审、可 diff、可回滚的代码资产，图表改动走代码评审流程，文档与实现不再两张皮。导出环节注意：PNG 是位图，放大就糊，文档与网页场景优先 SVG；要贴进对格式挑剔的平台再出 PNG。