用途:当用户需要基于文本的 Salesforce 图表时使用本技能,输出 Mermaid 图,并在需要纯文本兼容时提供 ASCII 备选。适用于架构、OAuth、集成流程、ERD、Agentforce 结构等场景,图表可直接嵌入文档、README 或 issue。
主要能力:支持 OAuth/认证流程(sequenceDiagram,含 Authorization Code、JWT、PKCE、Device Flow)、ERD/数据模型(flowchart LR)、集成时序、系统全景、角色与权限层级、Agentforce 行为映射(agent→topic→action)。提供 OAuth 流程模板与多种数据模型 ERD 模板(Sales、Service、B2B Commerce、Campaigns、Consent、Files、Forecasting、FSL、Party Model、Quote/Order、Revenue Cloud、Scheduler、Territory Management),以及架构、集成、Agentforce、角色层级模板。
使用方式:先确定图表类型、范围与实体、输出偏好(仅 Mermaid、仅 ASCII 或两者)及样式取向;ERD 需确认是否有 org 元数据可作依据。时序图用 sequenceDiagram,ERD 与能力图用 flowchart LR,尽量每图只讲一个主线故事。ERD 与需落地的图可先用 platform-custom-object-generate 或 platform-custom-field-generate 做真实 schema 发现,必要时用本地元数据脚本获取计数与关系上下文。先产出 Mermaid,再按需补 ASCII。生成前建议阅读 references/diagram-conventions.md、mermaid-reference.md、usage-examples.md 等约定文件;OAuth 图需先加载对应 assets/oauth 模板,ERD 加载对应 assets/datamodel 模板。可用 scripts/mermaid_preview.py 本地预览,scripts/query-org-metadata.py 查询 org schema。
输出格式:标题、Mermaid 代码块、ASCII 备选(如需要)、Notes 要点。时序图在步骤顺序重要时用 autonumber,区分请求与响应;ERD 保持对象卡片简洁、关系箭头清晰,避免字段过载。
限制:仅面向 Salesforce 相关图表,非 Salesforce 系统应改用更通用的绘图技能;ERD 前的对象发现需委派给 platform-custom-object-generate 或 platform-custom-field-generate;OAuth 流程需先读对应模板以避免角色不匹配;对象过多时按域拆分子图;Mermaid 渲染器不可用时自动提供 ASCII 备选。具体收费、价格与平台支持情况暂未提供。