用途:管理 Salesforce Code Analyzer 的项目配置文件 code-analyzer.yml,这是控制其行为的唯一配置来源,所有引擎、规则、忽略与抑制的自定义均通过创建或编辑该文件完成。文件不存在时会创建于当前工作目录。
主要能力:检查前置条件(sf CLI、Java、Node.js、Python、org 授权),安装或更新 Code Analyzer 插件,创建/编辑 code-analyzer.yml,配置引擎设置、规则覆盖、忽略模式与抑制项,搭建 CI/CD 流水线(GitHub Actions、Jenkins 等),以及环境校验与故障排查。范围之外包括运行扫描(交由 running-code-analyzer 技能)、修复违规、解释规则、创建自定义规则与抑制管理。
使用方式:核心原则是仅在需要自定义时才写 YAML——Code Analyzer 无配置即可开箱使用,默认值内置于工具中。不要主动创建 code-analyzer.yml,不要重复内置默认值,文件须放在项目根目录(sfdx-project.json 或 sf-project.json 所在处),CLI 会自动发现,无需 --config-file。用户只说“配置 code analyzer”而无细节时应先询问要自定义什么。创建可选脚本 auto-generate(generate-config.sh,已存在文件会报错)或手动按示例写;已存在则读取后用 Edit 修改。规则名必须先解析为精确名称,模糊或错误名称会被静默忽略。常用命令:sf --version、sf plugins install @salesforce/plugin-code-analyzer、sf code-analyzer config、sf code-analyzer rules --rule-selector all。
适用场景与限制:适用于 Apex、LWC、Flow 项目及全栈项目的配置、排错与流水线接入。限制包括禁止使用 MCP、Agent、Web 工具或其他技能,禁止用 which/find 查找二进制,诊断时不得用 sfdx 替代 sf;不负责执行扫描本身。