关于 archive
Archive 是用于跨会话保存项目知识的 Agent Skill,将内容写入按日期组织的 Markdown 文件,并通过索引查找。它引导团队记录重要工作的经验,并在重复任务前查询以往的修复和流程记录。
主要功能
- 01按日期创建 Markdown 归档
- 02使用 MEMORY.md 中央索引
- 03归档与查找工作流指引
- 04项目知识分类
- 05关联归档引用
适用场景
- 01保存部署后的经验
- 02查找以往的基础设施修复
- 03复用过去流程的记录
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ resciencelab/ opc-skills --skill archive安装后在 Claude Code 中输入/archive确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
.factory-plugin/plugin.jsonhooks/hooks.jsonload-memory.pyreferences/TEMPLATE.md详细介绍
归档技能
跨会话捕获、索引并复用项目知识。
何时归档
- 完成重要任务后(部署、迁移、重大功能)
- 解决棘手的调试问题后
- 用户说“归档这个”时
- 完成任何值得保留经验的多步骤流程后
何时查阅归档
- 调试基础设施、部署或 CI 问题前
- 重复过去某次会话中执行过的流程前
- 遇到可能已解决过的错误时
搜索:grep -ri "keyword" .archive/
索引:.archive/MEMORY.md
归档工作流
- 阅读
.archive/MEMORY.md——检查是否已有相关归档 - 如有需要,创建
.archive/YYYY-MM-DD/目录 - 按照
references/TEMPLATE.md创建带有 YAML frontmatter 的 Markdown 文件 - 更新
.archive/MEMORY.md:在相应类别下添加一行条目 - 如果存在相关归档,在 frontmatter 中添加
related字段
查找工作流
- 阅读
.archive/MEMORY.md,查找相关条目 - 阅读具体归档文件,了解详细背景
- 将经验应用到当前任务
类别
- 基础设施 — AWS、ECS、IAM、网络、密钥、CloudWatch
- 发布 — TestFlight、版本管理、Git Flow、CHANGELOG
- 调试 — Bug 修复、错误解决、注意事项
- 功能 — 功能设计、实现说明
- 设计 — UI/UX、图标、视觉设计
规则
.archive/必须列入.gitignore——仅保存本地笔记- 条目应简洁,但要能复现
- 重点记录问题、修复方法和确切命令
- 创建归档后,始终更新 MEMORY.md
- 使用描述性文件名(例如,使用
cloudwatch-logging.md,而不是session.md) - 添加包含
tags、category和可选related字段的 YAML frontmatter
评论
支持 Markdown