Comandos

Esta é a referência para os comandos de barra do OpenSpec. Esses comandos são invocados na interface de chat do seu assistente de codificação com IA (por exemplo, Claude Code, Cursor, Devin Desktop).

Para padrões de fluxo de trabalho e quando usar cada comando, consulte Workflows. Para comandos CLI, consulte CLI.

Estas páginas usam /opsx:<command> como nome canônico. Algumas ferramentas o escrevem de forma diferente — Cursor e GitHub Copilot registram /opsx-propose, Codex usa $openspec-propose — então verifique How To Invoke para sua ferramenta. Os arquivos gerados pelo OpenSpec já usam a forma correta.

Referência Rápida

Caminho Rápido Padrão (perfil `core`)

Comando	Objetivo
`/opsx:propose`	Criar uma mudança e gerar artefatos de planejamento em uma única etapa
`/opsx:explore`	Pensar em ideias antes de se comprometer com uma mudança
`/opsx:apply`	Implementar tarefas da mudança
`/opsx:update`	Revisar os artefatos de planejamento de uma mudança e mantê-los coerentes
`/opsx:sync`	Mesclar especificações delta nas especificações principais
`/opsx:archive`	Arquivar uma mudança concluída

Comandos de Fluxo de Trabalho Avançado (seleção de fluxo de trabalho personalizado)

Comando	Objetivo
`/opsx:new`	Iniciar um novo arcabouço de mudança
`/opsx:continue`	Criar o próximo artefato com base nas dependências
`/opsx:ff`	Avanço rápido: criar todos os artefatos de planejamento de uma só vez
`/opsx:verify`	Validar se a implementação corresponde aos artefatos
`/opsx:bulk-archive`	Arquivar várias mudanças de uma só vez
`/opsx:onboard`	Tutorial guiado pelo fluxo de trabalho completo

O perfil global padrão é core. Para habilitar os comandos de fluxo de trabalho avançados, execute openspec config profile, selecione os fluxos de trabalho e depois execute openspec update no seu projeto.

Referência de Comandos

`/opsx:propose`

Crie uma nova mudança e gere os artefatos de planejamento em uma única etapa. Este é o comando inicial padrão no perfil core.

Sintaxe:

text

/opsx:propose [nome-ou-descrição-da-mudança]

Argumentos:

Argumento	Obrigatório	Descrição
`nome-ou-descrição-da-mudança`	Não	Nome em kebab-case ou descrição em linguagem natural

O que faz:

Cria openspec/changes/<nome-da-mudança>/
Gera os artefatos necessários antes da implementação (para spec-driven: proposta, especificações, design, tarefas)
Para quando a mudança estiver pronta para /opsx:apply

Exemplo:

text

Você: /opsx:propose adicionar-modo-escuro

IA:  Criada openspec/changes/adicionar-modo-escuro/
     ✓ proposal.md
     ✓ specs/ui/spec.md
     ✓ design.md
     ✓ tasks.md
     Pronto para implementação. Execute /opsx:apply.

Dicas:

Use este comando para o caminho mais rápido de ponta a ponta
Se quiser controle passo a passo dos artefatos, habilite os fluxos de trabalho expandidos e use /opsx:new + /opsx:continue

`/opsx:explore`

Comece aqui quando não tiver certeza. Explore é um parceiro de pensamento sem riscos: ele lê seu código, compara opções e transforma uma ideia vaga em um plano concreto antes que qualquer mudança exista. Ele está incluído no perfil padrão. Para o caso completo e mais exemplos, consulte o guia Explore Primeiro.

Pense sobre ideias, investigue problemas e esclareça requisitos antes de se comprometer com uma mudança.

Sintaxe:

/opsx:explore [tópico]

Argumentos:

Argumento	Obrigatório	Descrição
`tópico`	Não	O que você deseja explorar ou investigar

O que faz:

Inicia uma conversa exploratória sem estrutura exigida
Investiga o código para responder perguntas
Compara opções e abordagens
Cria diagramas visuais para esclarecer o pensamento
Pode transicionar para /opsx:propose (padrão) ou /opsx:new (fluxo expandido) quando os insights se cristalizam

