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

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)
  • 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 Speckit no wiki.
  5. Grava os arquivos obtidos em Speckit/.

Você verá mensagens de progresso como "Running pre-flight checks…", "Fetching Speckit files from GitHub…", "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

Quando terminar, o painel de chat abre e o Dashboard fica disponível.

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

O que é criado no Wiki​

Speckit/
├── 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 Speckit no Wiki do projetoÁrvore Speckit 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​