用途:当需要回答“这些系统按什么顺序互相通信”时,该技能把描述好的交互(API 调用链、认证握手、Webhook 流程等)转换为可渲染的 Mermaid 时序图,展示参与者、有序消息、返回值以及重要的错误/超时路径。
必要输入(未提供时需询问):参与者(客户端、API、数据库、第三方等);消息(各方按顺序发送与返回的内容);同步与异步(哪些调用阻塞等待响应,哪些是发出即忘);边界情况(值得展示的失败、超时或替代路径)。
输出格式:以“[交互名称] — sequence”开头,一行说明追踪的流程,随后是 sequenceDiagram 代码块,最后附 Notes 说明失败/超时处理、重试、幂等性及异步(-))等内容。
Mermaid 规则:以 sequenceDiagram 开头;预先用 participant X as Label(或 actor)声明参与者;实线箭头 ->> 表示调用/请求,虚线 -->> 表示响应/返回,-) 表示异步消息;用 Note over A,B: ... 添加上下文,必要时用 alt/else/end 表示替代路径;消息文本保持简短,除消息分隔符外不要使用冒号。
质量检查:参与者已声明且顺序符合真实调用流;请求与响应可区分(实线对虚线);至少展示或注明一条失败/边界路径;同步与异步消息视觉上可区分;Mermaid 块无需修改即可渲染。
反模式:不要只展示顺利路径而忽略失败路径;不要混淆请求与返回;不要为整齐而重排消息顺序;不要在消息文本内使用冒号;不要虚构参与者,只建模实际涉及的系统。
限制:资料未提供具体安装命令、收费方式或平台支持信息。