Literate coding
Tulis kode dengan bantuan AI langsung di editormu menggunakan instruksi bahasa alami tepat di tempat kode seharusnya berada. Bob menghasilkan implementasi dalam konteks dengan inline diff.
Kenapa pakai literate coding?
- Tetap dalam workflowmu: Tulis kode tanpa perlu beralih ke antarmuka chat
- Kontrol yang tepat: Tentukan persis di mana dan bagaimana AI harus memodifikasi kodemu
- Ungkapkan maksudmu secara alami: Deskripsikan apa yang kamu inginkan dalam bahasa biasa atau pseudocode
- Lihat perubahan sebelum commit: Tinjau diff untuk memastikan kode yang dihasilkan memenuhi kebutuhanmu
Cara kerjanya
Ketika kamu mengaktifkan mode literate coding, kamu bisa menulis instruksi bahasa alami, pseudocode, anotasi, atau potongan kode parsial langsung di file sumbermu. Instruksi ini muncul disorot dengan biru untuk membedakannya dari kode biasa.
Ketika kamu menjalankan perintah Generate, Bob:
- Menganalisis seluruh file termasuk blok literate coding-mu
- Memahami konteks sekitar dan maksudmu
- Mengganti instruksimu dengan kode nyata yang bisa dieksekusi
- Menampilkan inline diff agar kamu bisa meninjau perubahan
Pendekatan ini menggabungkan ekspresivitas bahasa alami dengan presisi pengeditan kode langsung.
Mulai menggunakan
Penggunaan dasar
- Toggle mode literate coding:
- Tekan Cmd+I (Mac) atau Ctrl+I (Windows/Linux)
- Atau klik ikon magic wand di toolbar editor
- Tulis instruksimu:
- Ketik pseudocode, instruksi bahasa alami, atau anotasi
- Teksmu muncul dalam warna biru, menandainya sebagai konten literate coding
- Hasilkan kode:
- Tekan Cmd+Enter (disarankan) atau klik tombol Generate
- Bob mengkonversi instruksimu menjadi kode nyata dan menampilkan inline diff
- Tinjau dan terapkan:
- Terima perubahan: Cmd+Enter
- Tolak perubahan: Cmd+Shift+Backspace
- Perubahan ditulis ke file sebelum penerimaan, memungkinkanmu menguji sebelum memutuskan
Pelajari cara menghasilkan kode dari komentar menggunakan literate coding.
Tips dan best practice
- Jadilah spesifik tentang persyaratanmu dalam instruksi
- Sertakan konteks relevan seperti tipe variabel atau parameter fungsi
- Untuk logika kompleks, pecah instruksimu menjadi blok yang lebih kecil dan terfokus
- Gunakan literate coding baik untuk membuat kode baru maupun memodifikasi kode yang ada
Keterbatasan saat ini
- Cakupan satu file: Saat ini bekerja pada satu file sekaligus (dukungan multi-file direncanakan)
- Fitur preview: Harapkan peningkatan berkelanjutan pada styling, diffing, dan perilaku AI
Pull requests
Buat pull request dan deskripsi PR langsung dari IDE-mu. Bob menganalisis perubahan, membuat deskripsi detail, dan menyederhanakan workflowmu.
Skills
Buat instruction set yang bisa digunakan kembali untuk workflow khusus. Definisikan custom workflow, tambahkan file pendukung, dan ajarkan Bob task-task khusus untuk hasil yang konsisten.