Literate Coding
Escribe código con asistencia de IA directamente en tu editor usando instrucciones en lenguaje natural justo donde debe ir el código. Bob genera la implementación en contexto con inline diffs.
¿Por qué usar Literate Coding?
- Mantente en tu flujo de trabajo: Escribe código sin cambiar a interfaces de chat
- Mantén un control preciso: Especifica exactamente dónde y cómo la IA debe modificar tu código
- Expresa tu intención de forma natural: Describe lo que quieres en lenguaje natural o pseudocode
- Ve los cambios antes de confirmarlos: Revisa los diffs para asegurarte de que el código generado cumple tus necesidades
Cómo funciona
Cuando activas el modo Literate Coding, puedes escribir instrucciones en lenguaje natural, pseudocode, anotaciones o fragmentos de código parciales directamente en tu archivo fuente. Estas instrucciones aparecen resaltadas en azul para distinguirlas del código normal.
Cuando ejecutas el comando Generar, Bob:
- Analiza el archivo completo, incluidos tus bloques de Literate Coding
- Comprende el contexto circundante y tu intención
- Reemplaza tus instrucciones con código real y ejecutable
- Te muestra un inline diff para que puedas revisar los cambios
Este enfoque combina la expresividad del lenguaje natural con la precisión de la edición directa de código.
Primeros pasos
Uso básico
- Activar o desactivar el modo Literate Coding:
- Pulsa Cmd+I (Mac) o Ctrl+I (Windows/Linux)
- O haz clic en el icono de varita mágica en la barra de herramientas del editor
- Escribe tus instrucciones:
- Escribe pseudocode, instrucciones en lenguaje natural o anotaciones
- Tu texto aparece en azul, marcándolo como contenido de Literate Coding
- Genera el código:
- Pulsa Cmd+Enter (recomendado) o haz clic en el botón Generar
- Bob convierte tus instrucciones en código real y muestra un inline diff
- Revisa y aplica:
- Aceptar cambios: Cmd+Enter
- Rechazar cambios: Cmd+Shift+Backspace
- Los cambios se escriben en tu archivo antes de la aceptación, lo que te permite probarlos antes de decidir
Aprende cómo generar código a partir de comentarios usando Literate Coding.
Consejos y buenas prácticas
- Sé específico sobre tus requisitos en las instrucciones
- Incluye contexto relevante como tipos de variables o parámetros de funciones
- Para lógica compleja, divide tus instrucciones en bloques más pequeños y enfocados
- Usa Literate Coding tanto para crear código nuevo como para modificar código existente
Limitaciones actuales
- Ámbito de un solo archivo: Actualmente funciona con un archivo a la vez (soporte para múltiples archivos planificado)
- Función en versión preliminar: Espera mejoras continuas en el estilo, el diffing y el comportamiento de la IA
Pull Requests
Genera Pull Requests y descripciones de PR directamente desde tu IDE. Bob analiza los cambios, crea descripciones detalladas y optimiza tu flujo de trabajo.
Skills
Crea conjuntos de instrucciones reutilizables para workflows especializados. Define workflows personalizados, añade archivos de soporte y enseña a Bob tareas especializadas para obtener resultados consistentes.