Exemplo:

text

Você: /opsx:explore

IA:  O que você gostaria de explorar?

Você: Como devemos lidar com a autenticação para o aplicativo móvel?

IA:  Deixe-me investigar sua configuração de autenticação atual...
     [Analisa o código]

     Vejo que você está usando autenticação baseada em sessão para o aplicativo web.
     Para o aplicativo móvel, temos três opções principais:

     1. Tokens JWT (sem estado, funciona offline)
     2. OAuth2 (se você precisar de login de terceiros)
     3. Estender as sessões atuais (mais simples, mas requer conectividade)

     Sua API já tem CORS configurado. Qual direção lhe interessa?

Você: Vamos com JWT. Podemos iniciar uma mudança para isso?

IA:  Pronto quando você estiver. Execute /opsx:propose adicionar-auth-jwt para começar.

Dicas:

Use quando os requisitos não estiverem claros ou precisar investigar
Nenhum artefato é criado durante a exploração
Bom para comparar múltiplas abordagens antes de decidir
Pode ler arquivos e pesquisar no código

`/opsx:new`

Inicie um novo esqueleto de mudança. Cria a pasta da mudança e aguarda você gerar os artefatos com /opsx:continue ou /opsx:ff.

Este comando faz parte do conjunto de fluxos de trabalho expandidos (não incluído no perfil core padrão).

Sintaxe:

/opsx:new [nome-da-mudança] [--schema <nome-do-schema>]

Argumentos:

Argumento	Obrigatório	Descrição
`nome-da-mudança`	Não	Nome para a pasta da mudança (perguntado se não for fornecido)
`--schema`	Não	Schema do fluxo de trabalho a usar (padrão: da configuração ou `spec-driven`)

O que faz:

Cria o diretório openspec/changes/<nome-da-mudança>/
Cria o arquivo de metadados .openspec.yaml na pasta da mudança
Mostra o primeiro modelo de artefato pronto para criação
Pergunta o nome da mudança e o schema se não forem fornecidos

O que cria:

openspec/changes/<nome-da-mudança>/
└── .openspec.yaml    # Metadados da mudança (schema, data de criação)

Exemplo:

Você: /opsx:new adicionar-modo-escuro

IA:  Criada openspec/changes/adicionar-modo-escuro/
     Schema: spec-driven

     Pronto para criar: proposta
     Use /opsx:continue para criá-la, ou /opsx:ff para criar todos os artefatos.

Dicas:

Use nomes descritivos: adicionar-recurso, corrigir-bug, refatorar-modulo
Evite nomes genéricos como atualizar, mudanças, wip
O schema também pode ser definido na configuração do projeto (openspec/config.yaml)

`/opsx:continue`

Crie o próximo artefato na cadeia de dependências. Cria um artefato de cada vez para progresso incremental.

Sintaxe:

/opsx:continue [nome-da-mudança]

Argumentos:

Argumento	Obrigatório	Descrição
`nome-da-mudança`	Não	Qual mudança continuar (inferido do contexto se não for fornecido)

O que faz:

Consulta o grafo de dependências de artefatos
Mostra quais artefatos estão prontos vs. bloqueados
Cria o primeiro artefato pronto
Lê arquivos de dependência para contexto
Mostra o que se torna disponível após a criação

Exemplo:

Você: /opsx:continue

IA:  Mudança: adicionar-modo-escuro

     Status dos artefatos:
     ✓ proposal    (concluído)
     ◆ specs       (pronto)
     ◆ design      (pronto)
     ○ tasks       (bloqueado - precisa: specs, design)

     Criando specs...

     [Lê proposal.md, cria specs com base nos requisitos]

     ✓ Criado openspec/changes/adicionar-modo-escuro/specs/ui/spec.md

     Agora disponível: design
     Execute /opsx:continue para criar o próximo artefato.

Dicas:

