Comment apprendre à Cursor et Claude Code à bien écrire pour Salesforce

Si vous avez déjà essayé de générer des déclencheurs Apex ou des composants Lightning Web via ChatGPT ou Cursor standard, vous avez probablement rencontré les erreurs typiques. Le modèle confond les contextes de déclencheurs, oublie les limites SOQL dans les boucles, ou assemble des manifestes XML avec des versions d'API obsolètes. Vous finissez par écrire d'énormes invites système et attacher manuellement des extraits de documentation à chaque requête.

Salesforce a décidé de s'attaquer systématiquement à ce problème et a publié un dépôt sf-skills. C'est un ensemble d'instructions prêtes à l'emploi, de modèles et de scripts exécutables, package selon une norme ouverte d'agent skills.

sf-skills/
├── skills/               # Директории с конкретными воркфлоу
│   ├── platform-apex-generate/
│   ├── platform-custom-object-generate/
│   ├── automation-flow-generate/
│   └── ...
├── samples/              # Примеры приложений
└── scripts/

Qu'est-ce que les Agent Skills

L'idée du format est simple. Au lieu de fournir à un LLM du texte long et non structuré, chaque skill est organisé dans un dossier séparé avec une architecture claire :

• SKILL.md — un fichier obligatoire avec des instructions et des métadonnées en YAML front matter. Il décrit quand et comment l'agent doit appliquer ce skill.
• scripts/ — des scripts exécutables en Python, Bash ou JavaScript que l'agent peut exécuter pour la validation ou la génération d'artefacts.
• references/ — des documents de référence et des résumés de documentation pour un sujet spécifique.
• assets/ — des modèles prêts à l'emploi, des schémas de métadonnées et des tables de correspondance.

Le dépôt suit la spécification agentskills.io. Cela signifie que les skills ne sont pas codés en dur pour les services internes de l'entreprise. Ils peuvent être connectés à n'importe quel outil qui prend en charge ce format ouvert.

Comment se connecter à votre éditeur

Si vous travaillez dans l'environnement interne Agentforce Vibes, les skills sont automatiquement récupérés et mis à jour. Pour les outils de développement familiers comme Claude Code, OpenCode ou Cursor, la connexion se fait via une seule commande terminal :

npx skills add forcedotcom/sf-skills

L'utilitaire télécharge les bundles requis et les enregistre dans la configuration de l'assistant. Après cela, l'agent comprend les commandes et les règles spécifiques à la plateforme sans clarification supplémentaire dans le chat.

Ce qu'il y a à l'intérieur de la bibliothèque

Le dépôt contient des workflows pour différentes couches de la plateforme.

La génération de code côté serveur inclut des règles pour créer des classes Apex, une écriture correcte des requêtes SOQL en tenant compte du FLS (Field-Level Security) et des modèles pour les tests unitaires. L'assistant cesse de générer des assertions vides juste pour la couverture de lignes.

Pour le développement déclaratif, il existe des skills pour créer des objets personnalisés, des champs et des ensembles d'autorisations. L'agent assemble des fichiers de métadonnées XML valides qui peuvent être déployés immédiatement via Salesforce CLI sans édition manuelle des balises.

Une section distincte est dédiée aux automatisations et aux interfaces. Cela inclut des workflows pour créer des Flow et des composants Lightning Web (LWC), y compris des bundles UI React auxiliaires.

Le dossier samples contient des exemples d'applications prêtes à l'emploi. Par exemple, un modèle de bundle UI se synchronise directement avec le package npm @salesforce/ui-bundle-template-app-react-sample-b2e via GitHub Actions. Vous pouvez exécuter la synchronisation localement :

npm install
npm run sync-react-b2e-sample

Ce qu'il faut surveiller

Le projet est en cours de refonte active. Les développeurs préviennent honnêtement dans le README : la structure des dossiers et les noms des skills peuvent changer sans compatibilité descendante. Il n'y a pas de garanties de stabilité ici, contrairement à ce que vous attendriez des versions GA de l'API Salesforce.

Si vous forkez le dépôt ou apportez des modifications locales, préparez-vous à résoudre les conflits lors de la mise à jour depuis l'amont. Actuellement, le projet a un peu moins de 900 étoiles sur GitHub, mais la base de commits est mise à jour presque quotidiennement.

Cela vaut-il la peine d'essayer

Si vous écrivez régulièrement pour Salesforce et utilisez des assistants IA dans le terminal ou l'IDE, le projet vous fera certainement gagner du temps. Vous n'aurez plus besoin de rappeler manuellement au modèle la structure XML pour Custom Field ou d'expliquer les règles pour écrire des classes mock pour les appels HTTP en Apex.

Le moyen le plus simple de commencer est d'installer via npx skills add dans un projet de test pour voir comment votre modèle habituel gère la génération de métadonnées avec les nouvelles instructions.