Comandos do Raaghu Spec Kit
Os comandos do Raaghu Spec Kit geram conteúdo estruturado e o salvam no Wiki do projeto em Raaghu Spec Kit/ (projetos mais antigos ainda podem usar 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.
Ajuda do comando (ⓘ)
Abra o dropdown Command para escolher um comando do Raaghu Spec Kit. Use os botões ⓘ para ajuda no produto:
- Ao lado do título Command — abre How to use commands (selecione um comando, adicione uma descrição curta, pressione Enter), com um exemplo
- Ao lado de cada comando — abre um popover com Description, What to enter e um Example daquele comando
Os comandos
| Comando | Finalidade | Salvo em (Wiki) |
|---|---|---|
/speckit.constitution | Definir princípios e guardrails do projeto | Raaghu Spec Kit/specify/memory/constitution |
/speckit.specify | Criar uma especificação de feature com requisitos e critérios de aceite | Raaghu Spec Kit/specs/NNN-feature-name/spec |
/speckit.clarify | Detectar ambiguidades, fazer perguntas e atualizar a spec | Atualiza o spec da feature |
/speckit.plan | Criar um plano técnico de implementação | Raaghu Spec Kit/specs/NNN-feature-name/plan |
/speckit.tasks | Dividir o plano em uma lista de tarefas por fases | Raaghu Spec Kit/specs/NNN-feature-name/tasks |
/speckit.analyze | Cruzar spec, plan, tasks e constitution em busca de lacunas | Relatório no chat |
/speckit.checklist | Gerar um checklist de qualidade dos requisitos | Raaghu Spec Kit/specs/NNN-feature-name/checklists/… |
/speckit.converge | Após o push do código, comparar o repositório com spec/plan/tasks e acrescentar tarefas restantes | Acrescenta 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.
| Ordem | Comando | Obrigatório | Descrição |
|---|---|---|---|
| 1 | /speckit.constitution | Sim (uma vez) | Definir princípios do projeto |
| 2 | /speckit.specify | Sim | Definir o que construir |
| 3 | /speckit.clarify | Recomendado | Esclarecer áreas pouco especificadas antes do planejamento |
| 4 | /speckit.plan | Sim | Definir o stack técnico e o plano de implementação |
| 5 | /speckit.tasks | Sim | Gerar a lista de tarefas |
| 6 | /speckit.analyze | Opcional | Análise de consistência e cobertura |
| 7 | /speckit.checklist | Opcional | Checklist de qualidade dos requisitos |
| 8 | /speckit.converge | Opcional (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.
/speckit.specify cria o próximo spec numerado por padrão. Atualiza um spec existente apenas quando você pede explicitamente (por exemplo, update this spec ou nomear specs/001-feature-name). Depois do specify, clarify, plan, tasks, analyze e converge permanecem nessa feature até você nomear outra.
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.
/speckit.specify
Cria o spec da feature (e páginas relacionadas, como requirements) em Raaghu Spec Kit/specs/NNN-feature-name/.
/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.
/speckit.plan
Gera o plano de implementação e arquivos relacionados (plan, research, data-model e similares).
/speckit.checklist
Cria um checklist de qualidade dos requisitos na pasta checklists/ da feature.
/speckit.tasks
Divide o plano em uma lista tasks por fases.
/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).
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.