Use quando quiser revisar cada artefato antes de prosseguir
Bom para mudanças complexas onde você quer controle
Múltiplos artefatos podem ficar prontos simultaneamente
Você pode editar os artefatos criados antes de continuar

`/opsx:ff`

Avanço rápido pela criação de artefatos. Cria todos os artefatos de planejamento de uma vez.

Sintaxe:

/opsx:ff [nome-da-mudança]

Argumentos:

Argumento	Obrigatório	Descrição
`nome-da-mudança`	Não	Qual mudança avançar rapidamente (inferido do contexto se não for fornecido)

O que faz:

Cria todos os artefatos na ordem de dependência
Acompanha o progresso por meio de uma lista de tarefas
Para quando todos os artefatos apply-required estiverem completos
Lê cada dependência antes de criar o próximo artefato

Exemplo:

Você: /opsx:ff adicionar-modo-escuro

IA:  Avançando rapidamente em adicionar-modo-escuro...

     ✓ Criando proposal.md
     ✓ Criando specs/ui/spec.md
     ✓ Criando design.md
     ✓ Criando tasks.md

     Todos os artefatos de planejamento estão completos!
     Pronto para implementação. Execute /opsx:apply para começar.

Dicas:

Use quando tiver uma visão clara do que está construindo
Mais rápido que /opsx:continue para mudanças diretas
Você ainda pode editar os artefatos depois
Bom para recursos de pequeno a médio porte

`/opsx:apply`

Implemente as tarefas da mudança. Trabalha na lista de tarefas, escrevendo código e marcando os itens.

Sintaxe:

/opsx:apply [nome-da-mudança]

Argumentos:

Argumento	Obrigatório	Descrição
`nome-da-mudança`	Não	Qual mudança implementar (inferido do contexto se não for fornecido)

O que faz:

Lê tasks.md e identifica tarefas incompletas
Trabalha nas tarefas uma por uma
Escreve código, cria arquivos, executa testes conforme necessário
Marca tarefas concluídas com caixas de seleção [x]

Exemplo:

Você: /opsx:apply

IA:  Implementando adicionar-modo-escuro...

     Lendo tasks.md:
     - [ ] 1.1 Criar ThemeContext
     - [ ] 1.2 Adicionar propriedades CSS customizadas
     - [ ] 1.3 Implementar persistência com localStorage

     Trabalhando em 1.1: Criar ThemeContext...
     [Cria src/context/ThemeContext.tsx]

     ✓ 1.1 Completo

     Trabalhando em 1.2: Adicionar propriedades CSS customizadas...
     [Atualiza src/styles/globals.css]

     ✓ 1.2 Completo
     ...

Dicas:

Pode retomar de onde parou se for interrompido
Use para mudanças paralelas especificando o nome da mudança
O status de conclusão é rastreado nas caixas de seleção de tasks.md

`/opsx:update`

Revise os artefatos de planejamento existentes de uma mudança e mantenha-os coerentes entre si. Apenas artefatos de planejamento - nunca edita código.

Sintaxe:

text

/opsx:update [nome-da-mudança]

Argumentos:

Argumento	Obrigatório	Descrição
`nome-da-mudança`	Não	Qual mudança atualizar (inferido do contexto se não for fornecido)

O que faz:

Lê os artefatos da mudança via openspec status --change <nome> --json
Aplica sua revisão solicitada, ou revisa os artefatos para detectar contradições se você não indicar uma
Reconcilia os outros artefatos existentes em qualquer direção (uma edição no design pode refletir de volta na proposta)
Confirma cada edição com você antes de escrever, um artefato de cada vez
Termina recomendando o próximo passo: /opsx:continue (artefatos ausentes), /opsx:apply (levar um plano revisado para o código) ou /opsx:archive (tudo concluído)

Exemplo:

text

Você: /opsx:update adicionar-modo-escuro - estamos armazenando o tema em um cookie agora, não em localStorage

IA:  Lendo artefatos de adicionar-modo-escuro...

     O design referencia localStorage em dois lugares; a tarefa 1.3 cobre
     persistência com localStorage; a proposta não menciona armazenamento.

     Revisões propostas:
     1. design.md - trocar a decisão de localStorage por armazenamento em cookie
     2. tasks.md - reformular a tarefa 1.3 para persistência com cookie

     Aplicar revisão 1? (design.md)

