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 生成程式碼與專案實際結構之間的偏差。