Agent Skills
返回列表
🤖

编码代理会话恢复

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/search-and-resume-past-coding-agent-sessions-locally-with-exact-handoff-commands-using-agent-sessions。

技能介绍

要解决的具体问题

在多任务并行的开发环境里,我们通常会同时开启多个编码代理(如 Codex CLI、Claude CLI、OpenCode CLI)。当切换上下文或机器重启后,面对散落在终端历史或不同目录中的旧会话,很难准确回忆起当时正在调试的代码状态、报错信息或下一步计划。重新交代背景不仅耗时,还容易遗漏关键上下文,导致代理重复劳动或给出错误建议。

核心能力与关键步骤

这个技能通过底层的 Agent Sessions macOS 应用,帮你检索并恢复历史工作。

  • 本地跨代理搜索:它可以在本地归档中浏览多个编码代理的历史会话,允许你按关键词或路径进行全局搜索,快速定位到特定的工作片段。
  • 精确复制交接命令:找到目标会话后,技能会提取并生成精确的手动恢复(resume)命令。你只需复制这些命令并在终端中执行,即可无缝重新进入之前的工作环境,继续未完成的任务。
  • 状态探测与清理:除了恢复,显式操作还能触发状态检查(status/probe)或清理工作流,确保当前环境的干净。
  • 实时会话管理:配合 Live Sessions 功能,Agent Cockpit 充当了活跃会话的实时指挥中心,提供 Codex、Claude 和 OpenCode 的当前与等待状态摘要,甚至支持实时的 Claude 用量追踪。

适用边界与注意点

  • 平台限制:该方案依赖 Agent Sessions macOS 应用,且上游文档明确要求 macOS 14+ 系统。
  • 依赖本地归档:它主要针对本地已归档的会话进行搜索和恢复,如果历史记录未被本地应用捕获,则无法通过此方式找回。
  • 手动干预:强调的是“手动交接命令”,意味着恢复过程需要开发者自己复制并运行命令,而非全自动的后台重载。

使用场景

  • 在多项目并行时,切换上下文后需快速恢复之前用 Claude CLI 调试的代码状态,继续未完成的工作。
  • 机器重启或终端误关后,希望一键搜索昨天的 Codex CLI 会话,复制恢复命令重新进入旧任务。
  • 管理多个本地代理会话时,需要清理已结束的历史进程并检查当前活跃代理的运行状态。
  • 在使用多个编码工具后,需要在本地归档中搜索某个具体的报错信息,定位并重新进入当时的调试会话。

适合人员

  • 频繁在 Codex CLI、Claude CLI 和 OpenCode CLI 之间切换,需要统一检索并恢复历史进度的全栈工程师。
  • 习惯使用终端驱动 AI 编码代理,且常因系统重启丢失上下文的技术专家。
  • 需要在本地维护多个代理会话归档,并依赖手动交接命令恢复工作的资深 AI 开发者。
  • 重度依赖 iTerm2 和终端 CLI 工具,希望将散落的编码会话集中搜索并管理的效率极客。