Dicas:

Não cria artefatos ausentes - isso é função do /opsx:continue
Se a mudança já foi implementada, acompanhe com /opsx:apply para que o código corresponda ao plano revisado
Se sua revisão alterar a intenção da mudança, comece do zero com uma nova mudança (veja Quando Atualizar vs. Começar do Zero)

`/opsx:verify`

Valide se a implementação corresponde aos seus artefatos de mudança. Verifica completude, correção e coerência.

Sintaxe:

/opsx:verify [nome-da-mudança]

Argumentos:

Argumento	Obrigatório	Descrição
`nome-da-mudança`	Não	Qual mudança verificar (inferido do contexto se não for fornecido)

O que faz:

Verifica três dimensões da qualidade da implementação
Pesquisa no código por evidências de implementação
Relata problemas categorizados como CRÍTICO, AVISO ou SUGESTÃO
Não bloqueia o arquivamento, mas destaca problemas

Dimensões de verificação:

Dimensão	O que valida
Completude	Todas as tarefas concluídas, todos os requisitos implementados, cenários cobertos
Correção	A implementação corresponde à intenção da especificação, casos de borda tratados
Coerência	Decisões de design refletidas no código, padrões consistentes

Exemplo:

Você: /opsx:verify

IA:  Verificando adicionar-modo-escuro...

     COMPLETUDE
     ✓ Todas as 8 tarefas em tasks.md estão marcadas
     ✓ Todos os requisitos nas especificações têm código correspondente
     ⚠ Cenário "Detecção de preferência do sistema" não tem cobertura de teste

     CORREÇÃO
     ✓ Implementação corresponde à intenção da especificação
     ✓ Casos de borda dos cenários são tratados
     ✓ Estados de erro correspondem às definições da especificação

     COERÊNCIA
     ✓ Decisões de design refletidas na estrutura do código
     ✓ Convenções de nomenclatura consistentes com design.md
     ⚠ O design menciona "variáveis CSS" mas a implementação usa classes Tailwind

     RESUMO
     ─────────────────────────────
     Problemas críticos: 0
     Avisos: 2
     Pronto para arquivar: Sim (com avisos)

     Recomendações:
     1. Adicionar teste para detecção de preferência do sistema
     2. Atualizar design.md para refletir o uso do Tailwind, ou refatorar para usar variáveis CSS

Dicas:

Execute antes de arquivar para detectar divergências cedo
Avisos não bloqueiam o arquivamento, mas indicam problemas potenciais
Bom para revisar o trabalho da IA antes de confirmar
Pode revelar divergências entre artefatos e implementação

`/opsx:sync`

Comando opcional. Mescle especificações delta de uma mudança nas especificações principais. O arquivamento solicitará a sincronização se necessário, então normalmente você não precisa executar isso manualmente.

Sintaxe:

/opsx:sync [nome-da-mudança]

Argumentos:

Argumento	Obrigatório	Descrição
`nome-da-mudança`	Não	Qual mudança sincronizar (inferido do contexto se não for fornecido)

O que faz:

Lê as especificações delta da pasta da mudança
Analisa as seções ADDED/MODIFIED/REMOVED/RENAMED
Mescla as mudanças no diretório principal openspec/specs/
Preserva o conteúdo existente não mencionado no delta
Não arquiva a mudança (permanece ativa)

Exemplo:

text

Você: /opsx:sync

IA:  Sincronizando especificações delta de adicionar-modo-escuro...

     Lendo: openspec/changes/adicionar-modo-escuro/specs/ui/spec.md
     Alvo:  openspec/specs/ui/spec.md

     Mudanças a aplicar:
     ✓ ADICIONADO: Requisito de Seleção de Tema (2 cenários)
     ✓ ADICIONADO: Requisito de Acessibilidade (1 cenário)

     Mesclando...
     ✓ openspec/specs/ui/spec.md atualizado

     Mudança permanece ativa. Execute /opsx:archive quando estiver pronto para concluir.

