需要为任意代码库生成 UML/架构/流程图并产出规范…

适用于任何软件项目，需要从代码库自动提炼架构信息并生成风格统一、几何无缺陷的 UML/架构/流程 HTML+SVG 文档。

适用场景

解决思路

1. 先分析代码库：读取项目根目录的 `CLAUDE.md`（如存在）获取项目概览。
2. 读取各子目录的 `CLAUDE.md`（如存在）获取模块细节。
3. 用 Glob 扫描源码文件结构，例如 `**/*.go`、`**/*.py`、`**/*.ts` 等。
4. 读取入口文件，例如 `main.go`、`app.py`、`index.ts` 等，识别顶层组件。
5. 用 Grep 搜索关键模式：接口定义、函数签名、依赖注入、配置项。
6. 从以上信息提炼组件清单：服务、模块、外部依赖。
7. 从以上信息提炼关系图：谁调用谁、谁依赖谁、数据流向。
8. 从以上信息提炼核心类型：结构体/类、接口、枚举。
9. 从以上信息提炼流程：主业务流程、异常处理流程。
10. 从以上信息提炼部署：进程、中间件、外部服务。
11. 使用 AskUserQuestion 让用户选择要生成的图表，设置 `multiSelect: true`。
12. 分4组展示图表选项；第1组为结构性图形（静态）：系统架构图 architecture、类图 class、对象图 object、组件图 component。
13. 第2组为结构性图形续+部署：部署图 deployment、包图 package、复合结构图 composite-structure、剖面图 profile。
14. 第3组为行为性图形（动态）：流程图 flowchart、用例图 usecase、活动图 activity、状态机图 state-machine。
15. 第4组为交互图+常用非UML：序列图 sequence、通信图 communication、交互概览图 interaction-overview、泳道图 swimlane、全部生成 all。
16. 默认推荐：architecture + sequence + flowchart。
17. 对每个选中的图表类型，先用 Read 工具阅读对应示例文件 `examples/<标识>.html`，例如 `examples/architecture.html`，提取布局模式、节点样式、标注方式。
18. 根据步骤1提取的架构信息，整理出该图表应展示的元素和关系。
19. 调用 `/architecture-diagram` skill，传入图表类型、标题、内容描述、输出路径，必须指定 light 风格。
20. 输出文件保存到 `docs/<标识>.html`，例如 `docs/architecture.html`。
21. 生成后必须 review：运行几何校验脚本，按结果修正后再继续下一张，见步骤3.5。
22. 简要报告完成状态。
23. 生成规则：必须使用 light Claude 风格，暖白背景 `#FAF9F6`、terracotta/sage/plum/rose 配色、Inter 字体、白色卡片容器，与 Anthropic Claude 品牌视觉一致。
24. 防遮盖：计算每个 SVG 元素的边界框，确保无重叠。
25. 防遮盖：箭头绘制在节点下方，SVG 中先画箭头再画节点。
26. 防遮盖：节点间留足间距，垂直最少 40px，水平最少 30px。
27. 防遮盖：文字不超出所在节点边界，超长文字截断或换行。
28. 防遮盖：连接线的标签放置在线段中点偏移处，避免覆盖线段或节点。
29. 防遮盖：如果元素过多导致图表拥挤，拆分为多个子图或缩小元素尺寸。
30. 批量生成顺序（宏观→微观）：architecture → component → deployment → package → composite-structure → profile → class → object → usecase → flowchart → activity → state-machine → swimlane → sequence → communication → timing → interaction-overview。
31. 每张图生成后运行 `python3 skills/insight-diagram/scripts/review_svg.py docs/<标识>.html --min-gap 8`。
32. 批量校验运行 `python3 skills/insight-diagram/scripts/review_svg.py docs/*.html --min-gap 8`。
33. 脚本检查箭头落点：每个带箭头的端点必须恰好落在目标框/椭圆/菱形的边缘线上，容差 6px。
34. 处理 `ERROR 深入框内`：端点穿入框内部 >8px 时，缩短连线，让它止于边缘。
35. 处理 `WARNING 空接`：端点悬空、距最近框 >8px 且不汇入任何其它连线时，把端点对齐到框边或汇合点。
36. 合法情形：端点落在框边、生命线、或与另一条连线交汇（分支/汇聚），脚本不会误报。
37. 脚本检查框重叠：`ERROR`，非嵌套的两个框在水平、垂直两个方向都有交叠时，必须移开其中一个；嵌套，即一个完全包住另一个，如分组边界框包子节点，是允许的。
38. 脚本检查框间距：`WARNING`，投影相邻的两框净间距 < `--min-gap`，默认 8px，拉开距离。
39. 处理原则：`ERROR` 必须修复后再进入下一张；修完重跑脚本确认归零。
40. 处理原则：`WARNING` 逐条核对；序列图生命线底部的消息、泳道边界、紧贴的分组等可能是设计本意，确认无误可保留；其余应调整坐标。
41. 修正方式是直接编辑 `docs/<标识>.html` 里对应的 `<rect>/<line>/<path>` 坐标，而非重新生成整张图。
42. 退出码：有 ERROR 返回 1，干净返回 0；CI 中可加 `--strict` 让 WARNING 也阻断。
43. 全部完成后输出生成的文件列表。
44. 全部完成后输出每个图表的简要描述。
45. 生成任何图表前，必须先阅读对应的示例文件，以确保风格一致、结构规范。
46. 从示例提取 SVG 布局策略：节点间距、分组方式、箭头走向。
47. 从示例提取节点样式层级：核心节点 accent 高亮、普通节点实线边框、可选节点虚线边框。
48. 从示例提取标注风格：阶段标签、Legend 图例、卡片摘要。
49. 从示例提取信息密度：每个节点显示多少字段/属性。
50. 结构对齐：页面顶部为标题 + 副标题 + 图表类型说明。
51. 结构对齐：中间主体为 SVG 图表区域，带浅色边框容器。
52. 结构对齐：底部为信息摘要卡片 + 页脚。
53. 内容替换而非照搬：示例中的业务数据（NovaShield 风控系统）是虚构的参考案例，生成时需替换为目标项目的真实架构信息；只参考布局和样式，不复制业务内容。
54. 无对应示例的类型：包图 package、复合结构图 composite-structure、剖面图 profile、状态机图 state-machine、定时图 timing 这 5 种没有示例文件，参考最相近的已有示例，如包图参考组件图，状态机图参考活动图，并沿用相同的视觉语言。
55. 各图表内容指南：系统架构图 architecture，非UML，最常用，展示系统顶层组件及其连接关系，区分内部模块与外部依赖，标注核心数据流方向。
56. 各图表内容指南：类图 class，核心类型为类节点，名称+字段+方法，展示继承、组合、依赖关系，接口与实现分离，限制在 10-15 个核心类型。
57. 各图表内容指南：对象图 object，选取一个典型运行时场景，展示对象实例及其属性值，展示对象间的链接关系。
58. 各图表内容指南：组件图 component，每个组件为一个节点，箭头表示依赖/调用方向，标注接口名称。
59. 各图表内容指南：部署图 deployment，展示物理节点，服务器、容器、Serverless，中间件，消息队列、缓存、数据库，外部服务，第三方 API，标注通信协议。
60. 各图表内容指南：包图 package，按模块/命名空间分组，展示包间依赖关系，体现分层架构。
61. 各图表内容指南：复合结构图 composite-structure，展示类/组件的内部结构，部件(Part)与连接器(Connector)，端口(Port)与接口。
62. 各图表内容指南：剖面图 profile，展示自定义构造型(Stereotype)，扩展元模型的标签定义(Tagged Values)，领域特定建模约束。
63. 各图表内容指南：流程图 flowchart，非UML，最常用，展示主流程 + 关键分支，失败/异常路径，起止节点清晰。
64. 各图表内容指南：用例图 usecase，展示参与者（人/外部系统），用例椭圆，include/extend 关系。
65. 各图表内容指南：活动图 activity，阶段/步骤为活动节点，并行分支用 fork/join，决策点用菱形。
66. 各图表内容指南：状态机图 state-machine，展示对象的关键状态，触发状态变迁的事件，动作/守卫条件，初始态和终态。
67. 各图表内容指南：序列图 sequence，参与者为纵向生命线，水平箭头为消息调用，标注关键返回值，关注 2-5 个核心交互场景。
68. 各图表内容指南：通信图 communication，组件为节点，消息为连线，标注消息序号，强调协作关系而非时序。
69. 各图表内容指南：定时图 timing，时间轴横向展开，状态变化的时间约束，持续时间标注。
70. 各图表内容指南：交互概览图 interaction-overview，控制流节点内嵌交互片段，展示条件分支和循环，宏观概览各交互场景。
71. 各图表内容指南：泳道图 swimlane，活动图变体，按组件/角色分泳道，流程步骤在对应泳道内，跨泳道箭头表示交互。
72. 支持生成的结构性图形（静态）：系统架构图 architecture、类图 class、对象图 object、组件图 component、部署图 deployment、包图 package、复合结构图 composite-structure、剖面图 profile。
73. 支持生成的行为性图形（动态）：流程图 flowchart、用例图 usecase、活动图 activity、状态机图 state-machine、序列图 sequence、通信图 communication、定时图 timing、交互概览图 interaction-overview、泳道图 swimlane。
74. 示例文件清单：`examples/architecture.html`、`examples/class.html`、`examples/object.html`、`examples/component.html`、`examples/deployment.html`、`examples/flowchart.html`、`examples/usecase.html`、`examples/activity.html`、`examples/sequence.html`、`examples/communication.html`、`examples/dfd.html`、`examples/interaction-overview.html`、`examples/swimlane.html`。

适用边界 · 注意事项

• 没有 `/architecture-diagram` skill 或 `skills/insight-diagram/scripts/review_svg.py` 时，无法按本流程渲染和几何校验。
• 只需要 Mermaid/PlantUML 等文本图表、不需要 HTML+SVG 视觉文档时，不必使用。
• 无法读取源码或项目缺少可分析结构时，生成结果会缺少真实架构信息。