Context Recovery

核心功能

Context Recovery 是一款专为长会话场景设计的上下文修复技能，能够在模型上下文被压缩、会话意外中断或用户隐式引用历史工作时，自动从多源数据重建工作现场。

核心用法

自动触发：检测到 <summary> 标签、"context limits" 等压缩指示词时立即执行；
手动触发：识别 "continue"、"where were we" 等续接意图，或用户提及 "the PR"、"the branch" 等未指明的项目引用。

执行流程采用七层递进架构：
1. 通道检测 — 识别 Discord/Slack/Telegram/Signal 等平台及 threadId；
2. 历史回溯 — 自适应深度抓取，起始 50 条，按时间跨度动态扩展至 100 条上限；
3. 会话日志 — 读取本地 .jsonl 文件提取最近 3 个会话的用户请求与助手响应；
4. 共享内存 — 基于关键词检索持久化记忆库；
5. 上下文合成 — 结构化输出项目状态、时间线、待办事项、关键引用；
6. 缓存持久化 — 写入当日记忆文件，抵御未来压缩；
7. 主动响应 — 直接呈现恢复结果并给出继续/重试/澄清选项。

显著优点

• 零摩擦续接：无需用户重复交代背景，显著降低长项目协作成本；
• 跨平台统一：一套协议覆盖主流通讯平台，thread 感知确保 Slack/Discord 嵌套对话不丢失；
• 自适应深度：时间优先策略（≥2小时跨度）兼顾 token 预算与信息完整性；
• 防御性设计：强制在返回 "insufficient data" 前执行恢复协议，避免无效追问。

潜在局限

• 历史可达性依赖：若平台 API 权限不足或消息已过期，恢复效果受限；
• 本地日志路径硬编码：~/.clawdbot-*/agents/*/sessions 路径需与环境匹配；
• 关键词匹配粗放：grep 检索可能引入噪声，缺乏语义相似度过滤；
• 100 条上限：高频对话场景可能遗漏关键决策点。

适用人群

• 多轮迭代开发的技术团队（代码审查、PR 跟踪）；
• 长周期研究项目的知识工作者；
• 依赖异步协作的分布式团队。

常规风险

• 隐私暴露：抓取历史消息可能触及敏感内容，需确保通道权限合规；
• 幻觉污染：若日志与记忆库信息冲突，合成阶段可能产生矛盾上下文；
• token 爆炸：未严格约束的 session log 提取（tail -50 条助手响应）可能超限。

整体评估：该技能是长会话代理的基础设施级能力，设计严谨但需配合环境配置与权限管理方能发挥最大价值。

核心用法

Context Recovery 是一个纯文档型 Skill，专为解决 AI 助手在长对话中因上下文压缩或会话重启导致的工作记忆丢失而设计。当检测到会话被截断（如包含 <summary> 标签）或用户暗示继续之前的工作（如说 "continue""where were we"）时，Skill 会自动触发多阶段恢复协议：

1. 检测活跃频道：识别 Discord、Slack、Telegram、Signal 等平台及频道/线程 ID
2. 获取频道历史：自适应深度获取消息（初始 50 条，可扩展至 100 条，确保覆盖至少 2 小时对话），支持线程消息与父频道双重获取
3. 提取会话日志：通过 bash 命令读取本地 ~/.clawdbot-*/agents/*/sessions/*.jsonl 文件
4. 检索共享内存：在 ~/clawd-*/memory/ 目录中搜索关键词匹配的历史记录
5. 合成结构化上下文：生成包含活跃项目、工作时间线、待完成事项、关键引用的恢复报告
6. 缓存至内存：将恢复的上下文追加写入每日记忆文件，防止未来再次丢失
7. 智能响应：呈现恢复结果并主动询问"继续/重试/澄清"

显著优点

• 零配置自动触发：通过检测 <summary> 标签、"context limits" 等关键词或用户继续意图自动执行，无需手动调用
• 多平台深度适配：针对 Discord（线程 ID）、Slack（线程+父频道双层获取）等平台有专门优化
• 自适应历史获取：基于时间跨度智能扩展获取范围，平衡完整性与 token 预算
• 持久化记忆机制：将恢复的上下文写入每日记忆文件，形成可累积的工作档案
• 置信度透明化：明确标注频道上下文、会话日志、记忆条目的可信度等级

潜在局限与风险

• 路径硬编码依赖：Skill 中硬编码了 ~/.clawdbot-*/ 和 ~/clawd-*/memory/ 路径，若实际环境不匹配则功能失效
• 平台权限限制：Discord DMs、Slack 工作区历史等可能因权限不足无法完整获取
• 纯文档型执行风险：作为 T-MD 类型 Skill，实际效果完全依赖 Agent 对文档指令的理解能力，无强制保障
• T3 来源可信度：维护者为个人/社区身份，无顶级机构背书，长期维护稳定性存疑
• 文件访问安全：引导 Agent 读取本地会话文件，若环境被入侵可能导致敏感对话泄露

适合人群

• 频繁进行超长对话（多轮技术讨论、复杂项目协作）的开发者
• 跨平台使用 AI 助手（Discord/Slack/Telegram）的团队协作用户
• 需要保持多项目上下文连贯性的项目管理者
• 愿意审查并适配路径配置的技术用户

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 环境不匹配 | 路径硬编码与实际环境不符 | 首次使用前验证 `~/.claude/` 或类似目录结构 |

| 权限不足 | 频道历史或日志文件读取失败 | 检查 Agent 文件系统权限，准备降级到询问模式 |

| 上下文误恢复 | Agent 解析错误或历史污染导致错误上下文 | 人工核对恢复结果的关键项目/分支信息 |

| 敏感信息泄露 | 会话日志包含机密内容被不当恢复 | 审查 `memory/` 目录访问权限，避免共享环境 |

安全认证评分 85/100（A级），通过全部基础安全检查，无恶意代码、无外部 API、符合 GDPR/CCPA 基本要求。