Captação
A aba Intake é onde você traz documentos de requisitos (BRD, PRD e similares) para o projeto. A IA analisa cada documento e ajuda você a criar work items no Azure Boards.
Os documentos são armazenados em Raaghu Spec Kit/intake/ no wiki (ou Speckit/intake/ em projetos mais antigos).
Pré-requisitos: O Raaghu Spec Kit deve estar inicializado e um provedor de IA deve estar conectado. Se o Raaghu Spec Kit não estiver inicializado, você verá "Raaghu Spec Kit Required". Se nenhum provedor de IA estiver configurado, você verá "LLM required" ou "LLM is not configured" (LLM significa o modelo ou a conexão de IA). Administradores da organização e Project Administrators conectam a IA em Settings. Se você não vir Settings, peça a um admin para conectar a IA deste projeto.
Adicionar um documento
- Clique em + New Intake.
- Escolha arquivos em Repos, Wiki, Boards, Backlogs e outras fontes do Azure DevOps, ou Upload from computer.
- Selecione até 4 arquivos por vez e clique em Add to intake.
Os tipos suportados incluem .md, .txt, .docx, .pdf e formatos de texto comuns para análise por IA, além de planilhas (.xlsx, .xls, .csv) para importação de work items. Documentos de requisitos baseados em texto funcionam melhor na análise.
Envie planilhas e documentos de requisitos separadamente. Arquivos de planilha usam importação de work items; os demais usam análise por IA. Misturar os dois no mesmo upload não é suportado.
Documentos grandes são analisados em chunks com sobreposição (e o planejamento de backlog pode dividir por headings ou seções) e depois mesclados em uma única análise. Se o documento for muito grande, a análise pode cobrir só parte dele — o resultado indica quando a análise foi truncada. Quando possível, coloque os requisitos críticos no início do arquivo.
Para documentos de requisitos, a extensão salva uma cópia no wiki, executa a análise por IA e mostra "Intake analysis complete" quando termina.
O empty state diz "No Intake Documents yet". Clique em New Intake nesse empty state (ou em + New Intake na barra de ferramentas) para adicionar arquivos.
Parar ou repetir a análise
Enquanto a análise de Intake estiver em andamento, use Stop generating no rodapé do chat para cancelar. Após uma parada ou interrupção, a resposta pode mostrar "Response stopped…" — clique em Retry para executar a análise de novo sem selecionar os mesmos arquivos (uploads locais mantêm o conteúdo extraído para o retry).
Ler a análise
Cada documento aparece como um card. Expanda-o para ver:
- AI Analysis Summary — uma descrição curta do documento
- Document Understanding — contagens para:
| Categoria | Significado |
|---|---|
| Business Goals | Objetivos de alto nível |
| User Roles | Tipos de usuário / personas |
| Functional Requirements | O que o sistema deve fazer |
| Non-Functional Requirements | Desempenho, segurança e similares |
| Risks / Assumptions | Riscos em aberto (revisar no chat) |
| Open Questions | Perguntas não resolvidas (revisar no chat) |
O chat também pode fazer perguntas de esclarecimento (por exemplo, em Scope) para que você resolva ambiguidades antes de criar work items. As perguntas aparecem uma por vez (Back / Next, depois Submit Answer na última pergunta).
Criar work items (a partir da análise)
Após a análise, o chat sugere work items do Azure Boards (os cards são rotulados Recommended):
- Para cada sugestão, escolha Create ou Skip.
- Você pode editar Title, Description e Acceptance criteria antes.
- Ao criar, você pode escolher Team e Sprint (a mesma ideia do chat). Em seguida, o item é criado no Azure Boards e vinculado de volta ao documento de origem.
- Ou use Create all (N) para criar todas as sugestões pendentes de uma vez. Enquanto roda, o botão mostra Creating current/total… e a lista não salta a cada item.
Se você Skip uma sugestão, use Show skipped (N) (ou Hide skipped) no fluxo para revisar os cards ignorados. Cada linha ignorada mostra o badge Skipped e Undo skip para restaurar a sugestão para Create.
Itens criados e modificados aparecem no card do documento. Itens soft-deleted na Recycle Bin do Azure DevOps aparecem em Deleted em vez de Created.
Importação de planilha
Ao adicionar uma planilha (.xlsx, .xls ou .csv), o Intake mapeia as colunas e pré-visualiza as linhas em vez de executar o fluxo completo de análise por IA.
- Revise as colunas mapeadas e as linhas de preview (Valid / Invalid).
- Crie os itens um a um pelos cards de sugestão, ou use Create all (N) para todas as linhas válidas pendentes.
- Enquanto a criação estiver em andamento, o status de cada linha passa para Creating, depois Created (com o id do novo work item) ou Skipped. O progresso pode aparecer como Creating 2/5….