项目知识归档
将以下提示词粘贴到你的 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 条目。
典型归档流程:
- 先读
.archive/MEMORY.md,看是否已有相关记录 - 在需要时创建
.archive/YYYY-MM-DD/ - 按模板写入条目(问题、修复、精确命令)
- 必须在
MEMORY.md对应分类下追加一行索引 - 有关联条目时在 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