dott.AI Visual Code Extension

Análise, pontuação e reescrita de requisitos de software por inteligência artificial — diretamente no seu editor.

O dott.AI integra-se ao painel de chat nativo do VS Code e conecta sua equipe ao motor de análise de requisitos da Vericode, aplicando as características de qualidade definidas pela norma ISO/IEEE 29148.

Funcionalidades

Como usar

1. Abrir o chat

Pressione Ctrl+Alt+I (ou Cmd+Alt+I no macOS) para abrir o painel de chat, ou execute o comando Dott-AI: Abrir Chat na paleta de comandos (Ctrl+Shift+P).

No campo de mensagem, mencione @dott-ai seguido do comando desejado.

2. Verificar a qualidade de escrita

@dott-ai /writing-rules ./docs/historia-login.md

O dott.AI analisa o documento contra as 9 características da ISO/IEEE 29148 (correto, não ambíguo, completo, consistente, classificado, verificável, modificável, rastreável e viável) e lista cada problema encontrado com o trecho original e a sugestão de melhoria.

3. Verificar conformidade com regras de negócios

@dott-ai /business-rules "./docs/historia-login.md" "./docs/regras"

A pasta de regras pode conter arquivos .md e .pdf. O dott.AI indexa os documentos em um banco vetorial e verifica se cada seção da estória está em conformidade com as regras encontradas.

4. Pontuar a estória

@dott-ai /story-score ./docs/historia-login.md

Gera uma pontuação de 0 a 100, um relatório detalhado em Markdown e um PDF — publicados automaticamente no seu wiki configurado (Azure DevOps, GitHub Wiki ou Confluence).

5. Reescrever a estória

@dott-ai /story-rewrite ./docs/historia-login.md

Aplica as sugestões de escrita e regras de negócios e abre um diff linha a linha de cada alteração proposta.

6. Formatar documento

@dott-ai /formatting-rules "./docs/historia-login.md"

Usa o conjunto de regras de formatação padrão do dott.AI ou um arquivo de regras personalizado.

7. Gerar testes de API

@dott-ai /generate-tests "./api/swagger.json" "./docs/historia-login.md"

Lê o contrato OpenAPI e o documento de requisitos e produz cenários de teste estruturados em JSON.

8. Converter testes para BDD

@dott-ai /generate-tests-bdd ./out/tests.json

Converte o JSON gerado pelo comando anterior em arquivos Gherkin BDD em português (Funcionalidade, Cenário, Dado, Quando, Então).

Fontes suportadas

O dott.AI lê e escreve em múltiplas plataformas. Informe o provedor com uma flag no prompt:

Exemplo com Azure DevOps:

@dott-ai /story-score --azure MeuProjeto/Historia-Login

Exemplo com GitHub Wiki:

@dott-ai /writing-rules --github owner/repo/Historia-Login

Exemplo com Confluence:

@dott-ai /story-score --confluence PROJ/Historia-Login

Configuração

Acesse Arquivo → Preferências → Configurações e pesquise por dott-ai.

Credenciais

A senha da API é carregada automaticamente a partir de um arquivo .env na raiz do workspace:

DOTT_API_PASSWORD=sua-senha-aqui

Para Atlassian (Confluence/Jira), execute o comando Dott-AI: Definir Credenciais do Atlassian na paleta de comandos para iniciar o fluxo OAuth 2.0.

Requisitos

• VS Code 1.109 ou superior
• Acesso à API do dott.AI (credenciais fornecidas pela Vericode)

Suporte

Dúvidas ou problemas? Entre em contato com a equipe Vericode em vericode.com.br.