Literate Coding
Écris du code avec l'assistance de l'IA directement dans ton éditeur en utilisant des instructions en langage naturel exactement là où le code doit aller. Bob génère l'implémentation en contexte avec des inline diffs.
Pourquoi utiliser le Literate Coding ?
- Reste dans ton flux de travail : Écris du code sans passer à des interfaces de chat
- Garde un contrôle précis : Spécifie exactement où et comment l'IA doit modifier ton code
- Exprime ton intention naturellement : Décris ce que tu veux en langage naturel ou en pseudocode
- Vois les modifications avant de les valider : Examine les diffs pour t'assurer que le code généré répond à tes besoins
Comment ça fonctionne
Lorsque tu actives le mode Literate Coding, tu peux écrire des instructions en langage naturel, du pseudocode, des annotations ou des extraits de code partiels directement dans ton fichier source. Ces instructions apparaissent surlignées en bleu pour les distinguer du code ordinaire.
Lorsque tu lances la commande Générer, Bob :
- Analyse l'intégralité du fichier, y compris tes blocs de Literate Coding
- Comprend le contexte environnant et ton intention
- Remplace tes instructions par du code réel et exécutable
- T'affiche un inline diff pour que tu puisses examiner les modifications
Cette approche combine l'expressivité du langage naturel avec la précision de l'édition directe de code.
Démarrage
Utilisation de base
- Activer ou désactiver le mode Literate Coding :
- Appuie sur Cmd+I (Mac) ou Ctrl+I (Windows/Linux)
- Ou clique sur l'icône baguette magique dans la barre d'outils de l'éditeur
- Écris tes instructions :
- Tape du pseudocode, des instructions en langage naturel ou des annotations
- Ton texte apparaît en bleu, le marquant comme contenu Literate Coding
- Génère le code :
- Appuie sur Cmd+Enter (recommandé) ou clique sur le bouton Générer
- Bob convertit tes instructions en code réel et affiche un inline diff
- Vérifie et applique :
- Accepter les modifications : Cmd+Enter
- Rejeter les modifications : Cmd+Shift+Backspace
- Les modifications sont écrites dans ton fichier avant acceptation, ce qui te permet de les tester avant de décider
Apprends à générer du code à partir de commentaires avec le Literate Coding.
Conseils et bonnes pratiques
- Sois précis dans tes instructions sur tes exigences
- Inclus le contexte pertinent comme les types de variables ou les paramètres de fonctions
- Pour une logique complexe, décompose tes instructions en blocs plus petits et ciblés
- Utilise le Literate Coding aussi bien pour créer du nouveau code que pour modifier du code existant
Limitations actuelles
- Portée d'un seul fichier : Fonctionne actuellement sur un fichier à la fois (prise en charge multi-fichiers prévue)
- Fonctionnalité en aperçu : Attends-toi à des améliorations continues du style, du diffing et du comportement de l'IA
Pull Requests
Générez des Pull Requests et des descriptions de PR directement depuis votre IDE. Bob analyse les modifications, crée des descriptions détaillées et rationalise votre flux de travail.
Skills
Crée des jeux d'instructions réutilisables pour des workflows spécialisés. Définis des workflows personnalisés, ajoute des fichiers de support et apprends à Bob des tâches spécialisées pour des résultats cohérents.