Literate Coding
Escreve código com assistência de IA diretamente no teu editor usando instruções em linguagem natural exatamente onde o código deve ficar. O Bob gera a implementação no contexto com inline diffs.
Por que usar Literate Coding?
- Mantém o teu fluxo de trabalho: Escreve código sem mudar para interfaces de chat
- Mantém controlo preciso: Especifica exatamente onde e como a IA deve modificar o teu código
- Expressa a intenção naturalmente: Descreve o que queres em linguagem natural ou pseudocode
- Vê as alterações antes de confirmar: Revê os diffs para garantir que o código gerado satisfaz as tuas necessidades
Como funciona
Quando ativas o modo Literate Coding, podes escrever instruções em linguagem natural, pseudocode, anotações ou fragmentos de código parciais diretamente no teu ficheiro de origem. Estas instruções aparecem destacadas a azul para as distinguir do código normal.
Quando executas o comando Generate, o Bob:
- Analisa o ficheiro completo, incluindo os teus blocos de Literate Coding
- Compreende o contexto envolvente e a tua intenção
- Substitui as tuas instruções por código real e executável
- Mostra-te um inline diff para que possas rever as alterações
Esta abordagem combina a expressividade da linguagem natural com a precisão da edição direta de código.
Começar
Utilização básica
- Ativar ou desativar o modo Literate Coding:
- Prime Cmd+I (Mac) ou Ctrl+I (Windows/Linux)
- Ou clica no ícone de varinha mágica na barra de ferramentas do editor
- Escreve as tuas instruções:
- Escreve pseudocode, instruções em linguagem natural ou anotações
- O teu texto aparece a azul, marcando-o como conteúdo de Literate Coding
- Gera o código:
- Prime Cmd+Enter (recomendado) ou clica no botão Generate
- O Bob converte as tuas instruções em código real e mostra um inline diff
- Revê e aplica:
- Aceitar alterações: Cmd+Enter
- Rejeitar alterações: Cmd+Shift+Backspace
- As alterações são escritas no teu ficheiro antes da aceitação, permitindo-te testar antes de decidir
Aprende a gerar código a partir de comentários usando o Literate Coding.
Dicas e boas práticas
- Sê específico sobre os teus requisitos nas instruções
- Inclui contexto relevante como tipos de variáveis ou parâmetros de funções
- Para lógica complexa, divide as tuas instruções em blocos menores e focados
- Usa o Literate Coding tanto para criar novo código como para modificar código existente
Limitações atuais
- Âmbito de ficheiro único: Atualmente funciona num ficheiro de cada vez (suporte para múltiplos ficheiros planeado)
- Funcionalidade em pré-visualização: Espera melhorias contínuas no estilo, no diffing e no comportamento da IA
Pull requests
Gere pull requests e descrições de PR diretamente do seu IDE. Bob analisa mudanças, cria descrições detalhadas e simplifica seu fluxo de trabalho.
Skills
Cria conjuntos de instruções reutilizáveis para workflows especializados. Define workflows personalizados, adiciona ficheiros de suporte e ensina ao Bob tarefas especializadas para resultados consistentes.