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

Inicializar Raaghu Spec Kit

Antes de gerar especificações, planos e tarefas, você precisa inicializar o Raaghu Spec Kit no seu projeto. A inicialização configura os arquivos do Raaghu Spec Kit no Wiki do projeto. Faça isso uma vez por projeto.

Pré-requisitos​

  • Concluir Instalação e abertura, autorizar com a Microsoft e ter um seat
  • Um Wiki do projeto (a extensão cria um, se necessário). Se o projeto não tem wiki, o painel direito mostra Initialize Raaghu Spec Kit
  • Acesso HTTPS de saída para GitHub.com (os templates são obtidos do repositório open-source do GitHub Spec Kit)

O que a inicialização faz​

A inicialização é executada no seu navegador (não é necessário pipeline de build nem agente). Ela:

  1. Executa verificações prévias — confirma o acesso ao GitHub e encontra ou cria o Wiki do projeto.
  2. Verifica se o Raaghu Spec Kit já está inicializado.
  3. Obtém templates do GitHub Spec Kit, definições de comandos e scripts do GitHub.
  4. Cria uma página raiz Raaghu Spec Kit no wiki (projetos novos). Projetos que já têm raiz Speckit mantêm esse caminho.
  5. Grava os arquivos obtidos nessa raiz.

Você verá mensagens de progresso como "Running pre-flight checks…", "Fetching Speckit files from GitHub…", "Creating Raaghu Spec Kit wiki structure…", "Writing file X/Y…" e, por fim, "Initialization complete!".

Etapas​

  1. Abra o Raaghu Spec Kit. Se o Raaghu Spec Kit não estiver inicializado, o painel direito mostra Initialize Raaghu Spec Kit.
  2. Clique em Initialize Raaghu Spec Kit.
  3. Aguarde "Initialization complete!".

Painel Initialize Raaghu Spec Kit à direita com métricas vazias do DashboardPainel Initialize Raaghu Spec Kit à direita com métricas vazias do Dashboard

Durante a inicialização, um hub splash percorre Welcome → Why Use Raaghu Spec Kit? → Journey. Ao terminar, um card All Set oferece atalhos para Intake, Workflows e Dashboard; em seguida o painel de chat abre e o workspace fica pronto.

Card Welcome do hub splash durante a inicialização do Raaghu Spec KitCard Welcome do hub splash durante a inicialização do Raaghu Spec Kit

Workspace após a inicializaçãoWorkspace após a inicialização

O que é criado no Wiki​

Projetos novos usam a raiz Raaghu Spec Kit. Projetos mais antigos, inicializados antes desta versão, mantêm Speckit. O layout das pastas sob qualquer uma das raízes é o mesmo:

Raaghu Spec Kit/          (ou Speckit/ em projetos mais antigos)
├── specify/              ← arquivos do motor, memory, templates
│   ├── memory/           ← a constitution do projeto é salva aqui
│   ├── scripts/
│   └── templates/
└── devops/               ← definições de comandos

Comandos posteriores adicionam pastas como specs/ (uma pasta por feature) e intake/. Em geral, você não edita essas pastas do motor manualmente.

As páginas do Azure DevOps Wiki são armazenadas sem a extensão .md. Um caminho como specs/001-feature-name/spec é uma página do wiki chamada spec.

Árvore Raaghu Spec Kit no Wiki do projetoÁrvore Raaghu Spec Kit no Wiki do projeto

Reinicializar​

Se o Raaghu Spec Kit já existir e você inicializar novamente, será pedida uma confirmação antes de sobrescrever. Escolha Yes, Update ou Cancel.

A reinicialização é apenas para recuperação. Você não precisa inicializar toda vez que abrir o projeto.

Erros comuns​

MensagemO que fazer
"GitHub API rate limit reached…"Aguarde alguns minutos e tente novamente
"Cannot reach GitHub to fetch Speckit files…"Verifique a rede ou o firewall para acesso ao GitHub.com e tente novamente
"Could not create the project wiki automatically…"Abra a aba Wiki no seu projeto, crie o wiki do projeto e inicialize novamente

Veja também Solução de problemas.

Próximos passos​