教學

標準化 Bob 的行為

使用專案層級規則檔案在團隊中標準化 Bob 的行為,這些檔案指示 Bob 記錄其程式碼並記住其先前的操作。

Bob 規則是定義應用於每次 Bob 對話的指令的純文字檔案。Bob 將規則作為檔案儲存在專案內的指定資料夾中或全域使用者層級,並自動將每個規則檔案的內容注入到所有模式的每次對話中。規則注入允許團隊和個人開發者執行編碼標準、通訊偏好和工作流程約束,而無需在每個提示中重複指令。

galaxium-travels/.bob 中的專案層級規則與您的程式碼一起進行版本控制,這意味著:

  • 規則會自動傳播到複製儲存庫的所有團隊成員。
  • 對規則的變更會經過正常的程式碼審查流程。
  • 規則歷史記錄在 git 中追蹤。

在本教學中,您透過在 .bob 目錄中新增規則檔案來指示 Bob 簡潔地說話、記錄其程式碼並記住其先前的操作。由於您將這些檔案包含在版本控制中,Bob 將在整個團隊中應用它們。

先決條件

要完成本教學,您需要以下內容:

  • 如果您還沒有,請複製 Galaxium Travels 示範程式碼。複製命令還會檢出包含您在教學中使用的程式碼的 bob-learning-path-branch 分支。
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels
  • 開啟 Galaxium Travels 示範程式碼的 Bob IDE
  • 完成啟動專案教學以建立 .bob 資料夾。
  • 雖然不是必需的,但請考慮完成快速入門教學以熟悉 Bob 的介面和功能。
  • Python 或 Python 3。您可以從官方網站下載 Python。

建立自訂 Bob 規則檔案

Bob 的 /init 命令會建立一個 .bob 資料夾,其中包含每個 Bob 模式的 AGENTS.md 檔案,這些檔案指導 Bob 在每個模式中的行為。透過向 rules 資料夾新增新檔案來建立您自己的自訂規則。Bob 將讀取規則檔案的內容,這意味著您新增的指令將應用於與 Bob 的所有互動。

建立規則資料夾

如果 .bob 中還不存在 rules 資料夾,請建立一個。

建立規則檔案

galaxium-travels/.bob/rules/ 中建立一個名為 basic_rules.md 的檔案。

在專案中建立的 .bob/rules/basic_rules.md 檔案

建立自訂 Bob 規則

basic_rules.md 檔案中,透過新增以下文字來建立自訂規則:

新增文件標準規則

Always include concise JSDoc strings for every public function.

文件標準規則確保 Bob 在編寫或修改公共函式時產生一致的文件,無論任務如何。

新增通訊風格規則

Be very concise in your wording.

通訊風格規則控制 Bob 如何表述回應和註解,這對於喜歡簡潔、直接輸出而不是詳細解釋的團隊很有用。

新增內部獨白規則

Write a summary of every interaction into the folder `internal-monologue/`.
Name the file starting with a timestamp, followed by a concise description of the interaction.
Example: 2026-01-15_update-readme.md

內部獨白會產生 Bob 在所有對話中所做的所有事情的持久日誌。

內部獨白的好處包括以下內容:

  • 稽核追蹤:記錄 Bob 進行了哪些變更以及何時進行的。
  • 跨工作階段連續性:Bob 可以在未來的對話中引用內部獨白資料夾以了解先前的工作。
  • 團隊透明度:在共享儲存庫中,獨白顯示不同團隊成員使用 Bob 做了什麼。

新增所有規則後,您的 basic_rules.md 檔案將如下所示:

新增了所有三個自訂規則的 basic_rules.md 檔案

測試規則

開啟代理聊天側邊欄,切換到程式碼模式,並執行以下提示讓 Bob 編輯 README.md。Bob 可能會提出建議,例如透過更好的故障排除進行增強、完全改造或修復不準確之處。您可以選擇最適合您對 README 的願景的建議。

Update the readme

Bob 更新 README.md 並建立一個名為 internal-monologue 的資料夾,並建立一個檔案,向您顯示它對 README 所做的更新。

Bob 更新 README.md 並建立內部獨白檔案

後續步驟

在本教學中,您了解了 Bob 規則如何讓您定義應用於每次對話和模式的持久指令。專案層級規則與您的程式碼一起進行版本控制,因此您的團隊會自動共享相同的標準。內部獨白模式為您提供了 Bob 在所有工作階段中的操作的稽核追蹤。

繼續學習新增 Bob 功能,了解如何建立自訂模式,這些模式定義具有客製化指令和特定工具存取權限的專業角色。

這個主題如何?