Configura il tuo ecosistema di plugin

• plugin-template — un punto di partenza per creare un singolo plugin (o un paio di plugin).
• team-marketplace-template — il modello completo dell’ecosistema: un monorepo di plugin più un meta-plugin il cui manifest definisce la tua base e la tua policy.

​

1. Crea i tuoi plugin

my-plugin/
├── .devin-plugin/
│   └── plugin.json     # name, version, dependency + policy lists
├── AGENTS.md           # always-on rule
├── rules/              # triggered rules
├── agents/<name>.md   # subagent personalizzati (solo CLI/Desktop al momento); agents/<name>/AGENT.md funziona anche
├── hooks.json          # lifecycle hooks
├── .mcp.json           # MCP servers
└── skills/<name>/SKILL.md   # skills, exposed as /<plugin>:<skill>

​

2. Verifica e testa in locale

devin plugins install --local ./plugins/my-plugin   # collegato, solo su questa machine: le modifiche vengono applicate alla sessione successiva
devin plugins list

​

3. Ospitali in un’unica repo

​

4. Definisci la base con un meta-plugin

// .devin-plugin/plugin.json (radice del repo)
{
  "name": "team-starter-pack",
  "requiredPlugins": [
    // installato automaticamente per tutti, in modo ricorsivo
    { "source": "git-subdir", "url": "https://github.com/acme/plugins.git", "path": "plugins/engineering-baseline" },
    { "source": "git-subdir", "url": "https://github.com/acme/plugins.git", "path": "plugins/security-guardrails" }
  ],
  "optionalPlugins": [
    // approvato, non installato automaticamente; costituisce anche un'eccezione ai divieti di questo manifest
    { "source": "git-subdir", "url": "https://github.com/acme/plugins.git", "path": "plugins/frontend-standards" }
  ],
  "forbiddenPlugins": [
    "untrusted-vendor/*"
  ]
}

​

5. Distribuzione da Customize

{
  "requiredPlugins": ["acme/plugins"]
}

• Il manifest enterprise raggiunge tutte le organizzazioni dell’enterprise.
• Un manifest a livello di organizzazione raggiunge le sessioni cloud di quell’organizzazione e la CLI/Desktop dei membri per i quali è l’organizzazione principale.

​

6. Governare

{
  "forbiddenPlugins": ["*"],
  "requiredPlugins": [
    "acme/plugins",
    { "source": "git-subdir", "url": "https://github.com/acme/plugins.git", "path": "plugins/engineering-baseline" },
    { "source": "git-subdir", "url": "https://github.com/acme/plugins.git", "path": "plugins/security-guardrails" }
  ],
  "optionalPlugins": [
    { "source": "git-subdir", "url": "https://github.com/acme/plugins.git", "path": "plugins/frontend-standards" }
  ]
}

​

7. Evoluzione

• Il merge nel branch predefinito del repo del tuo plugin è il rilascio: le nuove sessioni lo recepiscono automaticamente — vedi come vengono distribuiti gli aggiornamenti.
• I team aggiungono plugin tramite PR al repo del marketplace; la CI del template convalida la struttura a ogni PR.
• I plugin Claude esistenti si installano così come sono (Devin usa .claude-plugin/plugin.json come fallback), quindi puoi includere plugin della community in optionalPlugins senza doverli incorporare nella repo.

​

Limitazioni attuali

• I plugin vengono caricati nelle sessioni cloud, nel Devin CLI e in Devin Desktop (quando si usa Devin Local); non si applicano però all’agente Cascade classico.
• I Subagents (agents/<name>.md o agents/<name>/AGENT.md) vengono caricati solo negli agenti Devin locali (CLI e Devin Desktop), non nelle sessioni cloud.
• Gli Hooks operano attualmente al meglio e senza bloccare in caso di errore: un hook che non riesce a caricarsi o a essere eseguito non interrompe la sessione; pertanto, non fare ancora affidamento su di essi per barriere di sicurezza cruciali. Consulta il riferimento agli hook della CLI per la configurazione locale.
• La governance non blocca in caso di errore: se non è possibile recuperare un manifest gestito all’avvio della sessione, i plugin di quel livello non vengono installati e i relativi divieti non vengono applicati per quella sessione.
• Il contenuto dei plugin proveniente da un repo privato compare in Customize solo per le organizzazioni la cui integrazione Git è in grado di raggiungere il repo; altrimenti viene nascosto fino a quando il repo non viene autorizzato in Settings → Repositories.

​

Per saperne di più

• Guida ai plugin — il lato app web: Customize, ambiti, indicizzazione, MCP
• Riferimento sui plugin CLI — formato dei file, creazione, installazioni per utente
• Skills — le procedure SKILL.md incluse nei bundle dei plugin