Pular para o conteúdo principal
Versão: v3.0.0

Comandos do Raaghu Spec Kit

Os comandos do Raaghu Spec Kit geram conteúdo estruturado e o salvam no Wiki do projeto em Speckit/. Execute-os pelo dropdown Command do painel de chat ou digitando o comando.

Antes de começar: Conecte um provedor de IA em Settings e inicialize o Raaghu Spec Kit.

Dropdown de CommandDropdown de Command

Os comandos​

ComandoFinalidadeSalvo em (Wiki)
/speckit.constitutionDefinir princípios e guardrails do projetoSpeckit/specify/memory/constitution
/speckit.specifyCriar uma especificação de feature com requisitos e critérios de aceiteSpeckit/specs/NNN-feature-name/spec
/speckit.clarifyDetectar ambiguidades, fazer perguntas e atualizar a specAtualiza o spec da feature
/speckit.planCriar um plano técnico de implementaçãoSpeckit/specs/NNN-feature-name/plan
/speckit.tasksDividir o plano em uma lista de tarefas por fasesSpeckit/specs/NNN-feature-name/tasks
/speckit.analyzeCruzar spec, plan, tasks e constitution em busca de lacunasRelatório no chat
/speckit.checklistGerar um checklist de qualidade dos requisitosSpeckit/specs/NNN-feature-name/checklists/…
/speckit.convergeApós o push do código, comparar o repositório com spec/plan/tasks e acrescentar tarefas restantesAcrescenta em tasks

Em Settings → Commands Mapping, alterne entre Default (nomes amigáveis) e Spec Kit (IDs speckit.*). Exemplo: "Create Specification" é o mesmo que /speckit.specify.

Ordem recomendada​

Execute os comandos nesta ordem. A constitution é definida uma vez por projeto; os demais são executados por feature.

OrdemComandoObrigatórioDescrição
1/speckit.constitutionSim (uma vez)Definir princípios do projeto
2/speckit.specifySimDefinir o que construir
3/speckit.clarifyRecomendadoEsclarecer áreas pouco especificadas antes do planejamento
4/speckit.planSimDefinir o stack técnico e o plano de implementação
5/speckit.tasksSimGerar a lista de tarefas
6/speckit.analyzeOpcionalAnálise de consistência e cobertura
7/speckit.checklistOpcionalChecklist de qualidade dos requisitos
8/speckit.convergeOpcional (após o push)Reconciliar o código com a spec

CREATE versus UPDATE​

A maioria dos comandos é incremental:

  • CREATE — quando ainda não existe arquivo para a feature atual, o comando o gera a partir de um template.
  • UPDATE — quando o arquivo já existe, o comando adiciona conteúdo novo e mantém o que você já tem.

Exemplos​

/speckit.constitution Create principles focused on code quality, testing standards, user experience consistency, and performance requirements
/speckit.specify Build an app to organize photos into date-grouped albums, with drag-and-drop reordering and a tile preview inside each album.
/speckit.clarify
/speckit.plan Use Vite with minimal libraries. Prefer vanilla HTML, CSS, and JavaScript. Store metadata in a local SQLite database.
/speckit.tasks

Após a execução de um comando, revise a prévia e escolha Keep ou Regenerate.

/speckit.constitution​

Define os princípios do projeto (uma vez por projeto). Visualize o rascunho e depois clique em Keep.

Resultado do comando constitution com Keep ou RegenerateResultado do comando constitution com Keep ou Regenerate

/speckit.specify​

Cria o spec da feature (e páginas relacionadas, como requirements) em Speckit/specs/NNN-feature-name/.

Resultado do comando specify com prévia da spec e Keep ou RegenerateResultado do comando specify com prévia da spec e Keep ou Regenerate

/speckit.clarify​

Faz perguntas de esclarecimento no chat (muitas vezes com uma sugestão Optimal). Responda-as para que as lacunas sejam incorporadas de volta à spec.

Comando clarify fazendo perguntas com sugestão OptimalComando clarify fazendo perguntas com sugestão Optimal

/speckit.plan​

Gera o plano de implementação e arquivos relacionados (plan, research, data-model e similares).

Resultado do comando plan com vários arquivos geradosResultado do comando plan com vários arquivos gerados

/speckit.checklist​

Cria um checklist de qualidade dos requisitos na pasta checklists/ da feature.

Resultado do comando checklist com Keep ou RegenerateResultado do comando checklist com Keep ou Regenerate

/speckit.tasks​

Divide o plano em uma lista tasks por fases.

Resultado do comando tasks com prévia de tasks.mdResultado do comando tasks com prévia de tasks.md

/speckit.analyze​

Cruza spec, plan, tasks e constitution. Os resultados aparecem como um relatório de análise no chat (lacunas, severidade e recomendações).

Relatório de análise de especificação do comando analyze no chatRelatório de análise de especificação do comando analyze no chat

Workflows vs comandos​

  • Comandos (/speckit.*) são ações diretas que você executa pelo chat.
  • Workflows são conversas guiadas em várias etapas a partir da aba Workflows, que usam o mesmo motor.

Para um passo a passo completo, consulte Sua primeira Feature.

Próximos passos​