Salesforce Skill

核心用法

Salesforce CLI（sf）是 Salesforce 官方推出的命令行工具，提供对 Salesforce 平台的完整编程接口。核心能力覆盖：

• 数据查询：SOQL 标准查询、SOSL 跨对象全文搜索、Bulk API 2.0 批量导出/导入（支持百万级记录）
• 记录操作：单条记录的创建、更新、删除（需用户确认），以及基于外部 ID 的批量 upsert
• 开发运维：Apex 代码执行与测试、元数据部署/检索、原始 REST/GraphQL API 调用
• 组织管理：多 org 认证与切换、JWT/浏览器/Web 等多种登录方式

显著优点

1. 官方背书：由 Salesforce 团队直接维护，API 同步更新，功能覆盖全面
2. 企业级批量能力：Bulk API 2.0 支持异步处理超大数据集，内置作业恢复机制
3. 开发工作流整合：与 Salesforce DX 项目结构、CI/CD 流水线深度集成
4. 灵活认证：支持交互式浏览器登录、JWT 无人值守、SFDX URL 共享等多种场景
5. 结构化输出：--json 标志确保所有命令返回可解析的标准化数据

潜在缺点与局限

• 学习曲线陡峭：需掌握 SOQL/SOSL 语法、Salesforce 对象模型及元数据概念
• Bulk API 功能裁剪：Bulk 2.0 不支持聚合函数（COUNT/SUM/AVG），需回退到标准查询
• 权限敏感：--verbose 模式可能暴露 refresh token，需严格管控
• 网络依赖：所有操作需实时连接 Salesforce 云端，离线不可用
• 数据操作风险：删除/更新命令直接生效，虽有 guardrails 但仍需人工二次确认

适合人群

• Salesforce 管理员与开发者（Apex/LWC 开发）
• 数据工程师（CRM 数据迁移、ETL 集成）
• DevOps 工程师（元数据版本控制、自动化部署）
• 需批量处理客户数据的企业 IT 团队

常规风险

• 数据误删：sf data delete 与 sf data delete bulk 不可逆，操作前必须确认记录范围
• 认证泄露：JWT 私钥、SFDX auth URL 含长期有效令牌，需加密存储
• API 限流：Bulk API 与标准 API 均有每日调用上限，超量会触发平台限制
• 生产环境误操作：默认 org 配置错误可能导致开发脚本作用于生产数据

核心用法

本Skill是对Salesforce官方CLI (sf) 的标准化封装，提供企业级CRM数据管理能力。核心功能覆盖六大领域：

数据查询与分析：支持SOQL（标准对象查询语言）和SOSL（全文搜索），可执行基础查询、关联查询、聚合分析，支持CSV/JSON多格式导出。对于超大数据集（>10,000条），自动切换至Bulk API 2.0高效导出。

记录生命周期管理：完整的CRUD操作——创建、读取、更新、删除单条或批量记录，支持通过ID或字段条件定位目标，内置工具API对象操作能力。

Apex代码执行：可运行Apex脚本、执行测试类、查看调试日志，满足开发者诊断需求。

元数据部署：支持Salesforce DX项目部署、元数据检索、组件清单管理，适配CI/CD流程。

REST API原生调用：提供底层sforce_api_request_rest和sforce_api_request_graphql工具，可访问任意Salesforce API端点。

多组织管理：支持多org认证、别名配置、快速切换，适配多租户企业环境。

显著优点

• 官方工具背书：基于Salesforce官方维护的@salesforce/cli，与企业平台安全策略完全对齐
• 完整功能覆盖：从简单查询到复杂Bulk操作、从数据管理到元数据部署，无功能缺口
• 结构化输出友好：所有命令默认附加--json，便于Agent解析处理
• 企业级安全设计：JWT认证支持CI/CD场景，OAuth Web登录适配人工交互，访问令牌管理规范
• Bulk API 2.0集成：内置大批量数据导出/导入/upsert能力，自动处理异步作业状态轮询

潜在缺点与局限性

• 认证门槛：必须先完成sf org login web或JWT配置才能使用，首次 setup 成本较高
• 环境依赖：需预装Node.js/npm或独立CLI二进制文件，对无权限安装环境不友好
• SOQL学习曲线：非SQL用户需掌握Salesforce特定的对象关系语法（如__c后缀、关系查询语法）
• Bulk API限制：聚合函数（COUNT/SUM等）在Bulk API 2.0中受限，复杂分析需切换标准查询
• 树形数据导入复杂度：data import tree需理解计划文件和父子关系配置，文档操作门槛较高

适合人群

• Salesforce管理员与开发者（日常数据维护、调试、部署）
• 企业IT运维（多org数据同步、批量数据清洗）
• BI/数据分析团队（SOQL数据提取、报表数据源准备）
• 集成开发者（REST API封装、自定义工具链构建）

常规风险

• 误操作数据丢失：delete和bulk delete为不可逆操作，Skill已内置"需用户显式确认"的强制护栏
• 凭证泄露：sf org display --verbose会输出含refresh token的敏感URL，需避免日志泄露
• 生产环境误触：建议始终使用--target-org明确指定目标，避免default org配置错误导致生产数据变更
• SOQL注入式查询：虽然SOQL无传统SQL注入风险，但不当的字符串拼接仍可能导致意外数据暴露
• API限流：Bulk API和标准API均有并发和日调用上限，大规模操作需关注Salesforce组织限制

使用建议

首次使用务必执行认证流程：sf org login web --alias my-org。查询数据时始终从LIMIT 10开始验证结果，确认无误后再扩大范围。涉及写操作（create/update/delete）时，Skill会主动描述操作影响并请求确认，请勿绕过此机制。