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 工作流读完后，进入：上下文与配置。