Início rápido
Vá do zero a uma sessão funcional do Raaghu Spec Kit em cerca de 10 minutos.
Se a sua organização ainda não assinou nem atribuiu seats, um administrador da organização precisa concluir a Configuração do administrador primeiro. Os membros podem então seguir as etapas abaixo.
Pré-requisitos
- Uma organização e um projeto no Azure DevOps
- Permissão para instalar extensões do marketplace (ou um administrador que já instalou o Raaghu Spec Kit)
- Um seat na assinatura do Raaghu Spec Kit (um administrador atribui os seats)
Etapas
1. Instalar e abrir
- Instale o Raaghu Spec Kit no Visual Studio Marketplace, se ainda não estiver instalado.
- Abra um projeto → barra lateral esquerda → Raaghu Spec Kit.
Detalhes: Instalação e abertura.
2. Autorizar com a Microsoft
- Na página inicial, clique em Authorize Now (usuários com seat que retornam podem pular isso e ver uma tela de carregamento breve enquanto o Raaghu Spec Kit entra).
- Conclua o login com a Microsoft e aprove o acesso.
- Se aparecer "Request submitted. Retry authorization after admin approval", peça a um administrador para aprová-lo em Organization settings → Extensions → Raaghu Spec Kit → Users → Pending requests (Access Requests) e, em seguida, clique em Authorize Now novamente.
3. Obter um seat
O Raaghu Spec Kit é baseado em seats. Aprovar uma solicitação pendente também atribui um seat (Approve and assign seat?). Administradores ainda podem Assign / Unassign seats depois na subaba Users.
- Administradores: Azure DevOps → Organization settings → Extensions → Raaghu Spec Kit → Users (aprovar solicitações pendentes, ou Assign / Unassign seats). Consulte Organization Settings.
- Membros: Peça a um administrador para aprovar sua solicitação ou atribuir um seat. Até lá, você pode ver uma mensagem de seat ou de assinatura.
4. Inicializar o Raaghu Spec Kit (uma vez por projeto)
- Se o Raaghu Spec Kit ainda não estiver configurado, clique em Initialize Raaghu Spec Kit.
- Aguarde "Initialization complete!".
Isso cria a árvore Raaghu Spec Kit/ no Wiki do projeto (projetos mais antigos ainda podem usar Speckit/). Faça isso uma vez por projeto.
Detalhes: Initialize Raaghu Spec Kit.
5. Conectar a IA
O chat e a maioria dos recursos do Raaghu Spec Kit precisam de uma conexão de IA (o produto pode rotular isso como LLM).
Se você é administrador da organização ou Project Administrator
- Abra o menu (topo do Raaghu Spec Kit) → Settings (membros comuns não veem este item).
- Em LLM Settings, escolha como este projeto obtém IA:
| Situação | O que fazer |
|---|---|
| Um admin já configurou a IA neste projeto | Em LLM Settings, deixe Project LLM Off (ou ligue Raaghu AI se for assim que a org estiver configurada) |
| Você precisa da sua própria chave de provedor | Em LLM Settings, ligue Project LLM, adicione Azure OpenAI, OpenAI ou Claude, salve e defina como Default |
| O chat ainda diz que a IA não está configurada | Em Azure DevOps → Organization settings → Extensions → Raaghu Spec Kit → AI Settings → Project, permita Use organization AI, Use project AI ou Use Raaghu AI, ou adicione créditos Raaghu AI |
Detalhes: Settings.
Se você é um membro comum da equipe
Você não verá Settings no menu. Peça a um administrador do projeto ou da organização para conectar a IA neste projeto. Quando o chat deixar de dizer que a IA não está configurada, continue para o próximo passo.
6. Continuar para a sua primeira feature
Quando a IA estiver funcionando:
- Prefere cards guiados? Comece por Workflows.
- Prefere o caminho completo de comandos? Vá para Sua primeira Feature.
Na primeira vez que você entrar no workspace, um tour curto do produto pode aparecer. Você pode dispensá-lo — é opcional.