Quando usar manualmente:

Cenário	Usar sync?
Mudança de longa duração, quer especificações no principal antes de arquivar	Sim
Múltiplas mudanças paralelas precisam das especificações base atualizadas	Sim
Quer pré-visualizar/revisar a mesclagem separadamente	Sim
Mudança rápida, indo direto para o arquivamento	Não (o arquivamento lida com isso)

Dicas:

O sync é inteligente, não é copiar e colar
Pode adicionar cenários a requisitos existentes sem duplicação
A mudança permanece ativa após o sync (não arquivada)
A maioria dos usuários nunca precisará chamar isso diretamente—o arquivamento solicita se necessário

`/opsx:archive`

Arquive uma mudança concluída. Finaliza a mudança e a move para a pasta de arquivamento.

Sintaxe:

/opsx:archive [nome-da-mudança]

Argumentos:

Argumento	Obrigatório	Descrição
`nome-da-mudança`	Não	Qual mudança arquivar (inferido do contexto se não for fornecido)

O que faz:

Verifica o status de conclusão dos artefatos
Verifica a conclusão das tarefas (avisa se incompleta)
Oferece sincronizar as especificações delta se ainda não sincronizadas
Move a pasta da mudança para openspec/changes/archive/AAAA-MM-DD-<nome>/
Preserva todos os artefatos para trilha de auditoria

Exemplo:

text

Você: /opsx:archive

IA:  Arquivando adicionar-modo-escuro...

     Status dos artefatos:
     ✓ proposal.md existe
     ✓ specs/ existe
     ✓ design.md existe
     ✓ tasks.md existe (8/8 tarefas completas)

     Especificações delta: Ainda não sincronizadas
     → Sincronizar agora? (recomendado)

Você: Sim

IA:  ✓ Sincronizadas especificações para openspec/specs/ui/spec.md
     ✓ Movido para openspec/changes/archive/2025-01-24-adicionar-modo-escuro/

     Mudança arquivada com sucesso.

Dicas:

O arquivamento não bloqueia em tarefas incompletas, mas avisará
As especificações delta podem ser sincronizadas durante o arquivamento ou antes
Mudanças arquivadas são preservadas para histórico
Use /opsx:verify primeiro para detectar problemas

`/opsx:bulk-archive`

Arquive múltiplas mudanças concluídas de uma vez. Lida com conflitos de especificação entre mudanças.

Sintaxe:

/opsx:bulk-archive [nomes-das-mudanças...]

Argumentos:

Argumento	Obrigatório	Descrição
`nomes-das-mudanças`	Não	Mudanças específicas para arquivar (solicita seleção se não for fornecido)

O que faz:

Lista todas as mudanças concluídas
Valida cada mudança antes de arquivar
Detecta conflitos de especificação entre mudanças
Resolve conflitos verificando o que está realmente implementado
Arquiva em ordem cronológica

Exemplo:

Você: /opsx:bulk-archive

IA:  Encontradas 3 mudanças concluídas:
     - adicionar-modo-escuro (8/8 tarefas completas)
     - corrigir-bug-login (3/3 tarefas completas)
     - atualizar-rodapé (2/2 tarefas completas)

     Verificando conflitos de especificação...
     ⚠ adicionar-modo-escuro e atualizar-rodapé tocam ambos em specs/ui/

     Inspecionando o código para resolver...
     Ambas as mudanças estão implementadas. Mesclarei em ordem cronológica:
     1. adicionar-modo-escuro (criada em 20 de jan.)
     2. atualizar-rodapé (criada em 22 de jan.)

     Arquivar todas as 3 mudanças?

Você: Sim

IA:  ✓ Arquivada adicionar-modo-escuro
     ✓ Arquivada corrigir-bug-login
     ✓ Arquivada atualizar-rodapé
     Especificações mescladas: adicionar-modo-escuro → atualizar-rodapé

Dicas:

