用途：指导 Salesforce 项目开发任务，统一使用现代 sf CLI（v2+），不使用旧版 sfdx。适用于包含 sfdx-project.json、.forceignore 或 force-app/ 目录的项目，以及 .cls、.trigger、Lightning Web Component 等元数据。
主要能力：部署与检索元数据、运行 Apex 测试与获取覆盖率、生成 Apex 类/触发器/LWC/Aura 组件、对比本地文件与组织版本、检索本地尚未存在的组织元数据、组织管理（查看/设置默认组织、打开组织）。
使用方式：所有 sf 命令加 --json（例外：sf apex run test 用 -r human 直接展示结果，sf generate 命令生成本地文件）。部署/检索默认按单文件 -d 或命名组件 -m，不用通配符或 package.xml，除非用户明确要求。操作前确认项目根含 sfdx-project.json 或 .forceignore，并显式传 -o <alias> 指定目标组织。Apex 测试默认只跑用户指定的方法 -t 或类 -n，使用 -w 180。临时目录须建在项目根内（如 ./temp/sf-diff-XXXXXX），并加入 .gitignore。
限制：本地仓库通常只含当前工作相关元数据，force-app/ 为空或部分属正常。每次部署、检索或测试后需解析 --json 输出，状态非 Succeeded 或退出码非零时先报告错误。不得在无明确指示下运行 RunAllTestsInOrg 或 RunLocalTests，不得使用 /tmp/ 等系统路径。实现前需确认 .prettierrc 存在并验证 prettier 与 apex 插件可用。具体错误恢复、覆盖率流程、元数据类型映射等细节见 references/ 下文档。