AI Skills
gemini

gemini

熱門

當使用者要求執行 Gemini CLI 進行程式碼審查、計畫審查或大型上下文（>200k）處理時使用。適用於需要大上下文視窗的全面分析。預設使用 Gemini 3 Pro 以獲得最先進的推理與編碼能力。

2215星標
213分支
更新於 2026/3/5
獲取技能源代碼

相關技能

ads-amazon7825cost-tracking24萬interview-me7.8萬
SKILL.md
readonlyread-only
name
gemini
description

當使用者要求執行 Gemini CLI 進行程式碼審查、計畫審查或大型上下文（>200k）處理時使用。適用於需要大上下文視窗的全面分析。預設使用 Gemini 3 Pro 以獲得最先進的推理與編碼能力。

Gemini 技能指南

何時使用 Gemini

  • 當被要求啟用時
  • 程式碼審查：跨多個檔案的全面程式碼審查
  • 計畫審查：分析架構計畫、技術規格或專案藍圖
  • 大型上下文處理：需要超過 200k token 上下文的任務（整個程式碼庫、文件集）
  • 多檔案分析：理解多個檔案之間的關係與模式

⚠️ 重要：背景/非互動模式警告

絕對不要在背景或非互動式 shell（如 Claude Code 工具呼叫）中使用 --approval-mode default。它會無限期等待無法提供的批准提示。

對於自動化/背景審查：

  • ✅ 使用 --approval-mode yolo 進行全自動執行
  • ✅ 或使用 timeout 包裝：timeout 300 gemini ...
  • ❌ 絕不要在沒有互動式終端機的情況下使用 --approval-mode default

Gemini 卡住的症狀：

  • 程序執行超過 20 分鐘且 CPU 使用率為 0%
  • 無網路活動
  • 程序狀態顯示 'S'（休眠中）

修復卡住的程序：

# 檢查是否卡住
ps aux | grep gemini | grep -v grep

# 必要時終止
pkill -9 -f "gemini.*gemini-3-pro-preview"

執行任務

  1. 透過 AskUserQuestion 在單一提示中詢問使用者要使用哪個模型。可用模型：

    • gemini-3-pro-preview ⭐（旗艦模型，最適合編碼與複雜推理，軟體工程能力比 2.5 Pro 提升 35%）
    • gemini-3-flash（亞秒級延遲，從 3 Pro 蒸餾而來，最適合速度關鍵任務）
    • gemini-2.5-pro（舊版選項，全能表現強勁）
    • gemini-2.5-flash（舊版選項，具備思考能力且成本效益高）
    • gemini-2.5-flash-lite（舊版選項，處理速度最快）

  2. 根據任務選擇批准模式：

    • default：提示批准（⚠️ 僅適用於互動式終端機工作階段）
    • auto_edit：僅自動批准編輯工具（適用於附建議的程式碼審查）
    • yolo：自動批准所有工具（✅ 背景/自動化任務必選）

  3. 使用適當選項組合指令：

    • -m, --model <MODEL> - 模型選擇
    • --approval-mode <default|auto_edit|yolo> - 控制工具批准
    • -y, --yolo - --approval-mode yolo 的替代寫法
    • -i, --prompt-interactive "prompt" - 執行提示並繼續互動
    • --include-directories <DIR> - 要包含在工作區中的其他目錄
    • -s, --sandbox - 以沙盒模式執行以隔離

  4. 對於背景/自動化任務，一律使用 --approval-mode yolo 或加上 timeout 包裝。絕不要在非互動式 shell 中使用 default。

  5. 執行指令並擷取輸出。對於背景/自動化模式：

    # 建議：背景任務使用 yolo
gemini -m gemini-3-pro-preview --approval-mode yolo "審查此程式碼庫的安全性問題"

# 或加上 timeout（5 分鐘限制）
timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo "審查此程式碼庫"

  6. 對於附初始提示的互動式工作階段：

    gemini -m gemini-3-pro-preview -i "審查認證系統" --approval-mode auto_edit

  7. Gemini 完成後，通知使用者：「Gemini 分析已完成。您可以開始新的 Gemini 工作階段進行後續分析，或繼續探索結果。」

快速參考

使用案例 批准模式 關鍵標誌
背景程式碼審查 yolo ✅ -m gemini-3-pro-preview --approval-mode yolo
背景分析 yolo ✅ -m gemini-3-pro-preview --approval-mode yolo
背景附 timeout yolo ✅ timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo
互動式程式碼審查 default -m gemini-3-pro-preview --approval-mode default（僅限互動式終端機）
附自動編輯的程式碼審查 auto_edit -m gemini-3-pro-preview --approval-mode auto_edit
自動重構 yolo -m gemini-3-pro-preview --approval-mode yolo
速度關鍵背景 yolo ✅ -m gemini-3-flash --approval-mode yolo
成本最佳化背景 yolo ✅ -m gemini-2.5-flash --approval-mode yolo
多目錄分析 yolo（若為背景） --include-directories <DIR1> --include-directories <DIR2>
互動式附提示 auto_edit 或 default -i "prompt" --approval-mode <mode>

模型選擇指南

