Menções de contexto
Referencie elementos específicos do seu projeto diretamente em conversas Bob usando menções @ para assistência precisa e consciente do contexto.
Tipos de menções
Com menções de contexto, você pode referenciar vários elementos do seu projeto:
| Tipo de menção | Formato | Descrição | Exemplo de uso |
|---|---|---|---|
| Arquivo | @/caminho/para/arquivo.ts | Inclui conteúdo do arquivo no contexto da solicitação | Explique a função em @/src/utils.ts |
| Pasta | @/caminho/para/pasta | Inclui conteúdo de todos os arquivos diretamente na pasta (não recursivo) | Analise o código em @/src/components |
| Problemas | @problems | Inclui diagnósticos do painel de Problemas do IBM Bob | @problems Corrija todos os erros no meu código |
| Terminal | @terminal | Inclui comando de terminal recente e saída | Corrija os erros mostrados em @terminal |
| Commit Git | @a1b2c3d | Referencia commit específico por hash | O que mudou no commit @a1b2c3d? |
| Mudanças Git | @git-changes | Mostra mudanças não commitadas | Sugira uma mensagem para @git-changes |
| URL | @https://example.com | Importa conteúdo de website | Resuma @https://docusaurus.io/ |
Menções de arquivo
Menções de arquivo são o tipo mais comumente usado, permitindo que você inclua o conteúdo de arquivos específicos na sua conversa com Bob.
| Capacidade | Detalhes |
|---|---|
| Formato | @/caminho/para/arquivo.ts (sempre comece com / da raiz do workspace) |
| Fornece | Conteúdo completo do arquivo com números de linha |
| Funciona com | Arquivos de texto, PDFs e arquivos DOCX (com extração de texto) |
| Funciona em | Solicitações iniciais, respostas de feedback e mensagens de acompanhamento |
| Limitações | Arquivos muito grandes podem ser truncados; arquivos binários não são suportados |
Para arquivos grandes, você pode mencionar seções específicas usando o caminho do arquivo seguido por números de linha, como @/src/app.js:10-20 para incluir apenas as linhas 10-20.
Menções de pasta
Com menções de pasta, você pode referenciar múltiplos arquivos de uma vez, fornecendo contexto mais amplo de um diretório.
| Capacidade | Detalhes |
|---|---|
| Formato | @/caminho/para/pasta (sem barra final) |
| Fornece | Conteúdo completo de todos os arquivos dentro do diretório |
| Inclui | Conteúdo de arquivos de texto não binários diretamente dentro da pasta (não recursivo) |
| Melhor para | Fornecer contexto de múltiplos arquivos em um diretório |
| Dica | Esteja atento aos limites da janela de contexto ao mencionar diretórios grandes |
Menções de pasta não são recursivas, significando que incluem apenas arquivos diretamente na pasta especificada, não em subpastas.
Menção de problemas
A menção de problemas importa diagnósticos do painel de Problemas do IBM Bob, ajudando você a resolver múltiplos problemas de uma vez.
| Capacidade | Detalhes |
|---|---|
| Formato | @problems |
| Fornece | Todos os erros e avisos do painel de problemas do IBM Bob |
| Inclui | Caminhos de arquivo, números de linha e mensagens de diagnóstico |
| Agrupa | Problemas organizados por arquivo para melhor clareza |
| Melhor para | Corrigir erros sem cópia manual |
Exemplo de uso: @problems Você pode me ajudar a corrigir todos esses problemas?
Menção de terminal
Menções de terminal capturam saída de comando recente, ajudando você a depurar erros de build ou analisar resultados de comando.
| Capacidade | Detalhes |
|---|---|
| Formato | @terminal |
| Captura | Último comando e sua saída completa |
| Preserva | Estado do terminal (não limpa o terminal) |
| Limitação | Limitado ao conteúdo do buffer de terminal visível |
| Melhor para | Depurar erros de build ou analisar saída de comando |
Ao solucionar uma falha de build, tente
O que há de errado com @terminal? para obter insights imediatos sobre o erro sem copiar manualmente a saída.
Menções Git
Menções Git ajudam você a trabalhar com controle de versão referenciando commits e mudanças.
| Tipo | Formato | Fornece | Limitações |
|---|---|---|---|
| Commit | @a1b2c3d | Mensagem de commit, autor, data e diff completo | Funciona apenas em repositórios Git |
| Mudanças de trabalho | @git-changes | Saída de git status e diff de mudanças não commitadas | Funciona apenas em repositórios Git |
Exemplo de uso: Qual é o propósito de @a1b2c3d? ou Sugira uma mensagem de commit para @git-changes
Menções de URL
Menções de URL permitem que você referencie conteúdo web externo em suas conversas com Bob.
| Capacidade | Detalhes |
|---|---|
| Formato | @https://example.com |
| Processamento | Usa navegador headless para buscar conteúdo |
| Limpeza | Remove scripts, estilos e elementos de navegação |
| Saída | Converte conteúdo para Markdown para legibilidade |
| Limitação | Páginas complexas podem não converter perfeitamente |
Menções de URL são úteis para referenciar documentação.
Tente Você pode explicar @https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise para obter ajuda entendendo um conceito com os documentos oficiais como contexto.
Usar menções de contexto
Digite @ na entrada de chat para acionar o dropdown de sugestões.
Continue digitando para filtrar sugestões ou use as setas para navegar.
Selecione com a tecla Enter ou clique do mouse.
Combine múltiplas menções em uma solicitação: "Corrija @problems em @/src/component.ts"
Destaque texto e use o atalho de teclado ⌘ + L para adicioná-lo ao chat.
O dropdown sugere automaticamente:
- Arquivos abertos recentemente
- Pastas visíveis
- Commits git recentes
- Palavras-chave especiais (
problems,terminal,git-changes) - Todos os arquivos atualmente abertos (independentemente de configurações de ignore ou filtros de diretório)
O dropdown filtra automaticamente diretórios comuns como node_modules, .git, dist e out para reduzir ruído, embora você possa incluir seu conteúdo se digitado manualmente.
Você pode combinar múltiplas menções em uma única solicitação. Tente Compare @/src/v1/api.js com @/src/v2/api.js e explique as diferenças.
Comportamentos importantes
Interações com arquivo ignore
Menções de contexto têm comportamentos específicos ao interagir com arquivos ignorados:
| Comportamento | Descrição |
|---|---|
Bypass de .bobignore | @menções de arquivo e pasta ignoram verificações de .bobignore ao buscar conteúdo para contexto. Conteúdo de arquivos ignorados será incluído se mencionado diretamente. |
Bypass de .gitignore | Similarmente, @menções de arquivo e pasta não respeitam regras de .gitignore ao buscar conteúdo. |
| Respeito a comando Git | Menções relacionadas a Git (@git-changes, @commit-hash) respeitam .gitignore pois dependem de comandos Git. |
Menções de contexto ignoram regras de ignore, então você pode referenciar arquivos específicos que normalmente seriam ignorados por Bob ou Git. Essa capacidade é particularmente útil quando você precisa discutir arquivos gerados ou outro conteúdo tipicamente ignorado.
Juntando tudo
Menções de contexto aprimoram suas interações com Bob fornecendo referências precisas aos elementos do seu projeto. Em vez de copiar e colar código ou descrever localizações de arquivo, você pode referenciar diretamente o que está discutindo.
Combinações eficazes de diferentes tipos de menção:
Corrija @problems em @/src/components e explique o que estava erradoRevise @git-changes e sugira melhoriasCompare @/v1/api.js com @https://api-docs.example.com e verifique inconsistências
Ao usar menções de contexto efetivamente, você pode se comunicar mais precisamente com Bob e receber assistência mais direcionada.
Subagents
Aprende como o Bob usa subagents para lidar com tarefas focadas e autónomas em contextos isolados sem poluir a conversa principal.
Dicas do Bob
As dicas do Bob detectam problemas de qualidade de código em tempo real com sugestões de refatoração impulsionadas por IA para funções complexas. Reduza a dívida técnica enquanto programa.