最佳實踐

遵循這些指引,充分發揮 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}/ 目錄中建立模式特定的規則。
  • 使用規則來強制執行編碼標準、文件要求或其他工作流程限制。

如需自訂模式和規則的更多資訊,請參閱自訂模式文件。

這個主題如何?