Bom para fluxos de trabalho paralelos
A resolução de conflitos é agêntica (verifica o código)
As mudanças são arquivadas em ordem de criação
Solicita confirmação antes de sobrescrever conteúdo de especificação

`/opsx:onboard`

Onboarding guiado pelo fluxo de trabalho completo do OpenSpec. Um tutorial interativo usando seu código real.

Sintaxe:

/opsx:onboard

O que faz:

Percorre um ciclo completo do fluxo de trabalho com narração
Examina seu código em busca de oportunidades reais de melhoria
Cria uma mudança real com artefatos reais
Implementa trabalho real (mudanças pequenas e seguras)
Arquiva a mudança concluída
Explica cada passo conforme acontece

Fases:

Boas-vindas e análise do código
Encontrar uma oportunidade de melhoria
Criar uma mudança (/opsx:new)
Escrever a proposta
Criar especificações
Escrever o design
Criar tarefas
Implementar tarefas (/opsx:apply)
Verificar a implementação
Arquivar a mudança
Resumo e próximos passos

Exemplo:

Você: /opsx:onboard

IA:  Bem-vindo ao OpenSpec!

     Vou guiá-lo pelo fluxo de trabalho completo usando seu código real.
     Encontraremos algo pequeno para melhorar, criaremos uma mudança adequada,
     implementaremos e arquivaremos.

     Deixe-me examinar seu código em busca de oportunidades...

     [Analisa o código]

     Encontrei algumas coisas em que poderíamos trabalhar:
     1. Adicionar validação de entrada no formulário de contato
     2. Melhorar mensagens de erro no fluxo de autenticação
     3. Adicionar estados de carregamento a botões assíncronos

     Qual lhe interessa? (ou sugira outra coisa)

Dicas:

Melhor para novos usuários aprendendo o fluxo de trabalho
Usa código real, não exemplos de brinquedo
Cria uma mudança real que você pode manter ou descartar
Leva de 15 a 30 minutos para concluir

Fim da tradução.

Sintaxe de Comando por Ferramenta de IA

Diferentes ferramentas de IA utilizam sintaxes de comando ligeiramente distintas. Utilize o formato que corresponda à sua ferramenta:

Arquivo de comando da sua ferramenta	Exemplo de sintaxe	Ferramentas de exemplo
`.../commands/opsx/<id>.*`	`/opsx:propose`, `/opsx:apply`	Claude Code, Gemini CLI, Crush
`.../opsx-<id>.*`	`/opsx-propose`, `/opsx-apply`	Cursor, Devin Desktop, Copilot (IDE), Trae, Oh My Pi
nenhum — apenas habilidades	`/openspec-propose`, `/openspec-apply-change`	CodeArts, ForgeCode, Hermes, MiniMax Code, Mistral Vibe, Zed Agent, `.agents` compartilhados
nenhum — Kimi Code	`/skill:openspec-propose`	Kimi Code
nenhum — Codex CLI	`$openspec-propose`	Codex

Devin Desktop vs Devin Local: os arquivos .devin/workflows/opsx-*.md fornecem ao Devin Desktop /opsx-propose. O Devin Local não possui fluxos de trabalho — utilize as habilidades que o OpenSpec escreve em .devin/skills/, como /openspec-propose, que funcionam em ambos os agentes.

A intenção é a mesma entre as ferramentas, mas a forma como os comandos são apresentados pode variar conforme a integração. Como Invocar lista todas as ferramentas suportadas; esta tabela mostra apenas exemplos de cada formato.

