Archive 技能 - 会话经验归档与跨会话知识复用工具

技能概述

Archive 技能将会话中的学习成果、调试解决方案和部署日志归档到 .archive/yyyy-mm-dd/ 目录，以带可搜索标签的索引化 markdown 文件沉淀项目知识，供后续会话快速查阅复用。

适用场景

1. 完成重要任务后沉淀记录：完成部署、迁移或大型功能开发后，把关键步骤、配置和命令归档下来，避免下次重头摸索。
2. 解决棘手 bug 后保存方案：疑难调试结束后，将问题现象、原因分析和修复命令整理归档，下次遇到同类报错直接套用。
3. 排查基础设施问题前先查档案：开始调试部署、CI 或环境问题之前，先检索 .archive/MEMORY.md，确认过去是否已经解决过类似问题。

核心功能

1. 结构化归档工作流：按日期创建 .archive/YYYY-MM-DD/ 目录，写入带 YAML frontmatter（tags、category、related）的 markdown 文件，并用描述性文件名（如 cloudwatch-logging.md）便于识别。
2. MEMORY.md 索引维护：每创建一条归档，自动在 .archive/MEMORY.md 对应分类下追加一行摘要，形成跨会话可浏览的总目录。
3. 分类与检索体系：支持 infrastructure、release、debugging、feature、design 五大分类，相关归档之间通过 related 字段互相关联，可用 grep -ri "关键词" .archive/ 做全文搜索。

常见问题

归档的内容保存在哪里，会提交到 git 吗？

归档保存在项目本地的 .archive/ 目录中，按日期分文件夹组织。该技能要求将 .archive/ 加入 .gitignore，因此归档是纯本地笔记，不会被提交到仓库。

怎么找回以前归档的经验？

两种方式：先读 .archive/MEMORY.md 索引，按分类找到相关条目再打开具体文件；或直接执行 grep -ri "关键词" .archive/ 对全部归档做全文搜索。

什么时候应该触发一次归档？

四种时机：完成重要任务（部署、迁移、大功能）之后；解决棘手调试问题之后；经历了有学习价值的多步骤流程之后；或者你直接对智能体说"archive this"。归档前会先检查 MEMORY.md 中是否已有相关记录，避免重复。