Back to Details

archive

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Archive Skill

Archive Skill

Capture, index, and reuse project knowledge across sessions.
捕获、索引并跨会话复用项目知识。

When to Archive

归档时机

  • After completing a significant task (deploy, migration, major feature)
  • After resolving a tricky debugging session
  • When the user says "archive this"
  • After any multi-step process with learnings worth preserving
  • 完成重要任务后（部署、迁移、主要功能开发）
  • 解决棘手的调试问题后
  • 用户要求“归档这个”时
  • 完成任何有值得保留的学习内容的多步骤流程后

When to Consult Archives

查询归档时机

  • Before debugging infrastructure, deploy, or CI issues
  • Before repeating a process done in a past session
  • When encountering an error that may have been solved before
Search: 
grep -ri "keyword" .archive/
Index: 
.archive/MEMORY.md
  • 调试基础设施、部署或CI问题之前
  • 重复过去会话中执行过的流程之前
  • 遇到可能之前已解决过的错误时
搜索：
grep -ri "keyword" .archive/
索引：
.archive/MEMORY.md

Archive Workflow

归档工作流

  1. Read 
    .archive/MEMORY.md
    — check for related existing archives
  2. Create 
    .archive/YYYY-MM-DD/
    directory if needed
  3. Write markdown file with YAML frontmatter (see 
    references/TEMPLATE.md
    )
  4. Update 
    .archive/MEMORY.md
    : add one-line entry under the right category
  5. If related archives exist, add 
    related
    field in frontmatter
  1. 读取
    .archive/MEMORY.md
    ——检查是否有相关的现有归档
  2. 如有需要，创建
    .archive/YYYY-MM-DD/
    目录
  3. 编写带YAML前置元数据的Markdown文件（参考
    references/TEMPLATE.md
    ）
  4. 更新
    .archive/MEMORY.md
    ：在对应分类下添加一行条目
  5. 若存在相关归档，在前置元数据中添加
    related
    字段

Lookup Workflow

查询工作流

  1. Read 
    .archive/MEMORY.md
    to find relevant entries
  2. Read the specific archive file for detailed context
  3. Apply learnings to current task
  1. 读取
    .archive/MEMORY.md
    找到相关条目
  2. 阅读具体的归档文件获取详细上下文
  3. 将所学内容应用到当前任务中

Categories

分类

  • infrastructure — AWS, ECS, IAM, networking, secrets, CloudWatch
  • release — TestFlight, versioning, Git Flow, CHANGELOG
  • debugging — Bug fixes, error resolution, gotchas
  • feature — Feature design, implementation notes
  • design — UI/UX, icons, visual design
  • infrastructure — AWS、ECS、IAM、网络、密钥、CloudWatch
  • release — TestFlight、版本控制、Git Flow、CHANGELOG
  • debugging — Bug修复、错误解决、注意事项
  • feature — 功能设计、实现说明
  • design — UI/UX、图标、视觉设计

Rules

规则

  • .archive/
    must be in 
    .gitignore
    — local-only notes
  • Keep entries concise but reproducible
  • Focus on problems, fixes, and exact commands
  • Always update MEMORY.md after creating an archive
  • Use descriptive filenames (e.g., 
    cloudwatch-logging.md
    not 
    session.md
    )
  • Include YAML frontmatter with 
    tags
    , 
    category
    , and optional 
    related
  • .archive/
    必须加入
    .gitignore
    ——仅本地笔记
  • 条目需简洁但可复现
  • 重点记录问题、修复方案和确切命令
  • 创建归档后务必更新MEMORY.md
  • 使用描述性文件名（例如
    cloudwatch-logging.md
    而非
    session.md
    ）
  • 包含带
    tags
    、
    category
    和可选
    related
    字段的YAML前置元数据