用途:对 Salesforce Apex 项目运行 ApexGuru 性能扫描,检测 SOQL/DML 在循环中、Schema.getGlobalDescribe()、缺少 WHERE/LIMIT 的 SOQL、未使用的 SOQL 字段等性能反模式。
主要能力:将项目根目录下所有 .cls/.trigger(任意目录结构)打包为 zip,提交至 ApexGuru SFAP Scan API,轮询至扫描完成,解码 base64 报告,并按规则分组展示严重级别、file:line 与建议修复。支持按规则、严重级别、文件过滤或分组,无需重新扫描。
使用方式:所有步骤必须通过技能目录下的脚本执行。首选一条命令完成打包、提交轮询、解码展示:bash "<skill_dir>/scripts/scan.sh" "<project-root>",可用 --out 保存 markdown。也可手动依次运行 build-zip.sh、run-scan.sh、decode-report.js。初始解码使用 --present 直接输出可展示的 markdown,需原样打印,不得压缩或自行改写。钻取时对同一原始结果文件重跑 decode-report.js 并加 --rule、--severity、--file、--group 等参数。
前提:已认证的 sf CLI 组织,或通过 APEXGURU_SFAP_TOKEN / APEXGURU_SFAP_TOKEN_FILE 提供 JWT;需 sf、bash、curl、zip、jq、node 在 PATH 中。
限制:仅前台运行,默认轮询上限 10 分钟,压缩包上限 200MB。不负责通用静态分析、安全或 lint,不应用修复,不引导组织接入 ApexGuru,不生成 SFAP 令牌。分析模式为 static 时标注“Static only”,full 时标注“Production insights”。