Skip to content

kkfor30/kk-sessions / skills/kk-session-restore

kk-session-restore

Verified

撤销 kk-sessions 对侧栏做过的改动:按首次使用前存下的快照,把会话标题和所在分区恢复原样,删除 kk-sessions 新建的分区。用户说"撤销 kk-sessions 的改动""恢复会话原样""回滚会话整理""kk-session-restore"时使用,通常在停用或卸载 kk-sessions 之前;卸载后也能用(见「卸载后」)。支持 Claude Code 桌面端和 Codex 桌面端。不删除会话,不移动或删除磁盘上的文件夹。

kk-session-restore

输入

  • 快照目录:~/.agent-rules/kk-sessions/snapshots/,文件名 <agent>-<YYYYMMDD-HHMMSS>.json(agent 为 claude 或 codex)。默认用当前 Agent 最早的一份,那是 kk-sessions 第一次改动侧栏之前的状态;用户指定了某一份就用那份。
  • 快照格式和存法见下面「快照」;六个动作的做法见 kk-session-route 的「适配」一节,这里用列出全部会话、改标题、移入分区,外加删除分区。

没有当前 Agent 的快照时,说明无法自动恢复,列出地图里的分区名,建议用户手动删除这些分区,然后结束。

Codex:直接跑脚本

在 Codex 里一律运行脚本,不要按下面「流程(Claude Code)」逐个调用工具:脚本几秒就完成,逐个操作要几分钟,还容易漏(不调模型,需要 Codex 桌面端开着):

python ~/.agent-rules/kk-sessions/restore/restore.py           # 先列出要改什么
python ~/.agent-rules/kk-sessions/restore/restore.py --apply   # 用户确认后执行

把第一条的输出给用户看,用户明确确认后再加 --apply。脚本按下面第 2 步的规则算差异,执行前记下恢复前的状态,执行后把快照收进 restored-<时间>。

流程(Claude Code)

  1. 读快照和现状:并行读取快照、列出全部会话(含已归档)、列出分区。
  2. 算差异,只处理快照里有的会话:
    • 标题和快照不同:现在的标题是 <类型emoji> <主题>|… 格式(kk-sessions 改的)→ 改回快照标题;不是这个格式 → 用户后来自己改过,跳过。
    • 所在分区和快照不同:现在在 kk-sessions 建的分区、地图里的分区或未分组 → 移回快照里的分区(那个分区已不存在就移回未分组);在用户自己建的其他分区 → 跳过。置顶的会话不动。
    • 快照里没有、现在存在的分区 → kk-sessions 新建的,列入待删除。
    • 分区 ID 还在、名字和快照不同 → kk-session-setup 对齐时改过名,改回快照里的名字。
    • 快照之后新建的会话不改标题;它们所在的分区被删除后会自动回到未分组。
  3. 和用户确认:给出几项数字(改回标题几个、移回分区几个、改回分区名哪几个、删除分区哪几个、跳过几个及原因),再列出前 10 条标题改动(现在 → 恢复后)。用户明确确认才执行。
  4. 先存一份当前快照,按下面「快照」的方法存,让这次恢复本身也能撤销。
  5. 执行:先改标题,再改回分区名,然后按目标分区批量移动,最后删除待删除的分区。当前 Agent 删除不了分区时,把名字列给用户手动删。
  6. 收尾:全部成功后,只把当前 Agent 的快照文件(claude-*.json 或 codex-*.json)移到同级的 restored-<YYYYMMDD-HHMMSS>/ 里,另一个 Agent 的快照留在 snapshots/,不要整个目录改名,表示已恢复(安装脚本据此允许卸载;以后再用 kk-sessions 会重新存一份起点快照)。报告改了几处、哪些没成功。提醒用户:要彻底移除,就停用或卸载 kk-sessions 插件(用安装脚本装的,运行 python install.py --uninstall);工作区地图 ~/.agent-rules/workspace-map.md 会保留,不需要可自己删。

卸载后

kk-sessions 改过侧栏后,会把回退工具复制到 ~/.agent-rules/kk-sessions/restore/:restore.py(Codex 用)和 RESTORE.md(就是本文件)。插件卸载或停用后:

  • Codex:照样运行上面的 restore.py。
  • Claude Code:在新会话里说「读 ~/.agent-rules/kk-sessions/restore/RESTORE.md,按里面的流程撤销 kk-sessions 的改动」。

快照

kk-session-setup、kk-session-tidy、kk-session-route 在第一次改动侧栏之前都要检查快照目录:已有当前 Agent 的快照就跳过,没有就存一份。本 Skill 在恢复前也存一份。

存法:列出全部会话(含已归档)和分区,写成 JSON。会话超过 100 个时,只记最近 30 天活动过的会话加上本次要改动的会话;恢复本来就只处理快照里记过的会话:

{
  "agent": "claude",
  "created": "2026-11-11T09:30:00+08:00",
  "sections": [{"id": "cg-…", "name": "🟣 内容制作"}],
  "sessions": [{"id": "local_…", "title": "原标题", "section": "cg-…或 null", "archived": false}]
}

只记标题、分区和是否归档,不记聊天内容。

边界

  • 不删除会话,不归档或取消归档,不改置顶。
  • 不移动、不删除磁盘上的文件夹:kk-session-route 建的主题目录里可能已经有产物。需要清理时列出快照之后新建、只有 README.md 的目录,让用户自己决定。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall