CLI 工作流

📖 本篇術語速查表

英文 / 縮寫	中文	一句話解釋
CLI 工作流	workflow	CLI 各能力串起的用法。
按需選用	pick	按任務選該用什麼。
安全優先	safe	高危操作守邊界。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你按任務在 Gemini CLI 工作流的各能力裡選對該用什麼。

你是 Gemini CLI 工作流導航顧問。

【角色】
Gemini CLI 工作流導航顧問，按最小夠用、安全優先的原則給可落地方案，每條結論落到能照做的步驟或示例。

【輸入】
- 目前任務：___
- 性質（命令 / 檔案 / 聯網 / 規劃 / 回退）：___
- 涉及高危操作嗎：___
- 熟練度：___

【工作流程】
1. 按任務性質匹配能力
2. 指出該用哪個命令 / 模式
3. 涉及高危時提示審批和 checkpoint
4. 給落地下一步

【輸出規範】
▌一、任務歸類
▌二、該用的能力
▌三、高危提醒
▌四、落地下一步

【硬約束】
- 高危操作配合審批和 checkpoint
- 一次聚焦主線
- 複雜任務先 Plan
- 不要替我臆測情況或編造不存在的命令，資訊不全先問清
- 不確定的命令或引數一律以官方文件為準，禁止照搬過時寫法

CLI 工作流這一組回答“每天怎麼用 Gemini CLI”。它不是設定參考，而是把互動式 REPL、一次性 prompt、檔案引用、Shell、Web、會話恢復、計劃和回復機制串起來。

學習順序：先掌握 gemini、-p、@file、!command 和 /help，再進入 session、checkpoint、plan mode。

學習路徑

flowchart LR
    Start["啟動與引數"] --> Commands["Slash / @ / !"]
    Commands --> Files["檔案與 Shell"]
    Files --> Web["Web search / fetch"]
    Web --> Session["Session"]
    Session --> Plan["Plan / Todo"]
    Plan --> Checkpoint["Checkpoint / Rewind"]
    Checkpoint --> Config["上下文與設定"]

    style Commands fill:#dbeafe,stroke:#3b82f6
    style Plan fill:#fef3c7,stroke:#f59e0b
    style Checkpoint fill:#dcfce7,stroke:#22c55e

這個順序的核心是先學會“怎麼和 CLI 互動”，再學會“怎麼讓它安全做事”。如果直接跳到自動化或 MCP，很容易把許可權、上下文和恢復機制混在一起。

日常最小動作

gemini
gemini -p "summarize README.md"
gemini -r "latest" "继续刚才的任务"

互動式會話裡常用：

@src/file.ts      把檔案放進上下文
!npm test         直接執行 Shell 命令
/help             檢視內建命令
/memory reload    重新載入 GEMINI.md 等上下文件案
/mcp list         檢視 MCP server

按場景閱讀

先把 CLI 用順

從啟動引數、一次性 prompt、slash commands 和快捷鍵開始。

再接檔案與命令

學習 @ 檔案引用、Shell 命令、Web search / fetch 的安全邊界。

最後控制風險

進入 session、任務規劃、checkpoint、rewind 和 Plan mode。

頁面清單

頁面	解決的問題
CLI reference	`gemini` 引數、prompt、resume、sandbox、輸出格式
命令系統	slash commands、`@` 檔案引用、`!` Shell
快捷鍵	清屏、退出、輸入模式、shell mode
檔案管理	檔案上下文、目錄、ignore、多目錄 workspace
Shell 命令	命令執行、輸出截斷、高風險邊界
Web search / fetch	聯網查資料、讀取 URL、事實核驗
會話與歷史	儲存、恢復、分享和清理 session
任務規劃	計劃、todo、驗證命令、完成標準
Checkpoint 與 rewind	修改前恢復點、`/restore`、回退邊界
Plan mode	只讀規劃、執行准入、風險審查

下一步

CLI 工作流讀完後，進入：上下文與設定。