用途:当用户需要基于文本的图表时使用本技能,生成 Mermaid 图表(架构、OAuth、集成流程、ERD、Agentforce 结构),并在需要纯文本兼容时提供 ASCII 回退。
主要能力:支持 OAuth/认证流程(sequenceDiagram,含 Authorization Code、JWT、PKCE、Device Flow)、ERD/数据模型(flowchart LR)、集成时序、系统全景、角色与权限层级、Agentforce 行为图(agent→topic→action)。输出为可粘贴到 GitHub、Confluence 等 Mermaid 渲染器的 ```mermaid 代码块,以及可选的 ASCII 版本,并附 2-5 条要点说明关键关系、流向与假设。
使用方式:先确定图表类型、范围与实体、输出偏好(仅 Mermaid、仅 ASCII 或两者)及样式取向;ERD 需确认是否有 org 元数据可作依据。时序图用 sequenceDiagram,ERD 与能力图用 flowchart LR,每图尽量只讲一个主线故事。ERD 可先用 generating-custom-object 或 generating-custom-field 做真实 schema 发现,必要时用本地元数据脚本获取计数与关系上下文。OAuth 图需先读取对应资产模板以避免角色不匹配。
适用场景:Salesforce 架构、OAuth、集成流程、ERD、Agentforce 结构等文档化图表。
限制:不负责渲染 PNG/SVG 或精美视觉稿(转 generating-visual-diagrams);非 Salesforce 系统建议用更通用的绘图技能;ERD 前的对象发现需转其他技能。Mermaid 渲染器不可用时自动提供 ASCII 回退。对象过多时按域拆分子图。
参考文件包括 diagram-conventions、mermaid-reference、usage-examples、mermaid-styling、color-palette、erd-conventions、preview-guide,以及 scripts/mermaid_preview.py 与 scripts/query-org-metadata.py;OAuth 与数据模型模板位于 assets/oauth 与 assets/datamodel 下。