最佳實踐
遵循這些指引,充分發揮 Bob Shell 的使用體驗。
了解並使用模式
Bob 的模式是針對特定任務的角色設定,可塑造其行為。選擇適當的模式有助於獲得最佳結果。
內建模式
Bob Shell 提供三種內建模式,各自為特定目的而設計:
| 模式 | 目的 | 使用時機 |
|---|---|---|
| Agent | 撰寫和修改程式碼 | 用於實作功能、修復錯誤或改善程式碼 |
| Plan | 規劃和設計 | 在實作之前,當你需要規劃架構或建立技術規格時 |
| Ask | 取得資訊 | 當你需要說明或資訊而不修改檔案時 |
模式選擇策略
最有效的工作流程:
從 Plan 模式開始,用於新專案或複雜功能,在撰寫任何程式碼之前建立詳細的實作計畫。 仔細閱讀計畫,確認它符合你的目標。
切換到 Agent 模式,用於大多數日常開發任務,當你準備好實作時。
使用 Ask 模式,當你需要說明或資訊而不修改檔案時。
在 bob chat 工作階段中,透過輸入 /mode agent、/mode plan 或 /mode ask 來切換模式。如需更多詳細資訊,請參閱模式。
自訂模式
你可以為特定任務或工作流程建立專門的模式:
- 為安全審查或文件撰寫等特定任務建立模式。
- 設定具有特定工具存取權限和角色定義的自訂模式。
- 與你的團隊分享模式以標準化工作流程。
在自訂模式文件中了解更多關於建立和設定自訂模式的資訊。
工作流程最佳化
先規劃再編碼
對於複雜的專案或功能,始終從 Plan 模式開始:
- 產生詳細的實作計畫。
- 將複雜問題分解為可管理的步驟。
- 在問題出現之前識別潛在挑戰。
- 建立實作路線圖。
這種方法可以防止破壞性更改,並為開發提供明確的方向。
使用 git 作為安全網
頻繁提交工作,以便在出現不希望的更改時可以恢復:
- 建立頻繁的小型 commit,並附上清晰的訊息。
- 定期將更改推送到遠端儲存庫。
- 對實驗性功能使用分支。
如果 Bob 產生了不佳的結果,恢復到先前的 commit 比嘗試用新指令修正有缺陷的輸出更有效。恢復後開始新的 bob chat 工作階段,讓錯誤的輸出不再出現在上下文中。
監控使用量並最佳化成本
透過查看你的帳戶使用量來追蹤 Bobcoin 消耗。注意上下文視窗大小——大型對話消耗更多 token,因此也消耗更多 Bobcoins。
與版本控制整合
Git 提供了防止意外永久刪除程式碼的重要安全網。在重大 AI 輔助更改之前和之後定期提交。
溝通策略
撰寫有效的提示
提示的品質直接影響 Bob 回應的品質:
- 具體且清晰:模糊的提示會導致模糊的輸出。詳細說明 Bob 應該和不應該做什麼。
- 提供範例:如果可能,包含所需輸出格式或風格的範例。
使用上下文提及
上下文提及讓你可以在與 Bob Shell 的對話中直接引用專案的特定元素:
- 使用
@/path/to/file.js包含特定的檔案內容。 - 使用
@/path/to/folder包含目錄中的所有檔案。
bob chat
# 引用特定檔案
> 說明 @src/utils.js 的功能和運作方式
# 引用目錄
> 審查 @tests/ 中的測試並找出任何缺口這種方法比複製貼上程式碼或描述檔案位置更有效率。
管理上下文視窗
Bob 的上下文視窗為 270,000 個 token,包含你的對話歷史記錄、檔案內容和工具輸出。若要有效使用它:
- 定期開始新的
bob chat工作階段,並設定具體目標。 - 避免一次給 Bob 整個程式碼庫。
- 使用直接的檔案引用來提供有針對性的上下文。
- 將複雜任務分解為較小的、專注的子任務。
請參閱上下文視窗管理,深入了解上下文視窗的運作方式和管理策略。
安全與控制
設定自動核准設定
Bob Shell 允許你控制哪些動作在執行前需要你的核准:
- 手動核准:審查並核准 Bob 採取的每個動作(最安全的設定)。
- 自動核准:授予 Bob 在不中斷的情況下執行特定任務的能力。
- 混合方法:對低風險動作自動核准,同時對風險較高的任務要求確認。
- 自動核准的指令:定義 Bob 可以在不每次請求核准的情況下執行的受信任指令清單。
根據你的舒適程度和專案的敏感性,在 ~/.bob/settings/settings.json 中設定這些設定。
在自動核准動作文件中了解更多關於自動核准設定的資訊。
使用 .bobignore
.bobignore 檔案讓你可以指定 Bob 不應存取或修改的檔案和目錄:
在你的專案根目錄中建立 .bobignore 檔案。
為敏感檔案、建置產物和大型資產新增匹配模式。
使用與 .gitignore 相同的語法。
這有助於保護敏感資訊並防止意外更改產生的檔案。
在忽略檔案文件中了解更多關於控制檔案存取的資訊。
如需安全指引的更多詳細資訊,請參閱安全指引。
設定規則
Bob 允許你指定規則來控制 Bob 執行任務的方式:
- 在
.bob目錄中全域或按專案定義規則。 - 在
.bob/rules-{mode-slug}/目錄中建立模式特定的規則。 - 使用規則來強制執行編碼標準、文件要求或其他工作流程限制。
如需自訂模式和規則的更多資訊,請參閱自訂模式文件。