用途:为 SpecWeave 项目创建 Mermaid 图表,遵循 C4 模型与项目约定,覆盖系统架构、时序、ER 与部署图,服务于架构可视化与文档化。
主要能力:生成 C4 四级图(Context、Container、Component、Code)、由 API 流程或用例生成时序图、由数据模型生成 ER 图、由基础设施文档生成部署图;在架构变更时更新图表;校验语法与约定;按 HLD 与 LLD 区分放置位置;保存前确保图表可正确渲染。
必要用法:创建图表前先用 Read 工具加载 Diagram Conventions Guide。C4 图以 C4Context、C4Container、C4Component 或 C4Deployment 直接开头,不加 mermaid 关键字;时序图、ER 图、类图、流程图等标准图需以 mermaid 关键字开头。缩进每级 2 空格。HLD 图放在 architecture/diagrams/,LLD 图放在 architecture/diagrams/{module}/,部署图放在 operations/diagrams/。保存后需让用户在 VS Code 中用 Mermaid Preview 验证渲染,若不通过须修复后再完成。技能另有强制的校验清单:引号、括号、花括号完整,缩进正确,文件位置正确。
适用场景:系统上下文与容器级 HLD、服务内部结构的 LLD、登录或结账等交互流程、数据模型梳理、生产/预发/开发环境部署拓扑。
限制:C4 图误加 mermaid 关键字将无法渲染;单个图表建议不超过 10–15 个元素;C4-4 代码级图通常由 TypeDoc、JSDoc、Sphinx、Javadoc 等工具生成,不手工维护。资料未提供该技能的价格、收费方式与运行平台等信息。