context-recovery

🔄 跨平台智能上下文自动恢复

基于本地日志与频道历史,自动恢复因会话压缩丢失的工作上下文,支持 Discord/Slack 等多平台,确保长时任务连续性。

收藏
12.7k
安装
2.8k
版本
v1.2.2
CLS 安全性认证2026-07-02
点击查看完整报告 >

使用说明

Context Recovery 技能综合评估

核心用法

Context Recovery 是一款专为解决 AI 助手会话上下文丢失问题设计的智能恢复工具。当检测到 <summary> 压缩标记或用户暗示继续之前的工作时,该技能会自动执行七步恢复协议:首先检测当前活动频道(Discord、Slack、Telegram 等),然后通过 message:read 接口自适应获取 50-100 条历史消息(确保覆盖至少 2 小时对话),同时提取本地会话日志(最近 3 个 JSONL 文件)和共享内存中的关键词匹配项。系统会解析消息中的项目标识符、分支名称、PR 编号和未完成的操作承诺,最终合成包含时间线、待办事项和关键引用的结构化上下文摘要,并缓存至每日记忆文件以防止未来再次丢失。

显著优点

该技能的最大优势在于其跨平台兼容性和自动化能力。支持 Discord、Slack、Telegram、Signal 等主流通讯平台,能够识别线程对话和父频道关系,确保上下文恢复的完整性。自适应深度获取算法在保证 token 预算不超限的前提下,智能扩展消息获取范围直至满足时间跨度要求。自动触发机制无需用户手动请求即可在检测到压缩标记时主动恢复,大幅减少中断感。所有数据处理均在本地完成(使用 grepjqcat 等标准工具),不涉及网络上传,有效保护敏感工作内容的隐私安全。此外,上下文缓存机制确保恢复后的状态能 survive 未来的会话压缩。

潜在缺点与局限性

作为 T3 来源(个人开发者/社区项目)的技能,其权威性和长期维护保障相对有限。功能实现高度依赖本地文件系统权限,需要用户环境中安装 jq 工具,且对 ~/.clawdbot-*/~/clawd-*/memory/ 路径有读写权限,在无本地文件访问权限的环境中无法使用。历史消息获取存在硬限制(最多 100 条),对于高强度对话场景可能无法捕获完整上下文。此外,代码示例中包含的 bash 操作虽然安全,但需要用户具备一定的技术理解能力才能正确配置和使用。

适合的目标群体

该技能最适合以下用户群体:长期使用 AI 助手处理复杂开发任务的软件工程师,特别是需要在多个平台间切换的开发者;维护长期项目、需要保持数小时甚至数天上下文连续性的技术团队;使用 Discord/Slack 等渠道进行协作开发、经常遇到 "context limits" 压缩提示的高级用户;以及希望自动化管理会话状态、减少手动回顾时间的技术从业者。对于仅需简单问答、不涉及长期任务跟踪的 casual 用户,该技能的功能可能过于复杂。

使用风险与注意事项

主要风险集中在本地文件操作和平台 API 限制方面。技能需要读取本地会话目录和写入记忆文件,虽然操作范围受限且使用追加模式(无覆盖风险),但仍需确保文件权限配置正确。频道历史读取受限于各平台的 API 策略(如 Discord 的 rate limit 或 DM 历史限制),在权限不足时可能获取不完整数据。长期使用会导致每日记忆文件持续增长(追加写入模式),需要定期手动清理。此外,虽然技能本身仅含文档和示例代码,但实际执行依赖于宿主系统的工具链(bash、jq),工具版本差异可能导致解析失败。建议用户在生产环境使用前,先在测试环境验证文件路径和工具可用性。

安全解读

Context Recovery:会话断点智能续接系统

核心用法

Context Recovery 是一款专为 Claude 等 AI Agent 设计的状态恢复基础设施。当长会话因 token 限制被压缩、或用户隐式引用"刚才的项目"而上下文已丢失时,该 Skill 自动触发多源数据重建流程:

1. 自适应深度采集:从 Discord/Slack/Telegram/Signal 等频道读取 50-100 条历史消息,确保覆盖至少 2 小时对话窗口
2. 三维数据融合:整合频道历史 + 本地会话日志(最近 3 个 JSONL 文件)+ 持久化记忆文件

3. 结构化重建:输出包含活跃项目、分支/PR 状态、待办事项、关键引用的完整上下文摘要

4. 记忆持久化:将恢复的上下文追加写入每日记忆文件,确保未来压缩时可二次恢复

显著优点

  • 零配置自动触发:检测 <summary> 标签、"continue" 等 10+ 种触发模式,无需用户记忆命令
  • 跨平台统一:一套协议覆盖主流协作平台,自动识别 thread/parent channel 层级
  • 防御性设计:100 条消息硬上限、2 小时时间窗口、记忆文件只追加不覆盖,防止无限膨胀
  • 置信度透明:明确标注 Channel/Session/Memory 三维度数据可信度,避免幻觉

潜在局限

  • 记忆污染风险:持续追加的记忆文件可能累积过期上下文,需用户定期清理(未内置轮转机制)
  • 平台权限依赖:Discord/Slack 历史读取需相应 workspace 权限,DM 场景可能受限
  • 非实时同步:依赖本地会话日志而非服务端状态,多设备切换时存在延迟窗口

适合人群

  • 使用 Claude 进行长周期项目开发的工程师(代码审查、PR 迭代、多轮调试)
  • Discord/Slack 等频道中与 AI 协作的分布式团队
  • 需要会话无缝续接的高频 AI 用户,厌恶重复交代背景

常规风险

| 风险点 | 说明 | 缓解措施 |
|--------|------|----------|
| 记忆文件注入 | 恢复的上下文写入本地文件,若历史消息含恶意指令可能被持久化 | 建议定期审查 `~/.claude/memory/` 内容 |
| 上下文幻觉 | 多源数据融合时可能错误关联项目/分支 | 置信度标签辅助人工校验 |
| 隐私边界 | 频道历史可能包含他人敏感对话 | 仅处理用户主动触发的会话,遵循 GDPR 最小化原则 |

该 Skill 本质是一套声明式的恢复协议,代码块均为文档示例无可执行文件,安全基线扎实,适合作为高阶用户的生产力基础设施部署。

context-recovery 内容

手动下载zip · 3.7 kB
SKILL.mdtext/markdown
请选择文件