SuperAPI AI 工具集

session-stash

智能体与模型

查看项目

更新于 10-15 20:29

技能介绍

用途:让进行中的智能体会话在不同 harness、上下文窗口和时间之间可迁移。stash 把会话捕获为项目内 docs/session-stash/<name>/ 的文件夹,默认加密并受 git 版本管理;pop 则相反,任意 harness 的智能体进入该文件夹,由其中的 AGENTS.md 指导如何恢复。

主要能力与规则:pop 是消耗性的,stash 逻辑上被销毁(移出活动索引,类似 git stash drop)但不物理删除,文件夹移入 consumed/ 仍可读,且只能被一个会话 pop。默认加密,仅在操作者明确选择退出时明文,且未加密 stash 在操作者确认无密钥并同意前不得提交;默认只有 AGENTS.md 是明文。轻量恢复仅提供上下文,补丁、文件映射、git tag 等状态放在按需拉取的 sidecar 中。仅由操作者发起,绝不自动 stash。失败要显式报错,不得静默降级或回退。

使用方式:操作者说“stash this session”时,先检查是否存在每项目 age 密钥;无密钥则停下询问并做风险暴露审查。随后创建 docs/session-stash/YYYY-MM-DD_HH-MM-<slug>/,构建 file-map.md,捕获 git-tag.txt、patch.diff、refs/,写 transcript.md、resume.md 与分层摘要、AGENTS.md,默认用 age 加密除 AGENTS.md 外的内容,更新 README.md 索引与 settings.yaml,再提交。pop 时先读 stash 的 AGENTS.md,按需拉取 sidecar、解密并恢复,然后把文件夹移入 consumed/ 并写 consumed.md。

适用场景:跨 harness 或跨上下文窗口继续会话、把会话转为 sashay 计划、musing 或 Jira 工单,以及活动 stash 超过阈值(默认 8)时归档到 backlog/。

限制:密钥检索来源需首次确认并记录;无法确定或确认错误时必须停止;未加密提交需操作者显式确认;归档只移动不删除;不得使用 mtime 启发式判断文件。具体实现细节以仓库 references/ 下文档为准。