Gemini会话管理技能Skill gemini-session-management

这是一个用于管理 Gemini CLI 会话的技能,提供会话恢复、保留策略配置、历史会话浏览和存储管理功能。关键词包括 Gemini CLI、会话管理、恢复会话、保留策略、会话浏览器,便于SEO搜索。

AI应用 0 次安装 0 次浏览 更新于 3/11/2026

name: gemini-session-management description: Gemini CLI 会话管理的中心权威。涵盖会话恢复、保留策略、会话浏览器和清理。适用于恢复 Gemini 会话、配置保留、浏览历史会话或管理会话存储。100% 委托给 gemini-cli-docs 获取官方文档。 allowed-tools: Read, Glob, Grep, Skill

Gemini 会话管理

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

停止 - 在提供任何关于 Gemini 会话的响应之前:

  1. 调用 gemini-cli-docs 技能
  2. 查询 特定的会话主题
  3. 基于 官方文档加载的内容

概述

用于管理 Gemini CLI 会话的元技能。会话保留对话历史,并可以恢复、搜索和配置保留策略。

何时使用此技能

关键词: session, resume, /resume, session browser, retention, maxAge, maxCount, --list-sessions, --delete-session

在以下情况使用此技能:

  • 恢复之前的会话
  • 配置会话保留
  • 浏览历史会话
  • 管理会话存储
  • 理解会话限制

会话恢复

恢复上一个会话

gemini --resume
# 或
gemini -r

通过浏览器恢复

在活动会话中:

/resume

打开交互式会话浏览器以搜索和选择。

会话保留

settings.json 中配置自动清理:

{
  "general": {
    "sessionRetention": {
      "maxAge": "7d",
      "maxCount": 100,
      "minRetention": "1d"
    }
  }
}
设置 描述 示例
maxAge 最大会话年龄 "7d", "24h"
maxCount 保留的最大会话数 100, 50
minRetention 删除前的最小保留时间 "1d", "12h"

会话限制

配置轮次限制:

{
  "general": {
    "maxSessionTurns": 100
  }
}

会话存储

会话存储在:

~/.gemini/tmp/<project_hash>/

命令行选项

选项 描述
--resume, -r 恢复上一个会话
--list-sessions 列出可用会话
--delete-session <id> 删除特定会话

关键词注册表(委托给 gemini-cli-docs)

主题 查询关键词
恢复 --resume flag, resume session, /resume command
浏览器 session browser, search sessions, /resume interactive
保留 sessionRetention, maxAge maxCount, session cleanup
限制 maxSessionTurns, session limits, turn limits
存储 session storage, ~/.gemini/tmp, session location
管理 --list-sessions, --delete-session, session management

快速决策树

你想做什么?

  1. 恢复上一个会话 -> gemini --resumegemini -r
  2. 浏览历史会话 -> 在活动会话中使用 /resume
  3. 配置保留 -> 在 settings.json 中编辑 sessionRetention
  4. 列出所有会话 -> gemini --list-sessions
  5. 删除会话 -> gemini --delete-session <id>
  6. 设置轮次限制 -> 配置 maxSessionTurns

最佳实践

  1. 定期清理: 配置保留以避免磁盘膨胀
  2. 命名会话: 使用描述性提示以便轻松浏览
  3. 恢复上下文: 继续复杂对话
  4. 删除敏感数据: 移除包含敏感数据的会话

验证检查点

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

测试场景

场景 1:恢复会话

查询: “如何恢复我的上一个 Gemini CLI 会话?” 预期行为:

  • 技能在 “resume” 或 “session” 上激活
  • 提供 gemini --resume 命令 成功标准: 用户收到恢复命令和 /resume 浏览器选项

场景 2:配置保留

查询: “如何限制 Gemini 会话存储?” 预期行为:

  • 技能在 “retention” 或 “session storage” 上激活
  • 委托给 gemini-cli-docs 获取 sessionRetention 设置 成功标准: 用户收到 settings.json 配置,包含 maxAge/maxCount

场景 3:删除会话

查询: “如何删除旧的 Gemini 会话?” 预期行为:

  • 技能在 “delete session” 或 “session management” 上激活
  • 提供 --delete-session 命令 成功标准: 用户收到删除工作流程和 list-sessions 选项

参考

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

  • “session management”
  • “session resume”
  • “sessionRetention”

版本历史

  • v1.1.0 (2025-12-01):添加测试场景部分
  • v1.0.0 (2025-11-25):初始发布