模型 最適合 上下文視窗 主要特色
gemini-3-pro-preview ⭐ 旗艦模型：複雜推理、編碼、代理任務 1M 輸入 / 64k 輸出 Vibe coding、SWE-bench 76.2%、$2-4/M 輸入
gemini-3-flash 亞秒級延遲、速度關鍵應用 1M 輸入 / 64k 輸出 從 3 Pro 蒸餾、TPU 最佳化
gemini-2.5-pro 舊版：全能表現強勁 1M 輸入 / 65k 輸出 思考模式、成熟穩定
gemini-2.5-flash 舊版：成本效益高、大量任務 1M 輸入 / 65k 輸出 最佳價格（$0.15/M）、思考模式
gemini-2.5-flash-lite 舊版：處理最快、高吞吐量 1M 輸入 / 65k 輸出 最大速度、最低延遲

Gemini 3 優勢：軟體工程準確度提升 35%、SWE-bench 76.2% 業界最佳、GPQA Diamond 91.9%、WebDev Arena 1487 Elo。知識截止日期：2025 年 1 月。

即將推出：gemini-3-deep-think 用於超複雜推理，具備增強的思考能力。

常見使用案例

程式碼審查（背景/自動化）

# 背景執行（Claude Code、CI/CD 等）
gemini -m gemini-3-pro-preview --approval-mode yolo \
  "執行全面程式碼審查，重點關注：
   1. 安全漏洞
   2. 效能問題
   3. 程式碼品質與可維護性
   4. 最佳實踐違規"

# 附 timeout 安全機制（5 分鐘）
timeout 300 gemini -m gemini-3-pro-preview --approval-mode yolo \
  "執行全面程式碼審查..."

計畫審查（背景/自動化）

# 背景執行
gemini -m gemini-3-pro-preview --approval-mode yolo \
  "審查此架構計畫：
   1. 可擴展性問題
   2. 遺漏的元件
   3. 整合挑戰
   4. 替代方案"

大型上下文分析（背景/自動化）

# 背景執行
gemini -m gemini-3-pro-preview --approval-mode yolo \
  "分析整個程式碼庫以了解：
   1. 整體架構
   2. 關鍵模式與慣例
   3. 潛在技術債
   4. 重構機會"

互動式程式碼審查（僅限終端機）

# 僅在互動式終端機中使用 default 模式
gemini -m gemini-3-pro-preview --approval-mode default \
  "審查認證流程的安全性問題"

後續追蹤

  • Gemini CLI 工作階段通常是一次性或互動式。與 Codex 不同，沒有內建的恢復功能。
  • 如需後續分析，請根據先前的發現啟動新的 Gemini 工作階段。
  • 提出後續行動時，請重新說明所選的模型與批准模式。
  • 每次 Gemini 指令後使用 AskUserQuestion 確認下一步或收集澄清。

錯誤處理

  • 當 gemini --version 或 Gemini 指令以非零狀態退出時，停止並回報失敗。
  • 在重試失敗的指令前，請求指示。
  • 在使用高影響力標誌（--approval-mode yolo、-y、--sandbox）之前，使用 AskUserQuestion 詢問使用者許可，除非已獲得授權。
  • 當輸出包含警告或部分結果時，總結並使用 AskUserQuestion 詢問如何調整。

故障排除：卡住的 Gemini 程序

偵測

# 檢查卡住的程序
ps aux | grep -E "gemini.*gemini-3" | grep -v grep

# 尋找以下症狀：
# - 程序執行超過 20 分鐘
# - CPU 使用率 0%
# - 程序狀態 'S'（休眠中）
# - 無網路連線

診斷

# 取得詳細程序資訊
ps -o pid,etime,pcpu,stat,command -p <PID>

# 檢查網路活動
lsof -p <PID> 2>/dev/null | grep -E "(TCP|ESTABLISHED)" | wc -l
# 若結果為 0，則程序卡住

解決方案

# 終止卡住的 Gemini 程序
pkill -9 -f "gemini.*gemini-3-pro-preview"

# 或終止特定 PID
kill -9 <PID>

# 確認清理完成
ps aux | grep gemini | grep -v grep

預防

  • 背景/自動化任務一律使用 --approval-mode yolo
  • 加上 timeout 包裝以確保安全：timeout 300 gemini ...
  • 絕不在非互動式 shell 中使用 --approval-mode default
  • 使用 ps 監控首次執行以確保程序完成

大型上下文處理技巧

  1. 具體明確：提供清晰、結構化的提示來說明要分析的內容
  2. 使用 include-directories：明確指定所有相關目錄
  3. 選擇正確的模型：
    • 使用 gemini-3-pro-preview 進行複雜推理、編碼任務及最高分析品質（建議預設）
    • 使用 gemini-3-flash 進行需要亞秒級回應的速度關鍵任務
    • 使用 gemini-2.5-flash 進行成本最佳化的大量處理
  4. 善用 Gemini 3 的優勢：軟體工程任務提升 35%，在代理工作流程與 vibe coding 方面表現卓越
  5. 分解複雜任務：即使有大型上下文，結構化分析也更有效
  6. 儲存結果：要求 Gemini 輸出結構化報告以便儲存參考

CLI 版本

需要 Gemini CLI v0.16.0 或更新版本以支援 Gemini 3 模型。檢查版本：gemini --version