用途:跨会话捕获、索引并复用项目知识。适合在完成重要任务(部署、迁移、大型功能)、解决棘手的调试、用户说“archive this”,或任何值得保留的多步骤流程之后使用。也可在调试基础设施、部署或 CI 问题之前,或重复过去流程、遇到可能已解决的报错时查阅归档。
主要能力:按日期目录 .archive/YYYY-MM-DD/ 写入带 YAML frontmatter 的 Markdown 文件,并在 .archive/MEMORY.md 中登记一行条目;使用标签与分类,支持关联已有归档。分类包括 infrastructure(AWS、ECS、IAM、网络、密钥、CloudWatch)、release(TestFlight、版本、Git Flow、CHANGELOG)、debugging(Bug 修复、错误排查、坑点)、feature(功能设计与实现笔记)、design(UI/UX、图标、视觉)。
使用方式:搜索用 grep -ri "keyword" .archive/,索引看 .archive/MEMORY.md。归档流程:先读 .archive/MEMORY.md 查重,按需创建日期目录,按 references/TEMPLATE.md 写 Markdown 文件,随后在 MEMORY.md 对应分类下加一行,若有相关归档则在 frontmatter 加 related 字段。查阅流程:先看 MEMORY.md 定位条目,再读具体归档文件获取细节,最后把经验用于当前任务。
限制与规则:.archive/ 必须加入 .gitignore,仅作本地笔记;条目要简洁但可复现,重点写问题、修复和确切命令;每次创建归档后必须更新 MEMORY.md;文件名要具描述性(如 cloudwatch-logging.md 而非 session.md);frontmatter 需含标签、分类和可选 related。详细内容以官方资料与实际使用为准。