Conductor for Gemini CLI 入門指南

Conductor 是 Gemini CLI 的一個擴展，於 2025 年 12 月 17 日以預覽版形式發佈，旨在解決 AI 編碼中的上下文缺失問題。它引入了上下文驅動開發（CDD）工作流，通過在倉庫中維護 Markdown 文件來持久化項目上下文，包括編碼標準、技術棧決策和產品目標。自發布以來，Conductor 的 GitHub 倉庫已獲得超過 3600 顆星和 284 個分支。

Conductor 的工作原理分為三層：命令層（Gemini CLI 中的六個斜槓命令）、工件層（倉庫中的 conductor/ 目錄，包含 Markdown 和 JSON 文件）和版本控制層（Git，用於創建每個任務的提交併支持回滾）。這種設計適用於全新項目和現有項目。對於現有項目，/conductor:setup 命令會分析代碼庫，推斷技術棧和架構，並自動填充上下文。

安裝 Conductor 前需要確保 Gemini CLI 已安裝並正常工作，擁有 Google API 密鑰或 Vertex AI 設置，並在項目目錄中初始化 Git。安裝命令為：gemini extensions install https://github.com/gemini-cli-extensions/conductor，建議使用 --auto-update 標誌以自動更新。

設置項目時，運行 /conductor:setup，Conductor 會通過引導式問答創建 conductor/ 目錄，內含 product.md、product-guidelines.md、tech-stack.md、workflow.md、代碼風格指南和 tracks.md 等文件。這些文件定義了產品願景、用户、技術棧、工作流等關鍵上下文。提交該目錄後，任何克隆倉庫的團隊成員都能立即獲取項目上下文。

功能開發使用 /conductor:newTrack 命令創建一個軌道，每個軌道代表一個工作單元。Conductor 會生成 spec.md（規格）、plan.md（實施計劃）和 metadata.json。plan.md 按階段列出任務，每個任務對應一個 Git 提交。在實施前，用户應審查 plan.md，並在需要時調整。

實施階段運行 /conductor:implement，Conductor 按 plan.md 逐任務執行，每個任務完成後自動創建提交。每個階段結束後會暫停，等待用户手動驗證，確認後才進入下一階段。這種機制確保 AI 生成代碼與項目架構一致。

Conductor 的六個月預覽期已在 2026 年 4 月結束，Google 推出了一個 Codelab 來演示完整的新項目流程。總體而言，Conductor 通過將上下文作為管理工件，有效減少了 AI 生成代碼與項目實際結構之間的偏差。