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

Sua primeira feature

Execute a sequência principal de comandos do Raaghu Spec Kit para uma feature, sincronize uma hierarquia Epic → Feature → User Story → Task no Azure Boards e verifique os artefatos no wiki.

Tempo: cerca de 20–30 minutos na primeira vez.

Pré-requisitos​

  • Início rápido concluído (autorizado, com seat, inicializado, IA conectada)
  • Painel de chat visível à direita

Este tutorial usa comandos /speckit.*. Se Settings → Commands Mapping estiver em Default, o dropdown mostra nomes amigáveis (por exemplo, "Create Specification" em vez de /speckit.specify). São os mesmos comandos.

Prefere cards guiados em vez de comandos com barra? Comece por Workflows — o mesmo motor, menos comandos para lembrar. Use este tutorial quando quiser a sequência completa de comandos.

Etapa 1: Definir a constitution (uma vez por projeto)​

/speckit.constitution Create principles focused on code quality, testing standards, user experience consistency, and performance requirements

Revise a prévia e clique em Keep (ou Regenerate para outro rascunho). A constitution é salva em Raaghu Spec Kit/specify/memory/constitution no wiki (ou sob Speckit/ em projetos mais antigos).

Etapa 2: Especificar a feature​

Descreva o que construir (ainda não o stack técnico):

/speckit.specify Build an app to organize photos into date-grouped albums, with drag-and-drop reordering and a tile preview inside each album.

Uma nova pasta de feature é criada em Raaghu Spec Kit/specs/NNN-feature-name/ com uma página spec (ou sob Speckit/ em projetos mais antigos).

Etapa 3: Esclarecer ambiguidades​

/speckit.clarify

Responda às perguntas que a IA faz no chat para que as lacunas sejam incorporadas de volta à spec.

Etapa 4: Planejar e detalhar tarefas​

/speckit.plan Use Vite with minimal libraries. Prefer vanilla HTML, CSS, and JavaScript. Store metadata in a local SQLite database.
/speckit.tasks

Isso cria plan e tasks na mesma pasta da feature.

Etapa 5: Criar e sincronizar work items (Visuals)​

Abra a aba Visuals e sincronize um nível por vez com a varinha mágica do card (não o botão azul Sync do gráfico):

  1. No card Constitution, abra o menu da varinha mágica e sincronize Epics.
  2. Em um card Epic, sincronize Features.
  3. Em um card Feature, sincronize User Stories.
  4. Em um card User Story, sincronize Tasks.

Se o Sync estiver desabilitado, gere primeiro os arquivos necessários no wiki (constitution para Epics; spec da feature para Features; tasks para Tasks). Detalhes: Visuals.

Confirme que uma árvore Epic → Feature → User Story → Task aparece no canvas. Executar Sync novamente atualiza os itens existentes em vez de duplicá-los.

Etapa 6: Verificar o Wiki​

  1. Abra o Wiki do Azure DevOps.
  2. Navegue em Raaghu Spec Kit/specs/NNN-feature-name/ (ou Speckit/…) e confirme spec, plan e tasks.

Comandos opcionais a seguir​

  • /speckit.analyze — lacunas de consistência e cobertura
  • /speckit.checklist — checklist de qualidade dos requisitos
  • /speckit.converge — após o push do código, acrescentar tarefas restantes

Você também pode experimentar uma capacidade de Workflows (por exemplo, Project Setup → Create project foundation). Catálogo: Workflows.

Próximos passos​