name: gemini-checkpoint-management description: Gemini CLI 检查点的中央权威。涵盖基于 git 的文件快照、自动状态保存、/restore 命令和回滚。在启用检查点、恢复先前状态、撤销更改或规划 Gemini 实验性工作流时使用。100% 委托给 gemini-cli-docs 以获取官方文档。 allowed-tools: Read, Glob, Grep, Skill

Gemini 检查点管理

强制要求：首先调用 gemini-cli-docs

停止 - 在提供任何关于 Gemini 检查点的响应之前：

调用 gemini-cli-docs 技能

查询特定的检查点主题

基于加载的官方文档提供响应

概述

用于管理 Gemini CLI 检查点系统的元技能。检查点在文件修改前创建自动快照，实现即时回滚。

何时使用此技能

关键词： 检查点、回滚、恢复、撤销、快照、恢复、实验、检查点、/restore

在以下情况下使用此技能：

启用或配置检查点
列出可用检查点
恢复到先前状态
了解检查点存储
规划实验性工作流

检查点工作原理

启用后，在任何文件修改之前，Gemini 创建：

Git 快照： 影子仓库位于 ~/.gemini/history/<project_hash>
对话历史： 完整会话状态
待处理工具调用： 将要执行的操作

检查点本地存储，不干扰项目的 Git 仓库。

配置

启用检查点

添加到 settings.json：

{
  "general": {
    "checkpointing": {
      "enabled": true
    }
  }
}

验证配置

cat ~/.gemini/settings.json | jq '.general.checkpointing'

命令

列出检查点

/restore

显示当前项目的可用检查点文件。

恢复检查点

/restore <checkpoint_file>

恢复文件和对话到检查点状态。

检查点命名

格式：{timestamp}-{filename}-{tool_name}

示例：2025-06-22T10-00-00_000Z-my-file.txt-write_file

存储位置

数据	位置
Git 快照	`~/.gemini/history/<project_hash>`
检查点元数据	`~/.gemini/tmp/<project_hash>/checkpoints`

关键词注册表（委托给 gemini-cli-docs）

主题	查询关键词
启用	`checkpointing enabled`, `enable checkpointing settings`
命令	`/restore command`, `list checkpoints`, `restore checkpoint`
存储	`checkpoint storage`, `~/.gemini/history`, `snapshot location`
工作流	`checkpointing workflow`, `automatic snapshots`

快速决策树

你想做什么？

启用检查点 -> 查询 gemini-cli-docs: “checkpointing enabled settings”
列出检查点 -> 使用 /restore 命令
恢复状态 -> 使用 /restore <checkpoint_name>
查找存储 -> 查询 gemini-cli-docs: “checkpoint storage ~/.gemini/history”
理解工作流 -> 查询 gemini-cli-docs: “checkpointing workflow”

最佳实践

为实验启用： 在进行风险重构时始终启用
记录检查点名称： 在重大更改前，列出现有检查点
恢复后测试： 恢复后验证状态
定期清理： 旧检查点占用磁盘空间

验证检查点

[ ] 我是否调用了 gemini-cli-docs 技能？
[ ] 官方文档是否加载？
[ ] 我的响应是否完全基于官方文档？

测试场景

场景 1：直接激活

查询： “使用 gemini-checkpoint-management 技能启用检查点” 预期行为：

技能在关键词 “检查点” 上激活
委托给 gemini-cli-docs 获取官方文档 成功标准： 用户收到准确的检查点配置步骤

场景 2：关键词激活

查询： “如何在 Gemini CLI 中回滚更改？” 预期行为：

技能在关键词 “回滚”、“恢复” 上激活
提供 /restore 命令用法 成功标准： 响应包括命令语法和检查点列表

场景 3：故障排除

查询： “Gemini 检查点存储在哪里？” 预期行为：

技能在 “检查点存储” 上激活
提供 ~/.gemini/history 路径信息 成功标准： 用户理解检查点存储结构

参考资料

查询 gemini-cli-docs 获取官方文档：

“检查点”
“/restore 命令”
“检查点存储”

版本历史

v1.1.0 (2025-11-30): 添加测试场景部分
v1.0.0 (2025-11-25): 初始版本