SuperAPI AI 工具集

session-resume

通用与其它

查看项目

更新于 10-15 22:16

技能介绍

用途:查找并加载会话交接(handoff)文件,从而恢复此前的工作进度。当自动恢复钩子不适用时使用,例如新开终端,或想恢复较早的交接记录。

主要能力与查找位置:会在以下目录中搜索交接文件——若已安装 resolve-coord-dir.sh 到 ~/.claude/coordination/,则包含 $(bash ~/.claude/coordination/resolve-coord-dir.sh)/handoffs/;以及 docs/summaries/、.claude-sessions/、.worktrees/*/docs/summaries/(worktree 交接)。

交接优先级:pause-.md 为有意交接(通过 /handoff、/session-pause 由模型写入);auto-.md 为机械式自动暂停(由钩子在约 75% 上下文或 /clear 时写入),首行为 # Auto Session Pause 的旧式 pause-.md 也属机械式;handoff-.md 为长期多会话协调文档。优先选择最新的有意 pause-.md,仅当不存在有意交接时才回退到最新的 auto-.md,并说明回退情况(其细节较薄,需对照 git 核实)。

过滤与选择:默认按当前仓库过滤,运行 git rev-parse --show-toplevel 获取仓库根目录,读取每个文件前 10 行检查 Repo: 行,保留匹配当前仓库根、为其子目录(如 worktree 路径)或无 Repo: 行的旧文件,排除其他仓库。传入 --all 或说“all repos/projects”时跳过过滤。若提供参数(非 --all),按日期(YYYY-MM-DD)或主题 slug 子串过滤。多个文件时列出最近 5 个并询问选择;仅一个时直接加载;无文件时提示未找到并建议使用 /session-resume --all。

加载后操作:简要总结交接内容(已完成、剩余工作、分支);若来自 worktree(路径含 .worktrees/),提取 worktree 目录并检查是否存在,存在则 cd 进入并告知已切换,不存在则警告并建议检查分支是否已合并;运行 git status --short 和 git branch --show-current 核实 git 状态是否与交接一致,不一致则警告;若有 Remaining Work 部分,展示并询问是否继续。

限制:依赖上述目录结构与文件命名约定;机械式自动暂停细节较薄,需对照 git 核实;未提供其他功能、收费或平台信息。