Strumenti supportati
Quali strumenti di coding IA OpenSpec supporta e la sintassi dei comandi di ciascuno.
Ogni strumento nella matrice esegue gli stessi workflow OpenSpec. Una skill e il suo comando sono le stesse istruzioni del workflow. L'unica differenza è ciò che digiti. Quale forma init installa è l'impostazione di delivery, trattata in Configura il tuo progetto.
Matrice di supporto
Le invocazioni sono mostrate per il workflow apply. Ogni workflow segue la stessa forma. L'id va in openspec init --tools <id> per saltare il selettore (CLI).
| Strumento | id --tools | Skills | Invocazione skill | Comandi | Invocazione comando |
|---|---|---|---|---|---|
| Amazon Q Developer | amazon-q | .amazonq/skills/ | /openspec-apply-change | .amazonq/prompts/ | /opsx-apply |
| Amp | amp | .agents/skills/ | /openspec-apply-change | none | none |
| Antigravity | antigravity | .agents/skills/ | /openspec-apply-change | .agents/workflows/ | /opsx-apply |
| AtomCode | atomcode | .atomcode/skills/ | /openspec-apply-change | .atomcode/commands/ | /opsx-apply |
| Auggie (Augment CLI) | auggie | .augment/skills/ | /openspec-apply-change | .augment/commands/ | /opsx-apply |
| IBM Bob | bob | .bob/skills/ | /openspec-apply-change | .bob/commands/ | /opsx-apply |
| Claude Code | claude | .claude/skills/ | /openspec-apply-change | .claude/commands/opsx/ | /opsx:apply |
| Cline | cline | .cline/skills/ | /openspec-apply-change | .clinerules/workflows/ | /opsx-apply |
| CodeArts | codeartsagent | .codeartsdoer/skills/ | /openspec-apply-change | none | none |
| CodeBuddy Code (CLI) | codebuddy | .codebuddy/skills/ | /openspec-apply-change | .codebuddy/commands/opsx/ | /opsx:apply |
| Code Studio | codestudio | .codestudio/skills/ | /openspec-apply-change | .codestudio/prompts/ | /opsx-apply |
| Codex | codex | .agents/skills/ | $openspec-apply-change | none | none |
| Continue | continue | .continue/skills/ | /openspec-apply-change | .continue/prompts/ | /opsx-apply |
| CoStrict | costrict | .cospec/skills/ | /openspec-apply-change | .cospec/openspec/commands/ | /opsx-apply |
| Crush | crush | .crush/skills/ | /openspec-apply-change | .crush/commands/opsx/ | /opsx:apply |
| Cursor | cursor | .cursor/skills/ | /openspec-apply-change | .cursor/commands/ | /opsx-apply |
| DeepSeek Harness | dsh | .dsh/skills/ | /openspec-apply-change | none | none |
| Devin Desktop (precedentemente Windsurf) | devin | .devin/skills/ | /openspec-apply-change | .devin/workflows/ | /opsx-apply |
| EasyCode | easycode | .easycode/skills/ | /openspec-apply-change | .easycode/commands/opsx/ | /opsx:apply |
| Factory Droid | factory | .factory/skills/ | /openspec-apply-change | .factory/commands/ | /opsx-apply |
| ForgeCode | forgecode | .forge/skills/ | /openspec-apply-change | none | none |
| Gemini CLI | gemini | .gemini/skills/ | /openspec-apply-change | .gemini/commands/opsx/ | /opsx:apply |
| GigaCode | gigacode | .gigacode/skills/ | /openspec-apply-change | .gigacode/commands/ | /opsx-apply |
| GitHub Copilot | github-copilot | .github/skills/ | /openspec-apply-change | .github/prompts/ | /opsx-apply |
| Grok Build | grok | .grok/skills/ | /openspec-apply-change | none | none |
| GSD | gsd | .agents/skills/ | chiedi openspec-apply-change | none | none |
| Hermes Agent | hermes | .hermes/skills/ | /openspec-apply-change | none | none |
| iFlow | iflow | .iflow/skills/ | /openspec-apply-change | .iflow/commands/ | /opsx-apply |
| Junie | junie | .junie/skills/ | /openspec-apply-change | .junie/commands/ | /opsx-apply |
| Kilo Code | kilocode | .kilocode/skills/ | /openspec-apply-change | .kilo/command/ | /opsx-apply |
| Kimi Code | kimi | .kimi-code/skills/ | /skill:openspec-apply-change | none | none |
| Kiro | kiro | .kiro/skills/ | /openspec-apply-change | .kiro/prompts/ | /opsx-apply |
| Lingma | lingma | .lingma/skills/ | /openspec-apply-change | .lingma/commands/opsx/ | /opsx:apply |
| MiniMax Code | minimax-code | ~/.minimax/skills/ (globale) | /openspec-apply-change | none | none |
| Mistral Vibe | vibe | .vibe/skills/ | /openspec-apply-change | none | none |
| Oh My Pi | oh-my-pi | .omp/skills/ | /openspec-apply-change | .omp/commands/ | /opsx-apply |
| OpenCode | opencode | .opencode/skills/ | /openspec-apply-change | .opencode/commands/ | /opsx-apply |
| Pi | pi | .pi/skills/ | /openspec-apply-change | .pi/prompts/ | /opsx-apply |
| Qoder | qoder | .qoder/skills/ | /openspec-apply-change | .qoder/commands/opsx/ | /opsx:apply |
| Qwen Code | qwen | .qwen/skills/ | /openspec-apply-change | .qwen/commands/ | /opsx-apply |
| Trae | trae | .trae/skills/ | /openspec-apply-change | .trae/commands/ | /opsx-apply |
| Veai | veai | .veai/skills/ | /openspec-apply-change | none | none |
| Warp | warp | .warp/skills/ | /openspec-apply-change | none | none |
| ZCode | zcode | .zcode/skills/ | /openspec-apply-change | .zcode/commands/opsx/ | /opsx:apply |
| Zoo Code | roocode | .roo/skills/ | /openspec-apply-change | .roo/commands/ | /opsx-apply |
| Altro / Universale | agents | .agents/skills/ | /openspec-apply-change | none | none |
- Invocazione skill: se uno strumento registra le skill come voci digitate è un comportamento dello strumento stesso. La colonna mostra la grafia che OpenSpec usa nei file generati e nel suggerimento che init stampa. Controlla la documentazione del tuo strumento se digitandolo non succede nulla.
- Formati dei file di comando: la maggior parte degli strumenti accetta file di comando
.md. EasyCode e Gemini CLI accettano.toml, Continue.prompt, e Code Studio, Kiro e GitHub Copilot.prompt.md. La grafia che digiti è la stessa in entrambi i casi.
Note per strumento
Uno strumento non elencato qui si comporta esattamente come indicato nella sua riga.
Amp
- Skill di progetto: Amp legge le skill OpenSpec da
.agents/skills/. - Nessun file di comando: Amp esegue le skill direttamente, quindi init salta la generazione dei comandi.
- Cartella condivisa: Amp condivide
.agents/skills/con Antigravity, Codex, Zed Agent, e il targetagents. OpenSpec scrive l'albero delle skill una sola volta.
Antigravity
- Cartella corrente: Antigravity v1.20.5 e versioni successive leggono le skill e i workflow del workspace da
.agents/. - Cartella legacy: dopo che OpenSpec scrive i sostituti, rimuove i file generati equivalenti da
.agent/. I file personalizzati e i file generati modificati rimangono in.agent/per la tua revisione. - Skill condivise: Antigravity condivide
.agents/skills/con Amp, Codex, Zed Agent, e il targetagents. OpenSpec scrive quell'albero delle skill una sola volta, continuando a scrivere i comandi Antigravity in.agents/workflows/.
Cline
Cline legge i comandi da .clinerules/workflows/, non dalla sua cartella .cline/. Le skill rimangono in .cline/skills/.
Codex
- CLI ed estensione IDE: menziona
$openspec-proposecon la tua idea, oppure esegui/skillsper selezionare la skill. Codex non riconosce/openspec-propose(issue upstream). - App desktop: apri Skills nella barra laterale e seleziona
openspec-propose. La documentazione delle skill di OpenAI descrive entrambe le interfacce. - Nessun file di comando: Codex esegue le skill direttamente, quindi init salta i comandi anche quando il delivery li include e stampa
Commands skipped for: codex (uses skills). - Cartella condivisa: le skill di Codex finiscono in
.agents/skills/, lo stesso albero usato da Amp, Antigravity, Zed Agent e dal targetagents. Selezionandone più di uno si mantiene un singolo albero compatibile, e i suoi handoff usano sia$openspec-*che/openspec-*quando Codex ne è il proprietario. - Percorso legacy: le skill installate sotto
.codex/skills/dalle versioni precedenti vengono migrate al prossimoopenspec update.
DeepSeek Harness
- Root del progetto: DSH usa l'antenato
.gitpiù vicino, oppure la directory corrente fuori da Git. Eseguiopenspec init --tools dshlì. Per un progetto OpenSpec annidato, aggiungi il percorso assoluto alla sua directory.dsh/skills/nelcustomSkillDirsdi DSH. Le skill nella root di Git hanno ancora la precedenza se i nomi si sovrappongono (regole di discovery upstream). - Priorità:
.dsh/skills/ha la precedenza sulle skill con lo stesso nome in.agents/skills/. - Delivery: usa
skillsoboth. Concommands, nessun workflow DSH viene installato. Cambia il delivery conopenspec config profile, poi rieseguiopenspec init --tools dsh.
Devin Desktop (precedentemente Windsurf)
- Due agenti: i file di comando in
.devin/workflows/funzionano solo in Devin Desktop. Devin Local esegue solo skill, quindi le skill generate fanno riferimento a/openspec-<skill>, che funziona in entrambi. - Rinominazione:
--tools windsurfviene ancora risolto indevin. Un progetto che contiene file OpenSpec nella cartella legacy.windsurf/riceve la proposta di spostamento al prossimoopenspec update.
GitHub Copilot
- Estensioni IDE (delivery comandi): VS Code, JetBrains e Visual Studio caricano
.github/prompts/opsx-<id>.prompt.mdcome/opsx-<id>. Se un comando scompare mentre il suo file esiste ancora, riavvia l'IDE. - Copilot CLI (delivery skill): la CLI ignora
.github/prompts/e carica.github/skills/openspec-*/SKILL.mdinvece. Invoca una skill come/openspec-<skill>. Se una skill scompare mentre il suo file esiste ancora, esegui/skills reload, poi/skills info openspec-proposeper confermare il discovery.
GSD
- Skill di progetto: GSD legge i workflow OpenSpec da
.agents/skills/. - Invocazione: chiedi a GSD di usare la skill
openspec-<workflow>. GSD può anche selezionare una skill corrispondente attraverso la sua impostazione di skill discovery. - Nessun file subagent:
.gsd/agents/contiene le definizioni dei subagent GSD. OpenSpec non scrive skill di workflow lì.
Hermes Agent
Hermes carica le skill solo da ~/.hermes/skills/ per impostazione predefinita. Aggiungi la cartella .hermes/skills/ del progetto a skills.external_dirs in ~/.hermes/config.yaml; init stampa questo promemoria dopo l'installazione.
MiniMax Code
- Solo globale: le skill vanno in
~/.minimax/skills/. Non viene scritto nulla all'interno del repo. - Sicuro tra progetti: un delivery solo comandi lascia le skill globali al loro posto, quindi l'impostazione di un progetto non può rimuovere le skill usate da un altro progetto.
Warp
- Sempre skill: le skill vanno in
.warp/skills/anche quando il delivery ècommands, perché Warp non ha file di comando e invoca le skill direttamente. - Cosa dichiara OpenSpec: solo
.warp/skills/. Le impostazioni di Warp eWARP.mdnon vengono creati né modificati.
Altro / Universale (skill .agents condivise)
- Quando è adatto: qualsiasi strumento che legge la cartella condivisa
.agents/skills/, inclusi gli strumenti senza una riga nella matrice. È la voce da scegliere quando il tuo assistente non è elencato. La casella di ricerca del selettore init lo trova conuniversal,other,generic,custom,proprietary,unlisted,unsupported,vendor-neutraloagents.md. - Insieme ad altri target: Amp, Antigravity, Codex, Zed Agent e questo target condividono un unico albero delle skill fisico. OpenSpec registra un writer in
.openspec-targete scrive l'albero una volta per esecuzione. I file di comando separati di ciascuno strumento vengono comunque generati. - Cosa dichiara OpenSpec: solo le cartelle
openspec-*e il marcatore.openspec-target. Tutto il resto sotto.agents/viene lasciato inalterato. AGENTS.md: non creato né modificato. Il target è la cartella.agents/, non il file.