salesforce-dx — скилл для Claude Code: Salesforce DX по шагам
Скилл задаёт агенту правила разработки на Salesforce DX: Apex, триггеры, LWC, scratch orgs и выкладка через SFDX CLI.
npx skills add Mindrally/skills --skill salesforce-dx -a claude-codeЧто делает salesforce-dx
Скилл включается, когда вы пишете Apex, триггеры или Lightning Web Components, и агент держится набора соглашений. Для классов это разделение ответственности с выносом повторяющихся функций в Utility-класс, SOQL без запросов внутри циклов, свои классы исключений, проверки CRUD и FLS. Имена: PascalCase для классов, camelCase для методов и переменных, документация через ApexDocs.
Триггеры описываются по схеме один триггер на объект плюс отдельный handler-класс. Контекстные переменные используются осознанно, рекурсию гасит статический boolean-флаг, данные обрабатываются пачками. В LWC скилл советует @wire и стандартный Lightning Data Service, разметку на SLDS, ARIA-атрибуты и навигацию через force:navigateToComponent.
Для окружения — scratch org definition, package.xml, .forceignore и команды sfdx force:source:push / pull, sfdx force:org:create, sfdx force:data:tree для тестовых данных. Есть структура проекта с папками classes, lwc, triggers, objects, permissionsets и profiles. Скилл требует, чтобы новые объекты и поля появлялись только после обоснования — если в вашем проекте поля создают свободно, готовьтесь к спорам с агентом.
Какие задачи решает
- разложить логику триггера по handler-классу
- убрать SOQL-запросы из циклов
- настроить scratch org через project-scratch-def.json
- собрать package.xml для выкладки метаданных
- задокументировать классы комментариями ApexDocs
Примеры запросов агенту
- Напиши Apex-класс для расчёта скидки, вынеси общую логику в Utility и добавь проверки CRUD и FLS
- Сделай триггер на Account с отдельным handler-классом и защитой от рекурсии
- Собери LWC-компонент на lightning-record-edit-form с обработкой ошибок через lightning-card
Как установить salesforce-dx
1Через Skills CLI (Vercel)
npx skills add Mindrally/skills --skill salesforce-dx -a claude-code2Вручную: положить файлы
~/.claude/skills/salesforce-dx/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/salesforce-dx/
1Через Skills CLI (Vercel)
npx skills add Mindrally/skills --skill salesforce-dx -a codex2Вручную: положить файлы
.agents/skills/salesforce-dx/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Mindrally/skills --skill salesforce-dx -a cursor2Вручную: положить файлы
.cursor/skills/salesforce-dx/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Mindrally/skills salesforce-dx2Вручную: положить файлы
.github/skills/salesforce-dx/SKILL.md1Через Skills CLI (Vercel)
npx skills add Mindrally/skills --skill salesforce-dx -a gemini-cli2Командой платформы
gemini skills install https://github.com/Mindrally/skills --path salesforce-dxВручную: положить файлы
.devin/skills/salesforce-dx/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Mindrally/skills --skill salesforce-dx -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о salesforce-dx
Как установить salesforce-dx в Claude?
Выполните npx skills add Mindrally/skills --skill salesforce-dx -a claude-code. Файл скилла появится по пути ~/.claude/skills/salesforce-dx/SKILL.md.
Что делает salesforce-dx?
Даёт агенту правила разработки на Salesforce DX: стандарты Apex, паттерн триггеров, приёмы Lightning Web Components, работу со scratch orgs и команды SFDX CLI.
Для каких платформ подходит скилл?
Кроме Claude он ставится в Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — для каждой платформы своя команда установки.
Исходный текст
SKILL.md · Apache-2.0
--- name: salesforce-dx description: Expert guidance for Salesforce DX development with modern tooling, source-driven development, and CI/CD best practices metadata: maintainer: Mindrally source: https://github.com/Mindrally/skills --- # Salesforce DX Development You are an expert in Salesforce DX (SFDX) development, including modern Salesforce development workflows, scratch orgs, and source-driven development. ## Apex Code Standards - Implement proper separation of concerns, suggesting to move reusable functions into a Utility class - Leverage efficient SOQL queries and prevent queries within loops - Implement error handling and create custom exception classes if necessary - Apply Salesforce security best practices with CRUD and FLS validation - Use consistent naming conventions: PascalCase for class names, camelCase for method and variable names - Maintain proper indentation and code formatting - Use ApexDocs comments to document classes, methods, and complex code blocks for better maintainability - Design code to handle large datasets efficiently through bulkification ## Apex Triggers - Follow the one-trigger-per-object architectural pattern - Implement a trigger handler class to separate trigger logic from the trigger itself - Use Trigger context variables strategically for record access - Prevent recursive trigger execution with static boolean flags - Process data in bulk for performance - Apply before/after logic based on operational needs - Document triggers thoroughly with ApexDocs - Enforce CRUD and FLS checks during DML operations ## Lightning Web Components - Use the @wire decorator to efficiently retrieve data, preferring standard Lightning Data Service - Display accessible error messaging through lightning-card components - Apply SLDS for consistent design and layout - Implement ARIA attributes and keyboard navigation support - Use lightning-record-edit-form for data operations - Navigate with force:navigateToComponent events - Add lightning:availableForFlowScreens interface for Flow compatibility ## Metadata & Code Generation - Prioritize existing Salesforce objects and fields; only create new ones when necessary with documented justification - Provide complete JavaScript, HTML, CSS, Apex, and XML metadata files - Include focused comments on key design decisions - Use scratch org definition files for consistent development environments - Implement package.xml manifests for deployment management ## SFDX CLI Best Practices - Use sfdx force:source:push and sfdx force:source:pull for scratch org development - Implement proper .forceignore files to exclude unnecessary files - Use sfdx force:org:create for scratch org management - Leverage sfdx force:data:tree commands for test data management - Implement CI/CD pipelines using SFDX CLI commands ## Project Structure ``` force-app/ ├── main/ │ └── default/ │ ├── classes/ │ ├── lwc/ │ ├── triggers/ │ ├── objects/ │ ├── permissionsets/ │ └── profiles/ ├── config/ │ └── project-scratch-def.json ├── scripts/ └── sfdx-project.json ``` ## Scratch Org Configuration - Define features and settings in project-scratch-def.json - Use org shapes for complex configurations - Implement data seeding scripts for development - Configure user permissions and profiles ## Version Control Integration - Use Git for source control with meaningful commit messages - Implement branching strategies (feature branches, GitFlow) - Use pull requests for code review - Integrate with CI/CD tools (GitHub Actions, Jenkins, GitLab CI) ## Package Development - Use unlocked packages for modular development - Implement package versioning strategies - Test packages in scratch orgs before promotion - Use namespaced packages for ISV development
© Mindrally · Apache-2.0 · Mindrally/skills