用途:该技能负责 Salesforce Code Analyzer 的安装、配置与故障排查,管理项目根目录下的 code-analyzer.yml(Code Analyzer 行为的唯一配置来源)。它属于三技能套件之一,与 dx-code-analyzer-run(扫描与结果)、dx-code-analyzer-custom-rule-create(自定义规则)配合使用。
主要能力:检查前置条件(sf CLI、Java、Node.js、Python、org 授权);安装或更新 Code Analyzer 插件;在文件不存在时创建 code-analyzer.yml;编辑引擎设置、规则覆盖、忽略模式与抑制;配置 CI/CD 流水线(如 GitHub Actions、Jenkins);环境验证与分层排查。
使用方式:Code Analyzer 默认无需配置文件即可运行,仅在用户明确要求自定义时才创建 code-analyzer.yml,且只写入需要覆盖的条目,不重复内置默认值。文件放在项目根目录(sfdx-project.json 所在处),CLI 会自动发现,无需 --config-file。常用命令:npm install -g @salesforce/cli;sf plugins install @salesforce/plugin-code-analyzer;sf code-analyzer config 验证配置;sf code-analyzer rules --rule-selector all 解析规则名。规则名必须精确匹配,否则会被静默忽略。
适用场景:首次搭建环境、修复扫描失败、按引擎或规则调整严重级别、排除文件、批量抑制、接入 CI 质量门禁。
限制:不负责运行扫描、修复违规或创建自定义规则(由其他技能处理);禁止使用 MCP、Agent、Web 工具及 which/find 等查找二进制的命令;regex 规则不应手写进 YAML,需用专用脚本创建。具体引擎属性与模板细节见技能内参考文档。