Chiedi a un assistente IA di scriverti un client WebSocket in Delphi e otterrai qualcosa di sicuro di sé, ben strutturato e sottilmente sbagliato. Una proprietà che non esiste. Un componente collocato nella unit sbagliata. Un'API rimossa tre release fa. Poi passi venti minuti a scoprire quale delle quattro righe plausibili è quella che non compila.
Il motivo è semplice. Questi modelli hanno imparato da codice pubblico, e i componenti eSeGeCe sono commerciali, perciò il modello non li ha mai letti. Conosce la forma di una libreria di componenti Delphi e riempie il resto con il ricordo di altre librerie.
Abbiamo pubblicato delle skill per agenti per colmare questa lacuna. Sono gratuite, distribuite con licenza MIT, e non serve una licenza per installarle.
Che cos'è una skill per agenti
Una skill è una cartella di file Markdown che un agente carica su richiesta. Le nostre contengono l'API pubblica di ogni libreria: ogni componente, le sue proprietà, i suoi eventi e i suoi metodi, la unit o il namespace in cui si trova, l'edizione che lo include ed esempi reali tratti dalle demo distribuite con il prodotto. Vengono generate dal codice sorgente della libreria a ogni release, perciò descrivono la versione che hai davvero anziché quella che il modello ricorda a metà.
Tutto si trova in un unico repository, github.com/esegece-com/agent-skills, distribuito sotto forma di sei plugin.
Installazione
In Claude Code e GitHub Copilot CLI, aggiungi il marketplace una sola volta e installa i plugin che ti servono:
/plugin marketplace add esegece-com/agent-skills
/plugin install sgcwebsockets-delphi@esegeceIn Codex CLI:
codex plugin marketplace add esegece-com/agent-skills
codex plugin add sgcwebsockets-delphi@esegeceIn VS Code, apri la Command Palette ed esegui "Chat: Install Plugin From Source". Per Cursor e per qualsiasi altro agente che legge una cartella di skill, copia la cartella della skill dal repository in .cursor/skills/, .claude/skills/, .github/skills/, .agents/skills/ oppure .junie/skills/, a seconda dell'agente.
I sei plugin sono sgcwebsockets-delphi, sgcwebsockets-dotnet, sgcsign-delphi, sgcopenapi-delphi, sgcindy-delphi e sgcbiometrics-delphi.
Perché sgcWebSockets sono 18 skill, non una
sgcWebSockets registra 222 componenti. Un'unica skill che li coprisse tutti sarebbe troppo grande per essere utile: l'agente caricherebbe l'intera libreria per rispondere a una domanda su MQTT. Perciò è suddivisa per aree, 18 skill che coprono il nucleo WebSocket, i broker di messaggi, i sottoprotocolli sgc, i feed degli exchange, AI e LLM, le integrazioni di servizi, HTTP e trasporti, l'autenticazione, P2P e WebRTC, l'IoT, e altre sei per i widget sgcHTML.
Un agente a cui viene chiesto di collegarsi a un broker MQTT carica la skill dei broker di messaggi e nient'altro. Il plugin .NET segue la stessa idea con 7 skill.
Che cosa contiene una skill
Ogni skill si apre con un playbook scritto a mano: a che cosa serve la skill, la clausola uses o la direttiva using di cui hai bisogno, le domande che vale la pena porre allo sviluppatore prima di scrivere codice e gli errori in cui si cade davvero. Poi arriva il materiale generato, il riferimento completo dell'API con la firma sia Delphi sia C++Builder di ogni membro, C# per il plugin .NET, le pagine dei tipi opzione ed enumerazione così che l'agente usi una costante che esiste, esempi distillati dalle demo distribuite con il prodotto e l'edizione richiesta da ciascun componente.
Quest'ultimo punto risparmia un tipo ben preciso di pomeriggio sprecato. "Il componente non è nella mia palette" di solito è una questione di edizione, non di installazione, e la skill risponde prima ancora che tu lo chieda.
Parliamo chiaro su .NET
L'assembly .NET distribuito espone 70 dei 222 componenti che la libreria Delphi registra. Anziché lasciare che un agente tiri a indovinare, il plugin .NET include una pagina di copertura generata che elenca i 152 disponibili solo in Delphi, con la unit in cui ciascuno si trova. Un agente che altrimenti inventerebbe un'API C# plausibile ora ha un posto dove guardare, e la risposta onesta a "posso farlo in C#" è a una pagina di distanza.
Privacy
Una skill è documentazione. Non esegue nulla, non invia nulla da nessuna parte e non raccoglie alcuna telemetria. Le skill contengono soltanto l'API public e published, perciò i corpi dei metodi, i campi private e i membri protected sono esclusi deliberatamente. Installarle non mette il codice sorgente della libreria sul tuo disco né su quello di altri.
Mantenerle aggiornate
Le skill vengono rigenerate dal codice sorgente della libreria a ogni release, perciò seguono il prodotto anziché restare indietro. Riesegui il comando di installazione per ottenere una nuova versione. Se un'API presente nel tuo codice non corrisponde a quella descritta dall'agente, controlla reference/history.md all'interno della skill, perché di solito la spiegazione è che tu e l'agente state lavorando su build diverse.
Tutti i dettagli e i percorsi di installazione manuale sono nella pagina delle skill per agenti IA.
Se un agente sbaglia ancora qualcosa con le skill installate, si tratta di un errore nella documentazione e ci farebbe piacere saperlo. Apri una issue su GitHub oppure contattaci — riceverai una risposta dalle persone che hanno scritto il codice.