核心用法
architecture-diagram 是一款代码架构可视化技能，通过多智能体协作生成 Mermaid 架构图。其工作流程分为四步：首先派遣 codebase-explorer 智能体扫描代码结构；随后将结构模型转换为 Mermaid 流程图语法，支持 TD（层级）或 LR（流水线）布局；接着通过 MCP 调用 Mermaid Chart 服务渲染图表；最后向用户呈现可视化结果及简要说明。
显著优点
- 标准化输出：自动聚合模块、按包分组、用形状区分组件类型（矩形=模块、圆角=入口点、圆柱=数据库、菱形=决策点）
- 智能约束：自动限制15-20节点，避免信息过载
- 生态整合：原生集成 Claude Code 插件体系，支持 agents、hooks 和 commands
- 多场景覆盖：入职引导、PR 审查、系统文档、技术答疑均可使用
潜在缺点与局限性
- 节点上限硬限制：复杂系统需人工聚合，可能丢失细节
- MCP 依赖：渲染依赖外部 Mermaid Chart 服务，离线环境受限
- 重试机制简单：仅2次重试，复杂语法错误可能无法自动修复
- 无实时同步：代码变更后需重新执行全链路流程
适合人群
- 技术负责人进行架构评审
- 新团队成员快速理解系统结构
- 开源项目维护者生成贡献者文档
- 需要向非技术干系人展示系统设计的场景
常规风险
- 依赖第三方 MCP 服务的可用性
- 大型代码库可能因节点压缩导致关键依赖关系被隐藏
- Mermaid 语法版本差异可能导致渲染不一致