用途:这是管理 Gemini CLI 检查点(Checkpointing)系统的元技能。检查点会在文件被修改前自动创建快照,从而实现即时回滚。当需要启用或配置检查点、列出可用检查点、恢复到先前状态、了解检查点存储位置,或规划实验性工作流时使用。
主要能力:启用检查点后,Gemini 在修改任何文件之前会创建三部分内容:Git 快照(位于 ~/.gemini/history/<project_hash> 的影子仓库)、完整的会话历史状态,以及即将执行的待定工具调用。检查点存储在本地,不会干扰项目自身的 Git 仓库。检查点命名格式为 {timestamp}-{filename}-{tool_name},例如 2025-06-22T10-00-00_000Z-my-file.txt-write_file。检查点元数据存储在 ~/.gemini/tmp/<project_hash>/checkpoints。
使用方式:在 settings.json 中添加配置以启用检查点:{"general": {"checkpointing": {"enabled": true}}}。可用 cat ~/.gemini/settings.json | jq '.general.checkpointing' 验证配置。使用 /restore 命令列出当前项目的可用检查点文件,使用 /restore <checkpoint_file> 将文件与对话恢复到该检查点状态。
最佳实践:进行有风险的重构时始终启用;重大改动前记录现有检查点名称;恢复后验证状态;定期清理旧检查点以释放磁盘空间。
限制:该技能要求先调用 gemini-cli-docs 技能并仅基于官方文档作答,具体配置与命令细节以官方文档为准。资料未提供价格、平台支持范围及具体版本兼容性信息。