Chat Compactor 是一个用于生成结构化会话摘要的技能,目标读者是未来的 AI 智能体,帮助其跨会话保持上下文连续性。
用途
人工编写的摘要和临时生成的 AI 摘要往往会丢失关键上下文:决策理由被忽略(为什么选 X 而不是 Y)、失败路径被遗忘(智能体重新尝试已经失败的方法)、隐式知识未被记录(文件位置、命名约定、容易踩坑之处)、状态不清晰(什么已完成、什么待办、什么受阻)。该技能用于产出面向智能体优化的交接文档,为下一次会话提供初始上下文。
主要能力与输出格式
该技能生成一个 Markdown 文件,结构固定,包含以下部分:
- 会话标题、日期、消息数量等基本信息;
- 上下文快照:用 1–2 句话说明项目或任务以及当前状态;
- 已完成事项:列出具体成果;
- 关键决策与理由:以表格形式记录决策、原因和被否决的替代方案;
- 当前状态:可用(功能正常的文件或功能)、损坏或受阻(问题及原因)、已修改文件(附简要说明);
- 死路(不要重试):失败的方法及失败原因;
- 下一步(按优先级):待办行动清单;
- 环境与注意事项:安装配置说明、版本、发现的特殊行为;
- 关键代码或命令参考:仅在存在非显而易见的命令或代码片段、下一会话需要时提供。
使用方式
工作流程为:扫描对话中的决策、成果、失败、文件变更和阻塞点;识别“交接时刻”,即新的智能体需要哪些信息才能继续;按上述格式生成结构化摘要;保存为 session-[topic]-[date].md,放在项目根目录或 /home/claude/sessions/。
触发条件
在以下情况下调用该技能:用户说“compact”“wrap up”“save session”“summarize for next time”;上下文窗口超过约 50% 容量且任务仍在进行;重大上下文切换之前;调试或实现会话结束时。
质量要求与反模式
好的摘要应便于快速浏览(下一个智能体在 30 秒内掌握方向)、可操作(有清晰的下一步而非模糊总结)、有防御性(记录死路以防重复探索)、精简(无冗余,每一行都有信息价值)。应避免:叙事性长文(“我们先试了 X,然后 Y,然后 Z……”)、重复上下文(不要重复代码注释中的内容)、模糊总结(“在功能上取得了良好进展”)、缺少失败记录(这是最有价值的部分)。
适用场景
主要适用于编码与调试类长会话的收尾和交接,也适用于需要跨会话保持上下文的持续任务。限制方面,资料未说明其具体依赖、安装命令、支持的平台或计费信息,这些暂未提供。