整合與自動化

📖 本篇術語速查表

英文 / 縮寫	中文	一句話解釋
整合與自動化	integration	整合和自動化能力的總覽。
按需選用	pick	按需求選該用什麼。
安全自動化	safe	自動化守許可權和審查。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你按需求在 Gemini CLI 的整合與自動化各能力裡選該用什麼。

你是 Gemini CLI 整合與自動化導航顧問。

【角色】
Gemini CLI 整合與自動化導航顧問，按最小夠用、安全合規優先的原則給可落地方案，每條結論都落到能照做的步驟或示例，不停留在空泛建議。

【輸入】
- 我的需求（IDE / hook / 指令碼 / CI / 本地）：___
- 是互動用還是自動化：___
- 涉及寫操作 / 聯網嗎：___
- 團隊還是個人：___
- 經驗水平：___

【工作流程】
1. 把需求歸到對應能力
2. 區分互動用還是自動化
3. 涉及自動化時提示許可權和審查
4. 給該先做什麼
5. 給落地下一步

【輸出規範】
▌一、需求歸類
▌二、互動 vs 自動化
▌三、自動化的許可權審查
▌四、落地下一步

【硬約束】
- 自動化守最小許可權
- 會改程式碼的自動化要有審查
- 憑據安全處理
- 不要替我臆測情況或編造不存在的設定，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法

Gemini CLI 不只適合在終端聊天。真正落地時，它會進入 IDE、Shell 指令碼、CI、GitHub issue、PR review 和本地開發環境。

這一組頁面解決“如何把 Gemini CLI 放進工作流”的問題。先選入口，再看許可權、輸入輸出和失敗兜底。

學習路徑

flowchart LR
    IDE["IDE integration"] --> Hooks["Hooks"]
    Hooks --> Headless["Headless mode"]
    Headless --> Automation["Shell / CI automation"]
    Automation --> GitHub["GitHub Action"]
    GitHub --> IssuePR["Issue / PR automation"]
    IssuePR --> LocalDev["Local development"]
    LocalDev --> Troubleshooting["Troubleshooting"]

    style IDE fill:#dbeafe,stroke:#3b82f6
    style Headless fill:#dcfce7,stroke:#22c55e
    style GitHub fill:#fef3c7,stroke:#f59e0b

IDE + Hooks

人在編輯器裡工作時，先看 IDE companion 和 lifecycle hooks。

Headless + Automation

需要指令碼化或 CI 呼叫時，從 headless mode 開始。

GitHub Action

需要 issue、PR、review 自動化時，進入 run-gemini-cli GitHub Action。

頁面	適合場景
IDE 整合	需要編輯器上下文、原生 diff、ACP
Hooks	需要在工具呼叫前後插入校驗、阻斷或記錄
Headless mode	需要非互動式呼叫 Gemini CLI
自動化指令碼	需要把 CLI 放進 Shell、CI 或批處理
GitHub Action	需要在 GitHub workflow 裡執行 Gemini CLI
Issue 與 PR 自動化	需要自動分診 issue、生成回覆、輔助 PR review
本地開發	需要貢獻 Gemini CLI 或排查 CLI 自身 bug

選擇方式

人在 IDE 裡工作     IDE companion 或 ACP
需要流程攔截        hooks
需要指令碼呼叫        headless mode
需要 CI 自動處理    run-gemini-cli GitHub Action
需要改 Gemini CLI   本地開發流程

進入前檢查

檢查項	為什麼重要
輸入是否可重複	自動化必須能在無人工補充的情況下復跑
輸出是否可審計	CI、issue 和 PR 場景要能追蹤 Gemini 做了什麼
許可權是否收窄	hooks、headless、GitHub Action 都可能放大工具許可權
失敗是否可兜底	自動化失敗要回到記錄、人工 review 或普通 CLI

下一步

先讀：IDE 整合。