Ferramentas suportadas
Quais ferramentas de codificação com IA o OpenSpec suporta e a sintaxe de comando de cada uma.
Cada ferramenta da matriz executa os mesmos fluxos de trabalho do OpenSpec. Uma skill e seu comando são as mesmas instruções do fluxo de trabalho. A única diferença é o que você digita. A forma que o init instala é a configuração de entrega, coberta em Configurar seu projeto.
Matriz de suporte
As invocações são mostradas para o fluxo de trabalho apply. Todos os fluxos seguem o mesmo formato. O id é passado para openspec init --tools <id> para pular o seletor (CLI).
| Ferramenta | id --tools | Skills | Chamada de Skill | Comandos | Chamada de Comando |
|---|---|---|---|---|---|
| Amazon Q Developer | amazon-q | .amazonq/skills/ | /openspec-apply-change | .amazonq/prompts/ | @opsx-apply |
| Amp | amp | .agents/skills/ | /openspec-apply-change | nenhum | nenhum |
| 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 | nenhum | nenhum |
| 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 | nenhum | nenhum |
| 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 | nenhum | nenhum |
| Devin Desktop (antigo 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 | nenhum | nenhum |
| 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 | nenhum | nenhum |
| GSD | gsd | .agents/skills/ | solicite openspec-apply-change | nenhum | nenhum |
| Hermes Agent | hermes | .hermes/skills/ | /openspec-apply-change | nenhum | nenhum |
| 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 | nenhum | nenhum |
| 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/ (global) | /openspec-apply-change | nenhum | nenhum |
| Mistral Vibe | vibe | .vibe/skills/ | /openspec-apply-change | nenhum | nenhum |
| 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 | nenhum | nenhum |
| Warp | warp | .warp/skills/ | /openspec-apply-change | nenhum | nenhum |
| ZCode | zcode | .zcode/skills/ | /openspec-apply-change | .zcode/commands/opsx/ | /opsx:apply |
| Zoo Code | roocode | .roo/skills/ | /openspec-apply-change | .roo/commands/ | /opsx-apply |
| Outro / Universal | agents | .agents/skills/ | /openspec-apply-change | nenhum | nenhum |
- Chamada de Skill: se uma ferramenta registra skills como entradas digitadas é um comportamento próprio da ferramenta. A coluna mostra a grafia que o OpenSpec usa nos arquivos gerados e na dica que o init exibe. Consulte a documentação da sua ferramenta se digitá-la não fizer nada.
- Formatos de arquivo de comando: a maioria das ferramentas aceita arquivos de comando
.md. EasyCode e Gemini CLI aceitam.toml, Continue.prompt, e Code Studio, Kiro e GitHub Copilot.prompt.md. A grafia que você digita é a mesma de qualquer forma.
Notas por ferramenta
Uma ferramenta não listada aqui se comporta exatamente como descrito em sua linha.
Amp
- Skills do projeto: o Amp lê as skills do OpenSpec de
.agents/skills/. - Sem arquivos de comando: o Amp executa as skills diretamente, então o init ignora a geração de comandos.
- Pasta compartilhada: o Amp compartilha
.agents/skills/com Antigravity, Codex, Zed Agent e o alvoagents. O OpenSpec grava a árvore de skills uma única vez.
Antigravity
- Pasta atual: Antigravity v1.20.5 e posteriores leem skills e fluxos de trabalho do workspace de
.agents/. - Pasta legada: após o OpenSpec gravar as substituições, ele remove arquivos gerados equivalentes de
.agent/. Arquivos personalizados e arquivos gerados alterados permanecem em.agent/para você revisar. - Skills compartilhadas: Antigravity compartilha
.agents/skills/com Amp, Codex, Zed Agent e o alvoagents. O OpenSpec grava essa árvore de skills uma vez, enquanto ainda grava os comandos do Antigravity em.agents/workflows/.
Cline
O Cline lê comandos de .clinerules/workflows/, e não de sua pasta .cline/. As skills permanecem em .cline/skills/.
Codex
- CLI e extensão IDE: mencione
$openspec-proposecom sua ideia, ou execute/skillspara selecionar a skill. O Codex não reconhece/openspec-propose(issue upstream). - Aplicativo Desktop: abra Skills na barra lateral e selecione
openspec-propose. A documentação de skills da OpenAI descreve ambas as interfaces. - Sem arquivos de comando: o Codex executa as skills diretamente, então o init ignora comandos mesmo quando a entrega os inclui e exibe
Commands skipped for: codex (uses skills). - Pasta compartilhada: as skills do Codex ficam em
.agents/skills/, a mesma árvore usada por Amp, Antigravity, Zed Agent e o alvoagents. Selecionar mais de um mantém uma única árvore compatível, e seus handoffs contêm tanto$openspec-*quanto/openspec-*quando o Codex é o proprietário. - Caminho legado: skills instaladas em
.codex/skills/por versões anteriores são migradas no próximoopenspec update.
DeepSeek Harness
- Raiz do projeto: o DSH usa o ancestral
.gitmais próximo, ou o diretório atual fora do Git. Executeopenspec init --tools dshali. Para um projeto OpenSpec aninhado, adicione o caminho absoluto de seu diretório.dsh/skills/acustomSkillDirsdo DSH. Skills na raiz do Git ainda têm precedência se os nomes coincidirem (regras de descoberta upstream). - Prioridade:
.dsh/skills/tem precedência sobre skills de mesmo nome em.agents/skills/. - Entrega: use
skillsouboth. Comcommands, nenhum fluxo de trabalho do DSH é instalado. Altere a entrega comopenspec config profilee execute novamenteopenspec init --tools dsh.
Devin Desktop (antigo Windsurf)
- Dois agentes: arquivos de comando em
.devin/workflows/funcionam apenas no Devin Desktop. O Devin Local executa apenas skills, portanto as skills geradas referenciam/openspec-<skill>, que funciona em ambos. - Renomeação:
--tools windsurfainda resolve paradevin. Um projeto que contenha arquivos OpenSpec na pasta legada.windsurf/recebe a oferta de movê-los no próximoopenspec update.
GitHub Copilot
- Extensões IDE (entrega por comando): VS Code, JetBrains e Visual Studio carregam
.github/prompts/opsx-<id>.prompt.mdcomo/opsx-<id>. Se um comando desaparecer enquanto seu arquivo ainda existir, reinicie a IDE. - Copilot CLI (entrega por skill): o CLI ignora
.github/prompts/e carrega.github/skills/openspec-*/SKILL.mdem vez disso. Invoque uma skill como/openspec-<skill>. Se uma skill desaparecer enquanto seu arquivo ainda existir, execute/skills reloade depois/skills info openspec-proposepara confirmar a descoberta.
GSD
- Skills do projeto: o GSD lê os fluxos de trabalho do OpenSpec de
.agents/skills/. - Chamada: peça ao GSD para usar a skill
openspec-<workflow>. O GSD também pode selecionar uma skill correspondente por meio de sua configuração de descoberta de skills. - Sem arquivos de subagentes:
.gsd/agents/contém definições de subagentes do GSD. O OpenSpec não grava skills de fluxo de trabalho ali.
Hermes Agent
O Hermes carrega skills apenas de ~/.hermes/skills/ por padrão. Adicione a pasta .hermes/skills/ do projeto a skills.external_dirs em ~/.hermes/config.yaml; o init exibe esse lembrete após a instalação.
MiniMax Code
- Somente global: as skills vão para
~/.minimax/skills/. Nada é gravado dentro do repositório. - Seguro entre projetos: uma entrega apenas de comandos deixa as skills globais no lugar, de modo que a configuração de um projeto não pode remover skills que outro projeto usa.
Warp
- Sempre skills: as skills vão para
.warp/skills/mesmo quando a entrega écommands, porque o Warp não tem arquivos de comando e invoca as skills diretamente. - O que o OpenSpec reivindica: apenas
.warp/skills/. Configurações do Warp eWARP.mdnão são criados ou editados.
Outro / Universal (skills compartilhadas em .agents)
- Quando se encaixa: qualquer ferramenta que lê a pasta compartilhada
.agents/skills/, incluindo ferramentas sem linha na matriz. É a entrada a escolher quando seu assistente não está listado. A caixa de busca do seletor do init a encontra poruniversal,other,generic,custom,proprietary,unlisted,unsupported,vendor-neutralouagents.md. - Junto com outros alvos: Amp, Antigravity, Codex, Zed Agent e este alvo compartilham uma árvore física de skills. O OpenSpec registra um gravador em
.openspec-targete grava a árvore uma vez por execução. Os arquivos de comando separados de cada ferramenta ainda são gerados. - O que o OpenSpec reivindica: apenas as pastas
openspec-*e o marcador.openspec-target. Qualquer outra coisa em.agents/é deixada intacta. AGENTS.md: não é criado nem editado. O alvo é a pasta.agents/, não o arquivo.