Notas no diff
Comente linhas do diff que o agente produziu e devolva as notas para ele corrigir.
As notas são comentários locais presos a linhas do diff de um workspace. Elas servem para dizer ao agente o que mudar. Nunca são publicadas no GitHub nem no GitLab. Ficam salvas no workspace, sobrevivem ao reiniciar o app e funcionam também em workspaces de pasta.
Onde anotar
- No diff de um arquivo, aberto pelo painel Source Control.
- No diff combinado (Open All Changes ou Open Branch Diff).
As notas vão no lado modificado (direita) do diff, nas linhas que o diff permite comentar. Diffs grandes demais para o modo normal não aceitam notas.
Criar uma nota
- Com o mouse: passe sobre a linha e clique no + da margem (Add note for the AI). Arraste na margem para cobrir várias linhas.
- Com o teclado: selecione o trecho e use Add Review Note.
| Ação | macOS | Linux e Windows |
|---|---|---|
| Adicionar nota à seleção | ⇧⌘A | Ctrl+Shift+A |
| Abrir o painel Source Control | ⇧⌘G | Ctrl+Shift+G |
| Próxima ou anterior mudança | F7 / ⇧F7 | F7 / Shift+F7 |
No rascunho, Enter salva, Shift+Enter quebra a linha e Esc cancela. Uma nota salva pode ser editada, apagada ou enviada sozinha. Editar uma nota já enviada a marca como não enviada de novo.
Gerenciar as notas
A seção Notes do painel Source Control lista as notas por arquivo, com enviar, copiar todas e limpar. No cabeçalho do diff, AI notes mostra quantas notas existem, para o arquivo atual ou para todas as não enviadas.
Enviar para o agente
O menu Send notes to lista os agentes rodando no workspace, com o estado de cada um. New agent abre um agente novo com as notas como primeiro prompt.
Um agente aparece desabilitado quando está pedindo permissão, quando o estado dele está desatualizado ou quando o terminal ou o chat já fechou. Num terminal, o Dusky cola o texto e aperta Enter; num chat, usa a caixa de mensagem do próprio chat. As notas entregues saem da lista.
O comando Send Review Notes to Agent não tem atalho padrão; defina um em Settings → Shortcuts se quiser.
O que o agente recebe
Um bloco por nota:
File: src/app.ts
Line: 42
User comment: "Trate o caso de lista vazia antes do map."Uma nota que cobre várias linhas usa Lines: 40-45, e uma nota sobre o arquivo inteiro usa Scope: file.
PRs, MRs e checks
O painel Checks, na barra lateral direita, mostra o status do PR (GitHub) ou do MR (GitLab), os jobs de CI com trecho do log e os conflitos.
- Fix With AI manda o agente corrigir o que falhou.
- Resolve Review Conflicts With AI e Sync Branch cuidam dos conflitos.
- Os comentários da revisão aparecem agrupados ou em linha do tempo. Dá para enfileirar comentários e mandar todos para o agente resolver.
As ações com IA dependem da configuração de IA do Source Control.
Diferenças entre provedores
- GitHub (pela CLI
gh): conversa, arquivos e checks; comentários em linha, respostas, edição, reações, arquivos marcados como vistos, revisores, rodar checks de novo, merge e auto-merge, fechar e reabrir, e começar um workspace a partir do PR. - GitLab (pela CLI
glab): conversa, arquivos e pipeline; comentários, revisores, log e nova tentativa de jobs, merge, fechar e reabrir, e criar um workspace a partir do MR. - No painel Checks, só o GitHub permite comentar, responder, editar e reagir. No GitLab, dá para resolver a discussão inteira.
- Nenhum dos dois tem, no Dusky, os botões de aprovar ou pedir mudanças.