用途：为单个 Agentforce 智能体生成声明式架构快照，梳理 planner → topics → actions → flows → Apex → prompts → NGA plugins 的元数据树，并渲染人类可读的架构文档。仅读取声明式元数据（BotDefinition、GenAiPlanner*、GenAiPlugin*、GenAiFunction*、Flow、ApexClass、GenAiPromptTemplate），不读取运行时审计数据。
主要能力：通过 sf CLI 与 Python 3.10+ 内联运行，无子代理；并行 Tooling SOQL 扇出（6 个通道）加 Data API SOQL 批量查询 Flow/Apex，仅对 GenAiPromptTemplate 与 NGA 外部插件使用 Metadata retrieve，典型耗时 30–45 秒，硬上限 60 秒。输出主产物 <agent>_<ver>metadata_tree.json 与 <agent><ver>_architecture.md（含 Mermaid 图，节点数默认上限 80）。支持经典 ReAct 与 NGA 两类 planner 归一化，未解析引用进入 _unresolved[]，支持按分支的循环检测。
使用方式：需已认证的 sf CLI 与 Python 3.10+。若未指定智能体，先执行只读查询：sf data query --query "SELECT DeveloperName, MasterLabel FROM BotDefinition ORDER BY DeveloperName" [--target-org <alias>] --json，再选择智能体。主要参数：--agent（必填，BotDefinition.DeveloperName）、--org（可选，默认 sf CLI 目标组织）、--version、--force、--reprobe、--parallelism（默认 5）、--max-mermaid-nodes（默认 80）、--data-dir、--cache-dir。产物默认位于 ~/.vibe/data/agentforce-architecture-analyze/<org_id15>/<agent_api_name>__<agent_version>/。
适用场景：需要了解某智能体声明式结构、排查字段或 SOQL 错误、编写下游消费工具时。限制：不读取运行时数据；需要有效 sf CLI 认证；缓存默认复用，模板变更会自动失效；渠道探测缓存 7 天，Salesforce 发布后可用 --reprobe 刷新。