功能
Literate Coding
直接在編輯器中使用自然語言指令編寫程式碼，指令就放在程式碼應該出現的位置。Bob 透過 inline diff 在上下文中產生實作內容。
為什麼使用 Literate Coding？
- 保持在工作流程中：無需切換到聊天介面即可編寫程式碼
- 保持精確控制：精確指定 AI 應在何處以何種方式修改程式碼
- 自然表達意圖：用自然語言或 pseudocode 描述你想要的內容
- 提交前查看變更：查看 diff 以確保產生的程式碼符合需求
運作原理
當你啟用 Literate Coding 模式時，可以直接在原始檔中撰寫自然語言指令、pseudocode、註解或部分程式碼片段。這些指令以藍色高亮顯示，與一般程式碼區分開來。
當你執行 Generate 命令時，Bob 會：
- 分析整個檔案，包括你的 Literate Coding 區塊
- 理解周圍的上下文和你的意圖
- 將你的指令替換為真實的、可執行的程式碼
- 顯示 inline diff，供你審查變更
這種方法將自然語言的表達力與直接程式碼編輯的精確性相結合。
入門
基本用法
- 切換 Literate Coding 模式：
- 按 Cmd+I（Mac）或 Ctrl+I（Windows/Linux）
- 或點擊編輯器工具列中的魔法棒圖示
- 編寫指令：
- 輸入 pseudocode、自然語言指令或註解
- 文字以藍色顯示，標記為 Literate Coding 內容
- 產生程式碼：
- 按 Cmd+Enter（建議）或點擊 Generate 按鈕
- Bob 將指令轉換為真實程式碼並顯示 inline diff
- 審查並套用：
- 接受變更：Cmd+Enter
- 拒絕變更：Cmd+Shift+Backspace
- 變更在接受之前已寫入檔案，讓你可以在決定前先進行測試
了解如何使用 Literate Coding 從注解產生程式碼。
技巧與最佳實踐
- 在指令中對需求進行具體說明
- 包含相關上下文，例如變數型別或函式參數
- 對於複雜邏輯，將指令拆分為更小、更集中的區塊
- 將 Literate Coding 用於建立新程式碼和修改現有程式碼
目前限制
- 單一檔案範圍：目前每次只能處理一個檔案（計劃支援多檔案）
- 預覽功能：樣式、diffing 和 AI 行為將持續改進
這個主題如何？