用途:根据代码或需求,为现有系统或规划系统产出面向不同受众的 C4 架构图,并可在受支持的渲染器下更新已有图。
主要能力:默认生成 Level 1 系统上下文、Level 2 容器、Level 3 组件图;Level 4 代码图仅在请求时生成;部署图在有证据时提供,需用户选择环境。默认渲染器为 mermaid,生成或修改前需完整阅读所选渲染器参考并应用全部规则。
使用方式:先确认用户所需渲染器可用;检查相关代码与文档,识别架构元素、边界、关系与部署证据;应用 C4 建模说明及建模不确定性决策;新建图时确定所需图、系统与层级,上下文不清时向用户确认;更新已有文档时先读完整文档,仅应用请求的模型增量,保留既有节点、关系、注释、布局控制与稳定标识,删除不确定内容前先询问;响应前按渲染器参考逐条校验并修正违规。
适用场景:需要为现有系统或规划系统制作分层架构文档、向不同受众解释系统边界与组成、或在受支持渲染器下增量维护架构图。
限制:不得推断证据不支持的架构、部署拓扑、归属或关系技术;必须保持约定的系统边界、图层级与渲染器;证据缺失、渲染器不受支持或不可用时停止并报告;存在实质性建模不确定性时停止并请求澄清,不得替换未请求的渲染器或编造元素。最终需报告图、渲染器、源校验结果、渲染器特定校验状态、假设或限制及未决事项。C4 概念基于 Simon Brown 的 C4 模型(CC BY 4.0),Mermaid 语法约定源自 Mermaid 文档(MIT)。