Da una cartella vuota
al catalogo

Passo passo

1. 1

   Scegli la sezione

   Un plugin appartiene a una sola sezione, e la sezione decide dove compare e cosa può chiedere. Se colleghi un servizio, scegli in base a cosa porti dentro: task, pull request, tabelle, quote, documenti, messaggi. Se costruisci uno strumento con la sua schermata, scegli pages. Le sezioni sono descritte una per una più sotto.

2. 2

   Scarica i modelli e apri il playground

   Il repository contiene un plugin funzionante per ogni sezione e un playground che lo disegna come fa PromptOps. Ascolta solo sul tuo computer e non richiede installazioni.

   Copia

   git clone https://github.com/shellonback/promptops-plugin-templates
   cd promptops-plugin-templates
   node playground/server.mjs

3. 3

   Copia il modello della tua sezione

   Crea la tua cartella, fuori dal repository dei modelli, con manifest, file sorgente, dati di esempio e README. Poi punta il playground su di lei. Il primo argomento è la sezione, il terzo è il tuo id: tuo-handle.nome-plugin, in minuscolo, permanente.

   Copia

   node tools/new-plugin.mjs tasks ../my-plugin your-handle.my-plugin "My Plugin"
   node playground/server.mjs --plugin ../my-plugin

4. 4

   Dichiara nel manifest ciò che ti serve

   promptops-plugin.json dà un nome al plugin ed elenca i permessi. Chiedi solo ciò che usi: le persone leggono questo elenco prima di installare, e un permesso nuovo in un aggiornamento richiede di nuovo la loro approvazione. Gli host si nominano uno per uno, net:api.example.com. Se vuoi, elenca in providers i provider AI con cui l’hai provato: il catalogo mostra i primi tre come piccole icone.

   Copia

   {
     "schemaVersion": 1,
     "id": "your-handle.my-plugin",
     "name": "My Plugin",
     "version": "0.1.0",
     "category": "tasks",
     "entry": "src/plugin.js",
     "permissions": ["net:api.example.com", "secrets", "tasks:read"],
     "providers": ["claude-code-cli"]
   }

5. 5

   Scrivi src/plugin.js

   Registri il contratto della tua sezione e restituisci dati. Li disegna PromptOps: da un plugin non arrivano mai HTML, CSS o script. L’unica via d’uscita è l’oggetto sdk. Per un token scrivi un segnaposto, {{secret:token}}, e PromptOps lo sostituisce quando la richiesta parte, solo verso un host che hai dichiarato.

   Copia

   promptops.tasks.registerSource({
     async validate(sdk) {
       const res = await sdk.http.fetch('https://api.example.com/me', {
         headers: { Authorization: 'Bearer {{secret:token}}' },
       });
       return { ok: res.ok };
     },
     async listTasks({ containerId }, sdk) { /* restituisci i task come dati */ },
   });

6. 6

   Provalo, prima senza rete

   Il playground parte in modalità Fixtures: le risposte vengono da fixtures.json, quindi funziona anche in treno. Passa a Live per chiamare il servizio vero. Ogni chiamata del tuo plugin compare nel registro, e una negata è rossa con il motivo. Premi Reload plugin dopo ogni modifica.

7. 7

   Valida

   Il validatore applica le stesse regole dell’app e del registro: manifest, permessi, codice leggibile. Stampa anche i tre valori che ti servono per l’invio.

   Copia

   node tools/validate.mjs ../my-plugin

8. 8

   Pubblica il tuo repository

   Carica la cartella in un repository GitHub pubblico sul tuo account. Tieni il codice in src/ e non minificato: quello che le persone leggono deve essere quello che gira. Se usi un bundler, committa i sorgenti accanto al suo output.

9. 9

   Invialo in revisione

   In PromptOps apri Plugins › Create plugin, scegli se pubblichi come persona o come team, e incolla versione, SHA del commit, SHA-256 del file e manifest. PromptOps scarica quel commit preciso, lo scansiona e una persona lo revisiona. Una volta approvato compare nel catalogo e qui. Per aggiornare invii una versione più alta: nessuno viene aggiornato in silenzio.