用途:Detect 用户想要图表的请求,识别图表类型与范围,加载上下文,委托 diagrams-architect 智能体生成 Mermaid 图表,保存到正确位置并确认。技能本身不生成图表,只做协调。
主要能力:支持 C4 Context(第1层,系统边界与外部角色)、C4 Container(第2层,服务、应用、数据库)、C4 Component(第3层,内部模块结构)、Sequence(交互流程)、ER Diagram(数据模型)、Deployment(基础设施)。激活关键词涵盖 create diagram、draw diagram、visualize、C4 diagram、context diagram、container diagram、component diagram、sequence diagram、flow diagram、ER diagram、data model、deployment diagram、architecture diagram 等。
使用方式:技能通过 Skill 工具调用 sw-diagrams:diagrams-architect,传入图表类型、范围与已加载上下文,要求遵循 SpecWeave C4 约定、使用正确文件命名并包含验证说明。保存路径:C4 Context/Container 为 .specweave/docs/internal/architecture/diagrams/;C4 Component 为该目录下的 {module}/;Sequence 为 {module}/flows/;ER 为 {module}/data-model.mmd;Deployment 为 .specweave/docs/internal/operations/diagrams/deployment-{env}.mmd。命名约定如 {system-name}-context.mmd、component-{service-name}.mmd、{flow-name}-flow.mmd、deployment-{environment}.mmd 等。保存后需提示用户在 VS Code 中用 Mermaid Preview 扩展验证渲染,若失败则修正后重新生成。
适用场景:认证系统上下文图、登录流程时序图、用户与会话数据模型等架构与流程可视化。
限制:该技能明确不自行生成图表,必须委托 diagrams-architect 智能体;图表类型不明确时需向用户澄清,上下文不足时需询问关键实体或组件;智能体报错时需报告并建议修正后重试。