用途:从代码或文档中提取流程信息,生成 Mermaid 流程图,展示流程步骤、决策分支和状态转换。适用于可视化 CI/CD 或部署流水线、记录多步骤开发工作流、梳理状态机或生命周期流程。不适用于展示组件间数据流动(应使用 cartograph:data-flow)或组件结构(应使用 cartograph:architecture-diagram)。
主要能力:先用 Agent(cartograph:codebase-explorer) 探索代码库,聚焦流程步骤、条件逻辑、状态转换和流水线阶段,关注 Makefile、CI 配置、钩子链、命令序列和生命周期方法;再将结构模型转换为 Mermaid 语法。规则包括:顺序流程用 flowchart TD,带并行轨道的流水线用 flowchart LR;用形状区分步骤类型([Rectangle] 流程步骤、{Diamond} 决策点、([Stadium]) 起止状态、[[Subroutine]] 子流程、((Circle)) 汇合/同步点);用 -->|label| 表示转换条件;并行轨道放入 subgraph;按结果着色(默认主路径、-.-> 虚线为错误/回退路径、==> 粗线为关键路径);最多 20 个节点。
使用方式:通过 MCP 调用渲染,命令为 mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagram,参数含 prompt、mermaidCode、diagramType: "flowchart"、clientName: "claude-code"。渲染失败时可修正语法并重试,最多 2 次。完成后展示渲染图,并附 2-3 句流程阶段与决策点说明。
限制:节点数上限 20,超出需折叠为子流程节点;必须包含至少一个决策菱形节点;源中存在错误路径时应以虚线呈现。未提供收费、平台支持范围等更多信息。