工作坊教材 · IBM Bob 入門
IBM Bob 入門操作指南
本教材帶領您快速掌握 IBM Bob 的三大核心模式、Skill 安裝與 MCP Server 觀念，並透過實際對話範例，讓您在 10 分鐘內上手 AI 輔助開發。
IBM Bob 是什麼？
IBM Bob 是一個專為企業級軟體工程與維運設計的 Agent-native 開發助手。與通用型聊天 AI 相比，Bob 擁有更強的專案理解力、工具自動化執行能力與更嚴格的架構規範。
Mode 1
Plan 規劃模式
專注於分析複雜需求、架構設計或擬定步驟。在此模式下，Bob 會在不撰寫繁複代碼的前提下，幫助您列出技術規範、分析影響範圍與生成 ADR 文件。
Mode 2
Ask 知識模式
專門用來檢索知識、讀懂代碼，或查閱技術文件。適合在新進入一個 Codebase、解讀 COBOL 舊系統或排查日誌錯誤時使用，此模式不會隨意修改您的本地檔案。
Mode 3
Agent 執行模式
具備完整代碼編輯、命令執行、工具呼叫等高權限功能。當規劃與觀念確定後，切換至此模式可讓 Bob 自動為您修改程式碼、建立檔案與執行本地測試。
IBM Bob 核心觀念
在使用 Bob 時，您會經常接觸到三個核心名詞，了解它們能讓您的對話事半功倍：
| 名詞 | 核心含意 | 在工作坊中的實際用途 |
|---|---|---|
| Mode (模式) | 設定 AI 的行為守則與可用工具集。 | 防止 AI 在您只想問問題時隨意修改您的程式碼，提升安全與效率。 |
| Skill (技能) | 一組可重複使用的特定工作流與專業指導原則。 | 讓 Bob 立即載入「COBOL 萃取」、「Ansible 撰寫」等特殊領域的專家知識。 |
| MCP Server | Model Context Protocol 伺服器，連接外部工具與資料源。 | 讓 Bob 能夠直接讀取 Excel、檢索 Obsidian 知識庫或查詢本地開發環境。 |
快速上手：你的第一個 AI 對話
接下來，我們將模擬一個常見的開發任務：向 Bob 描述需求、生成一份專案報告，並將其轉換成 HTML 頁面。
分析需求 (Plan 模式)
首先將模式切換至 Plan，向 Bob 詢問：「我想做一個 AI 應用的簡報報告，請幫我規劃報告大綱與包含的章節。」
# 提示詞範例 我目前需要設計一份關於 IBM Bob 核心價值的報告，請幫我規劃包含三大核心痛點的大綱。
產生報告內容 (Agent 模式)
對大綱滿意後，切換至 Agent 模式，讓 Bob 直接在本地建立 Markdown 檔案。
# 提示詞範例 請在本地建立 artifacts/report.md，並將剛才規劃的三大核心痛點大綱，擴寫成完整的繁體中文內容。
轉換報告為 HTML
讓 Bob 一次性將報告渲染成符合特定風格的 HTML。
# 提示詞範例 請使用 markdown-to-html 技能，將 report.md 轉換成 report.html，並使用 Carbon Design System 的極簡無陰影樣式。
如何安裝與啟動一個 Skill
Bob 的能力是可無限擴展的。您可以透過對話直接載入系統中已註冊的專業 Skill：
# 尋找可用的技能 請幫我列出專案中所有的可載入技能。 # 使用特定技能 (例如：使用 find-skills 技能) # 小技巧：在對話框輸入 "/" 可快速選擇已安裝的技能 /find-skills
如何設定 MCP
MCP（Model Context Protocol）可讓 Bob 連接外部工具與服務，擴展其原生能力。您只需將設定描述給 Bob，它便能協助您完成設定：
Prompt 範例
將以下設定貼給 Bob，請它協助您完成 MCP 設定流程：
請幫我設定以下 MCP server，並說明設定完成後我可以用它做什麼：
"apple-books-mcp": {
"command": "uvx",
"args": [ "apple-books-mcp@latest" ]
}
Bob 會引導您找到正確的設定檔路徑、確認系統相依套件（如 uv）是否已安裝，並驗證設定是否生效。
專業提示 (Pro Tip)
一次只做一件事
在使用 Agent 模式時，建議將複雜的任務拆解成多個小對話。先用 Plan 模式進行架構確認，再用 Agent 模式寫代碼，最後在 Ask 模式下進行程式碼複審，這能保證最高的生成品質。