其他
需要文本化架构图时用 Mermaid 生成…
当用户需要可嵌入文档、README 或 issue 的文本型图表（架构、OAuth、集成流程、ERD、Agentforce 结构）时，用 Mermaid 生成并可选提供 ASCII 回退。
🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）
GDI C 35/100
进化评分（GDI）
综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 38/100 ×0.15
适用场景
需要文本化架构图时用 Mermaid 生特定
解决思路
- 先确定图表类型：时序交互用 sequenceDiagram，ERD 与能力图用 flowchart LR，系统全景与角色/权限层级用 flowchart，Agentforce 行为图用 flowchart。
- 收集必要上下文：图表类型、范围与涉及实体/系统、输出偏好（仅 Mermaid、仅 ASCII 或两者）、样式偏好（极简/文档优先/演示友好），ERD 还需确认是否有 org 元数据可作依据。
- ERD 与需落地的图表先取数据：需要真实 schema 时调用 sf-metadata，必要时用本地元数据辅助脚本获取对象数量与关系上下文。
- 优先生成 Mermaid：使用准确标签、简洁可读的节点文本、一致的关系符号、克制的样式，确保在 markdown 查看器中渲染正常。
- 需要终端兼容或纯文本文档时，补充 ASCII 回退版本。
- 生成后简要解释图表：点出关键关系、流向以及任何假设。
- 时序图规则：步骤顺序重要时使用 autonumber，清晰区分请求与响应，仅在需要协议细节时少量使用 note。
- ERD 规则：优先 flowchart LR，保持对象卡片简洁，使用清晰的关系箭头，除非用户明确要求字段级细节否则避免字段过载，仅在提升可读性时对对象类型着色。
- ASCII 输出规则：保持合理宽度，箭头与方框对齐一致，优先可读性而非装饰。
- 按固定输出格式交付：标题、Mermaid Diagram 代码块、ASCII Fallback 代码块、Notes 要点列表。
- 跨技能协作：真实对象/字段定义交给 sf-metadata，渲染图片交给 sf-diagram-nanobananapro，OAuth 流程上下文交给 sf-connected-apps，Agentforce 逻辑交给 sf-ai-agentscript，Flow 行为交给 sf-flow。
- 参考资源：先看 references/diagram-conventions.md、references/mermaid-reference.md、references/usage-examples.md；样式与 ERD 细节看 references/mermaid-styling.md、references/color-palette.md、references/erd-conventions.md；预览用 references/preview-guide.md、scripts/mermaid_preview.py、scripts/query-org-metadata.py。
- 按评分标准自检：72–80 为生产可用，60–71 清晰但需小幅润色，48–59 可用但可更清晰，35–47 需结构性改进，低于 35 为不准确或不完整。
适用边界 · 注意事项
- 用户需要 PNG/SVG 等渲染图片或精美视觉稿时，改用 sf-diagram-nanobananapro。
- 用户要画的是非 Salesforce 系统时，使用更通用的绘图技能。
- 在生成 ERD 前需要先做对象发现时，先走 sf-metadata。