Agent Skills
返回列表
📚

项目知识归档

知识管理 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/resciencelab-opc-skills-archive。

技能介绍

问题从哪来

结对编程或 Agent 会话里,部署脚本、IAM 权限、CI 报错和排查命令往往只留在当次上下文里。几周后遇到同类基础设施或发布问题,你只能从零 grep 日志、翻聊天记录,可复现的步骤和已验证的 fix 容易断层。

技能如何工作

Archive Skill 约定在项目根下维护本地目录 .archive/(且应加入 .gitignore),用 MEMORY.md 做分类索引,按日期子目录存放带 YAML frontmatter 的 Markdown 条目。

典型归档流程:

  1. 先读 .archive/MEMORY.md,看是否已有相关记录
  2. 在需要时创建 .archive/YYYY-MM-DD/
  3. 按模板写入条目(问题、修复、精确命令)
  4. 必须在 MEMORY.md 对应分类下追加一行索引
  5. 有关联条目时在 frontmatter 里写 related

查阅时同样从 MEMORY.md 定位,再打开具体文件应用经验。分类包括 infrastructure、release、debugging、feature、design;可用 grep -ri "keyword" .archive/ 做全文检索。

边界与注意点

这是本机笔记,不替代团队 Wiki 或 Runbook。条目要短但能让人照着重做;文件名应描述主题(如 cloudwatch-logging.md),避免泛用 session.md。

使用场景

  • 完成一次 ECS 部署或 IAM 变更后,要把使用的命令与踩坑点写入归档,供下次改集群前查阅
  • CI 或 TestFlight 发布失败后刚定位根因,需要在关闭会话前把 fix 与版本流程记入 release 分类
  • 调试基础设施报错前,先查 MEMORY.md 和 .archive/ 里是否已有相同错误与解决方案
  • 用户说「archive this」或刚结束多步骤迁移时,按模板落盘并更新索引,避免经验只留在对话里

适合人员

  • 负责 AWS/ECS/网络与密钥配置、需要在不同会话间延续基础设施排查笔记的后端工程师
  • 参与 Git Flow、TestFlight 或 CHANGELOG 维护、希望重复发布流程时能对照历史记录的移动端或发布工程师
  • 长期用 AI 结对写代码、希望部署与排错结论落在项目内可 grep 索引而非聊天记录的独立开发者
  • 在复杂 bug 会话结束后需要把问题、修复与精确命令结构化保存的 DevOps 或 SRE