c4-diagram-generator 是一个专用技能,用于按照 Simon Brown 的 C4 方法论生成 C4 模型架构图,实现 AI 驱动的多抽象层级架构可视化。
用途 该技能面向软件架构可视化,帮助生成符合 C4 模型规范的架构图,覆盖从系统上下文到代码级别的多个抽象层级,适用于架构设计、评审和文档化。
主要能力
- 从多种 DSL 格式生成 C4 图:Structurizr、PlantUML、Mermaid。
- 支持全部四个抽象层级:Context(上下文)、Container(容器)、Component(组件)、Code(代码)。
- 按 C4 约定自动布局和设置样式。
- 导出为 PNG、SVG、PDF 格式。
- 与文档站点集成(Docusaurus、MkDocs)。
- 可借助 MCP 服务器:UML-MCP Server(PlantUML、Mermaid、D2 图生成)、Mermaid MCP Server(50+ 预置模板、22+ 图表类型)、Claude Mermaid(在 Claude 中预览图)、MCP Kroki Server(通过 Kroki.io 多格式渲染)。
使用方式 前置条件:Node.js(v18+)用于 Structurizr CLI 或 Mermaid CLI;Java Runtime 用于 PlantUML 渲染;可选 Structurizr CLI、Kroki 或本地 PlantUML 服务器。
生成方式示例:
- Structurizr DSL:定义 workspace、model(person、softwareSystem、container、关系)和 views(systemContext、container、styles)。
- PlantUML C4:使用 C4-PlantUML 库,通过 Person、System、System_Ext、Rel 等宏定义。
- Mermaid C4:使用 C4Context 语法,通过 Person、System、System_Ext、Rel 定义。
多层级生成:可分别配置 context、container、component、code 层级的元素与关系。
渲染与导出命令示例:
- Structurizr CLI:structurizr-cli export -workspace workspace.dsl -format plantuml -output ./diagrams
- PlantUML:java -jar plantuml.jar -tsvg diagram.puml
- Mermaid CLI:mmdc -i diagram.mmd -o diagram.svg -t neutral
- Kroki:curl -X POST https://kroki.io/plantuml/svg --data-binary @diagram.puml -o diagram.svg
输出格式为结构化 JSON,包含 operation、level、format、status、diagrams、elements、artifacts、warnings、errors 等字段。
适用场景
- c4-model-documentation.js:主要图表生成。
- system-design-review.js:架构可视化。
- microservices-decomposition.js:服务边界图。
- cloud-architecture-design.js:基础设施可视化。
最佳实践与限制
- Context 图展示全局,聚焦用户和外部系统;Container 图展示高层技术选型;Component 图展示容器内部结构;Code 图谨慎使用,仅用于关键组件。
- 遵循 C4 配色方案与符号约定:实线表示同步通信,虚线表示异步通信,箭头表示依赖/通信方向,关系标签中包含技术注解。
- 严格遵循 C4 模型约定,保持图表聚焦于其抽象层级,使用一致的命名约定,记录所有外部依赖,对图表源文件进行版本控制。
- 常见错误包括 DSL 语法无效、循环依赖、缺失元素引用、渲染超时,需分别通过 CLI 校验、检查关系、先定义元素、简化图表或使用本地渲染器解决。
其他信息(如收费、价格、平台支持细节)暂未提供。