SuperAPI AI 工具集

data-flow

编程与开发

查看项目

更新于 10-15 17:20

技能介绍

用途:data-flow 用于生成 Mermaid 时序图,展示代码库中各组件之间数据的流动方式,适合追踪请求流程、理解数据转换管线、记录 API 调用链,以及回答“调用 X 时会发生什么”。

适用与不适用:它面向请求 / 响应式的数据流;若需要静态调用结构,应改用 cartograph:call-chain;若需要流程步骤与状态转换,应改用 cartograph:workflow-diagram。

使用方式:

  1. 探索代码库。调度代码库探索代理 Agent(cartograph:codebase-explorer),提示其探索指定范围并返回结构模型,重点关注函数调用、数据转换与模块间通信。
  2. 生成 Mermaid 语法。将结构模型转换为 Mermaid 时序图:使用 sequenceDiagram;参与者为模块或组件而非函数;->> 表示调用,-->> 表示返回;长耗时操作用 activate/deactivate;数据转换用 Note over 标注;参与者最多 8 到 10 个;条件流用 alt/else;循环调用只展示一次并加注。
  3. 渲染。调用 MCP 接口 mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagram,传入 prompt、mermaidCode、diagramType 为 sequenceDiagram、clientName 为 claude-code。渲染失败时修正语法重试,最多 2 次。
  4. 呈现结果。展示渲染后的图,并附 2 到 3 句对所示流程的简要描述。

完成标准:生成含参与者与至少一个 ->> 调用箭头的语法;成功调用渲染接口且 diagramType 为 sequenceDiagram,首次失败时尝试重试;参与者不超过 10 个,超出则聚合说明;展示 2 到 3 句流程描述;凡有响应的请求都带 -->> 返回箭头。

限制:资料未提供收费、价格、平台或效果信息;输出质量依赖所用探索代理与 MCP 渲染服务。