Come insegnare a Cursor e Claude Code a scrivere correttamente per Salesforce

Se hai provato a generare Apex trigger o Lightning Web Components tramite ChatGPT o Cursor standard, probabilmente hai già visto gli errori tipici. Il modello confonde i contesti dei trigger, dimentica i limiti SOQL all'interno dei loop, o assembla manifest XML con versioni API obsolete. Finisci per scrivere prompt di sistema enormi e allegare manualmente snippet di documentazione a ogni richiesta.

Salesforce ha deciso di affrontare questo problema in modo sistematico e ha rilasciato un repository sf-skills. È un insieme di istruzioni pronte all'uso, modelli e script eseguibili, confezionati secondo uno standard aperto per agent skills.

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

Cosa sono gli Agent Skills

L'idea del formato è semplice. Invece di fornire a un LLM testi lunghi e non strutturati, ogni skill è organizzata come una cartella separata con un'architettura chiara:

• SKILL.md — un file obbligatorio con istruzioni e metadati in YAML front matter. Descrive quando e come l'agente deve applicare questa skill.
• scripts/ — script eseguibili in Python, Bash o JavaScript che l'agente può eseguire per la validazione o la generazione di artefatti.
• references/ — materiali di riferimento e riassunti della documentazione per un argomento specifico.
• assets/ — template pronti all'uso, schemi di metadati e tabelle di mapping.

Il repository segue la specifica agentskills.io. Questo significa che le skill non sono hardcoded per i servizi interni dell'azienda. Possono essere connesse a qualsiasi strumento che supporta questo formato aperto.

Come connettere al tuo editor

Se lavori nell'ambiente interno Agentforce Vibes, le skill vengono scaricate e aggiornate automaticamente. Per strumenti developer familiari come Claude Code, OpenCode o Cursor, la connessione richiede un solo comando da terminale:

npx skills add forcedotcom/sf-skills

L'utility scarica i bundle necessari e li registra nella configurazione dell'assistente. Dopo di che, l'agente comprende comandi e regole specifiche della piattaforma senza ulteriori chiarimenti nella chat.

Cosa c'è dentro la libreria

Il repository contiene workflow per diversi livelli della piattaforma.

La generazione di codice lato server include regole per la creazione di classi Apex, la corretta scrittura di query SOQL tenendo a mente i FLS (Field-Level Security) e template per test unitari. L'assistente smette di generare assert vuoti solo per la copertura delle linee.

Per lo sviluppo dichiarativo, ci sono skill per la creazione di oggetti personalizzati, campi e permission set. L'agente assembla file XML di metadati validi che possono essere distribuiti immediatamente tramite Salesforce CLI senza modificare manualmente i tag.

Una sezione separata è dedicata alle automazioni e alle interfacce. Questo include workflow per la creazione di Flow e Lightning Web Components (LWC), inclusi bundle UI React ausiliari.

La cartella samples contiene esempi di applicazioni pronte all'uso. Per esempio, un template di bundle UI si sincronizza direttamente con il pacchetto npm @salesforce/ui-bundle-template-app-react-sample-b2e tramite GitHub Actions. Puoi eseguire la sincronizzazione localmente:

npm install
npm run sync-react-b2e-sample

A cosa prestare attenzione

Il progetto è in fase di rielaborazione attiva. Gli sviluppatori avvertono onestamente nel README: la struttura delle cartelle e i nomi delle skill potrebbero cambiare senza compatibilità all'indietro. Non ci sono garanzie di stabilità qui, a differenza di ciò che ti aspetteresti dalle release GA delle API Salesforce.

Se fai un fork del repository o apporti modifiche locali, preparati a risolvere conflitti quando aggiorni da upstream. Attualmente, il progetto ha poco meno di 900 stelle su GitHub, ma la base di commit viene aggiornata quasi quotidianamente.

Vale la pena provare

Se scrivi regolarmente per Salesforce e usi assistenti AI nel terminale o nell'IDE, il progetto farà sicuramente risparmiare tempo. Non dovrai più ricordare manualmente al modello la struttura XML per Custom Field o spiegare le regole per scrivere classi mock per chiamate HTTP in Apex.

Il modo più semplice per iniziare è installare tramite npx skills add in un progetto di test per vedere come il tuo solito modello gestisce la generazione di metadati con le nuove istruzioni.