面向 Salesforce 开发的 Agentic Coding 技能库,提供 36 项可复用技能、7 个专职 Agent 及自动化验证 Hook,覆盖 Apex、Flow、LWC、SOQL、Agentforce、Data Cloud 等场景。
sf-skills 是由 Salesforce Certified Technical Architect Jag Valaiyapathy 维护的开源项目(MIT 许可证,版本 4.0.0),专为 Claude Code 等 AI 编码代理设计,将 Salesforce 开发全栈能力封装为可复用技能。
技能覆盖#
项目提供 10 大能力域共 36 项技能:
- Development:sf-apex、sf-flow、sf-lwc、sf-soql
- Quality:sf-testing、sf-debug
- Foundation:sf-metadata、sf-data、sf-docs、sf-permissions
- Integration:sf-connected-apps、sf-integration
- Planning:sf-flex-estimator(Flex Credit 估算与成本优化)
- Data Cloud:7 项技能覆盖连接、摄取、协调、分段、激活、检索全生命周期(Beta/Community Preview)
- AI & Automation:6 项技能覆盖 Agentforce 全链路(设计、Agent Script、测试、可观测性、Persona、Grid)
- DevOps & Tooling:sf-deploy、sf-vlocity-build-deploy、sf-diagram-mermaid、sf-diagram-nanobananapro
- Industries:6 项 OmniStudio 技能(EPC、Data Mappers、Integration Procedures、FlexCards 等)
Agent 团队#
7 个专职 Agent 角色:FDE 团队(fde-strategist 编排、fde-engineer 配置、fde-experience-specialist 对话设计)+ 跨域代理(fde-qa-engineer 测试、fde-release-engineer 部署)+ PS 团队(ps-technical-architect、ps-solution-architect)。fde-strategist 最多调度 4 个并发工作线程。
自动验证 Hook 系统#
每次文件写入/编辑后自动触发验证链路:
- Apex (.cls/.trigger):Prettier 格式化 → Apex LSP 编译检查 → 90 分评分器 → Code Analyzer PMD
- Flow (.flow-meta.xml):110 分评分 → Code Analyzer Flow Scanner
- LWC JS:LWC LSP → 165 分 SLDS 评分器 → ESLint → retire-js
- LWC HTML:模板反模式验证
- SOQL:100 分评分 → Live Query Plan API
- Agent Script (.agent):语法验证 → LSP 自动修复循环
LSP 集成与自动修复#
支持三种语言服务器:apex-jorje-lsp.jar(Java 11+)、@salesforce/lwc-language-server(Node.js 18+)、Agent Script Language Server(Node.js 18+)。自动修复循环:写入 → LSP 验证(~500ms)→ 发现错误 → Claude 诊断并修复 → 最多 3 次重试。
Hook 生命周期#
- SessionStart:会话目录生命周期初始化
- PreToolUse (Bash/MCP):护栏提示(sfdx 弃用警告、旧 API 版本警告)
- PreToolUse (Bash):SOQL Schema JIT 验证(sf sobject describe)
- PostToolUse (Write/Edit):验证分发器 → Prettier + LSP + Scorer + Code Analyzer
- PostToolUse (Bash):Debug Log 分析(异常检测、Governor Limits、性能热点)
安装方式#
- npx(仅技能):
npx skills add Jaganpro/sf-skills - Claude Code 完整安装(推荐):
curl -sSL https://raw.githubusercontent.com/Jaganpro/sf-skills/main/tools/install.sh | bash,含 36 技能 + 7 代理 + Hook 系统 + LSP 引擎 + 护栏规则 - Python 安装器(Windows/CI):
curl -sSL https://raw.githubusercontent.com/Jaganpro/sf-skills/main/tools/install.py | python3
前置条件:Node.js 18+、Python 3.10+、Salesforce CLI v2.x、API 62.0+(Agentforce 需 66.0+)、已认证 Salesforce Org、sfdx-project.json。
待确认信息#
- Data Cloud 运行时依赖外部 gthoppae/sf-cli-plugin-data360,非本仓库一部分,独立许可证和稳定性待确认
- Claude Code 仅标注"latest version",未明确最低兼容版本
- README 标题写"14 skills, 420+ validation points",正文描述为 36 skills,可能为标题未同步更新
- 各评分器(90/100/110/165 分)的具体评分维度与扣分规则未在材料中体现