Nota: Os comandos do GitHub Copilot (.github/prompts/*.prompt.md) estão disponíveis apenas nas extensões de IDE (VS Code, JetBrains, Visual Studio). O GitHub Copilot CLI atualmente não suporta arquivos de prompt personalizados — consulte Ferramentas Suportadas para detalhes e soluções alternativas.

Comandos Legados

Estes comandos utilizam o fluxo de trabalho mais antigo "tudo de uma vez". Eles ainda funcionam, mas os comandos OPSX são recomendados.

Comando	O que ele faz
`/openspec:proposal`	Cria todos os artefatos de uma vez (proposta, especificações, design, tarefas)
`/openspec:apply`	Implementa a alteração
`/openspec:archive`	Arquiva a alteração

Quando usar comandos legados:

Projetos existentes que utilizam o fluxo de trabalho antigo
Alterações simples onde você não precisa da criação incremental de artefatos
Preferência pela abordagem tudo ou nada

Migração para OPSX: Alterações legadas podem ser continuadas com os comandos OPSX. A estrutura dos artefatos é compatível.

Solução de Problemas

"Change not found" (Alteração não encontrada)

O comando não conseguiu identificar qual alteração deveria ser trabalhada.

Soluções:

Especifique o nome da alteração explicitamente: /opsx:apply add-dark-mode
Verifique se a pasta da alteração existe: openspec list
Confirme que você está no diretório correto do projeto

"No artifacts ready" (Nenhum artefato pronto)

Todos os artefatos estão completos ou bloqueados devido a dependências ausentes.

Soluções:

Execute openspec status --change <name> para ver o que está bloqueando
Verifique se os artefatos necessários existem
Crie primeiro os artefatos de dependência ausentes

"Schema not found" (Esquema não encontrado)

O esquema especificado não existe.

Soluções:

Liste os esquemas disponíveis: openspec schemas
Verifique a ortografia do nome do esquema
Crie o esquema se for personalizado: openspec schema init <name>

Comandos não reconhecidos

A ferramenta de IA não reconhece os comandos do OpenSpec.

Soluções:

Certifique-se de que o OpenSpec foi inicializado: openspec init
Regere as habilidades: openspec update
Verifique se o diretório .claude/skills/ existe (para Claude Code)
Reinicie sua ferramenta de IA para carregar as novas habilidades

Artefatos não sendo gerados corretamente

A IA cria artefatos incompletos ou incorretos.

Soluções:

Adicione contexto do projeto em openspec/config.yaml
Adicione regras específicas por artefato para orientações detalhadas
Forneça mais detalhes na descrição da sua alteração
Use /opsx:continue em vez de /opsx:ff para ter mais controle

Próx Passos

Workflows - Padrões comuns e quando usar cada comando
CLI - Comandos de terminal para gerenciamento e validação
Customization - Crie esquemas e fluxos de trabalho personalizados

Comandos ​

Referência Rápida ​

Caminho Rápido Padrão (perfil core) ​

Comandos de Fluxo de Trabalho Avançado (seleção de fluxo de trabalho personalizado) ​

Referência de Comandos ​

/opsx:propose ​

/opsx:explore ​

/opsx:new ​

/opsx:continue ​

/opsx:ff ​

/opsx:apply ​

/opsx:update ​

/opsx:verify ​

/opsx:sync ​

/opsx:archive ​

/opsx:bulk-archive ​

/opsx:onboard ​

Sintaxe de Comando por Ferramenta de IA ​

Comandos Legados ​

Solução de Problemas ​

"Change not found" (Alteração não encontrada) ​

"No artifacts ready" (Nenhum artefato pronto) ​

"Schema not found" (Esquema não encontrado) ​

Comandos não reconhecidos ​

Artefatos não sendo gerados corretamente ​

Próx Passos ​

Comandos

Referência Rápida

Caminho Rápido Padrão (perfil `core`)

Comandos de Fluxo de Trabalho Avançado (seleção de fluxo de trabalho personalizado)

Referência de Comandos

`/opsx:propose`

`/opsx:explore`

`/opsx:new`

`/opsx:continue`

`/opsx:ff`

`/opsx:apply`

`/opsx:update`

`/opsx:verify`

`/opsx:sync`

`/opsx:archive`

`/opsx:bulk-archive`

`/opsx:onboard`

Sintaxe de Comando por Ferramenta de IA

Comandos Legados

Solução de Problemas

"Change not found" (Alteração não encontrada)

"No artifacts ready" (Nenhum artefato pronto)

"Schema not found" (Esquema não encontrado)

Comandos não reconhecidos

Artefatos não sendo gerados corretamente

Próx Passos