SuperAPI AI 工具集

sf-debug

测试与质量

查看项目

更新于 10-15 22:40

技能介绍

用途:当需要从 Salesforce 调试日志做根因分析时使用本技能,包括 Governor 限制诊断、堆栈跟踪解读、慢查询排查、堆/CPU 压力分析,以及基于日志证据的“复现到修复”循环。

主要能力:分析 .log 文件、堆栈跟踪与异常;排查 SOQL/DML/CPU/堆问题;从日志中提取查询计划与性能证据。常见问题模式及建议方向包括:循环中 SOQL(重复 SOQL_EXECUTE_BEGIN,改为一次查询、用 Map 或分组集合)、循环中 DML(重复 DML_BEGIN,改为收集行后批量 DML)、非选择性查询(扫描行数高,增加索引过滤、缩小范围)、CPU 压力、堆压力(用 SOQL for-loop 流式处理)、空指针/致命错误(EXCEPTION_THROWN / FATAL_ERROR,修正空值假设与空查询处理)。

使用方式:先收集组织别名、失败事务/用户流程/测试名、大致时间窗口、用户/记录/请求 ID,并确认是仅诊断还是诊断加修复。获取日志命令:sf apex list log --target-org <alias> --json;sf apex get log --log-id <id> --target-org <alias>;sf apex tail log --target-org <alias> --color。分析顺序:入口与事务类型、异常/致命错误、Governor 限制、重复 SOQL/DML 模式、CPU/堆热点、callout 时序与外部失败。随后按 Critical、Warning、Info 分级,并给出最小正确修复。

输出格式:按“什么失败、在哪里失败、为什么失败、严重程度、建议修复、验证步骤”顺序报告。

限制:测试执行归 sf-testing,代码修复归 sf-apex,部署归 sf-deploy,调试数据归 sf-data,Agentforce 会话跟踪/parquet 遥测归 sf-ai-agentforce-observability。评分 90+ 为专家级分析,80–89 良好,70–79 可接受,60–69 仅部分诊断,低于 60 为不完整分析。