上下文工程 · 实操指南

文档定位：上下文工程的详细操作步骤与实战技巧 版本：v1.0 | 创建日期：2026-04-14

---

一、快速开始

1.1 手动生成快照

场景：完成一个重要阶段，需要保存进度

操作步骤：

Step 1: 用户说"保存上下文"或"生成快照"
    ↓
Step 2: 系统自动收集当前状态
    ↓
Step 3: 生成结构化快照文件
    ↓
Step 4: 存储到IMA笔记和Obsidian
    ↓
Step 5: 确认保存成功

示例对话：

用户: 保存一下今天的进度

我: 📝 上下文快照生成中...

    项目: 企业文化OS构建
    类型: 系统规划
    进度: 65%
    
    已生成快照: context-企业文化OS-20260414-193000.md
    
    ✅ IMA笔记: 已存储
    ✅ Obsidian: 已备份
    
    下次说"恢复企业文化OS"即可继续。

1.2 自动触发场景

场景1：长周期项目

• 对话持续>30分钟
• 系统自动提示："检测到长周期项目，是否生成上下文快照？"

场景2：会话即将过期

• 系统提示会话将在5分钟后过期
• 自动询问："是否保存当前进度？"

场景3：复杂任务完成阶段

• 检测到S5/S7场景（重大决策/系统规划）
• 自动生成快照并提示："已保存关键决策记录"

1.3 恢复任务状态

场景：新会话启动，需要继续上次的工作

操作步骤：

Step 1: 用户说"恢复任务"或"继续上次"
    ↓
Step 2: 系统检测历史快照
    ↓
Step 3: 列出可用快照
    ↓
Step 4: 用户选择（或自动选择唯一快照）
    ↓
Step 5: 加载状态并展示概览
    ↓
Step 6: 确认继续执行

示例对话：

用户: 继续上次的企业文化OS

我: 🔍 找到 1 个相关快照

    📄 context-企业文化OS-20260414-193000.md
    项目: 企业文化OS构建
    进度: 65%（已完成框架设计、模块划分）
    待办: 3项高优先级任务
    
    是否恢复此快照? (是/查看详情/取消)

用户: 是

我: ✅ 上下文已恢复

    📊 当前状态:
    - 已完成: 框架设计、模块划分、接口定义
    - 进行中: 核心模块开发（35%）
    - 待办: 
      [高] 完成凤心OS模块
      [高] 编写测试用例
      [中] 更新文档
    
    💡 建议下一步: 继续凤心OS模块开发
    
    请指示如何继续。

---

二、高级用法

2.1 多快照管理

场景：一个项目有多个历史快照

操作：

用户: 查看企业文化OS的所有快照

我: 📚 找到 3 个快照:

    [1] context-企业文化OS-20260414-193000.md
        时间: 昨天 19:30
        进度: 65%
        状态: 已完成框架设计
    
    [2] context-企业文化OS-20260413-180000.md
        时间: 前天 18:00
        进度: 40%
        状态: 完成需求分析
    
    [3] context-企业文化OS-20260412-200000.md
        时间: 3天前 20:00
        进度: 20%
        状态: 项目启动
    
    请选择要恢复的快照（输入编号）:

2.2 选择性恢复

场景：只需要恢复部分信息

操作：

用户: 恢复企业文化OS的待办事项

我: 📝 从快照中提取待办事项:

    高优先级:
    - [ ] 完成凤心OS模块开发
    - [ ] 编写单元测试
    
    中优先级:
    - [ ] 更新接口文档
    
    低优先级:
    - [ ] 优化代码注释
    
    是否将这些待办事项添加到当前任务？

2.3 快照对比

场景：比较两个时间点的进度变化

操作：

用户: 对比昨天和今天的进度

我: 📊 进度对比:

    昨天 (2026-04-13):
    - 进度: 40%
    - 完成: 需求分析
    - 待办: 5项
    
    今天 (2026-04-14):
    - 进度: 65% (+25%)
    - 完成: 框架设计、模块划分
    - 待办: 3项 (-2项)
    
    📈 今日产出:
    - 新增完成: 2个阶段
    - 解决待办: 2项
    - 新增待办: 0项

---

三、实战技巧

3.1 优化快照质量

技巧1：及时保存

• 每完成一个重要阶段就保存
• 不要等到会话快过期才保存
• 关键决策后立即保存

技巧2：补充上下文

• 保存时主动补充关键信息
• 说明当前的思路和计划
• 记录遇到的困难和解决方案

技巧3：定期清理

• 项目完结后归档旧快照
• 删除过期的临时快照
• 保留重要里程碑快照

3.2 提高恢复效率

技巧1：标准化命名

• 使用清晰的项目名称
• 包含日期时间信息
• 简要说明当前阶段

技巧2：结构化记录

• 按模板填写关键信息
• 使用列表和表格
• 突出重点内容

技巧3：建立索引

• 在Obsidian中建立快照索引
• 使用双向链接关联相关快照
• 定期整理快照目录

3.3 协作场景

场景：团队协作，需要共享上下文

操作：

Step 1: 生成快照时选择"共享"选项
Step 2: 系统生成共享链接
Step 3: 团队成员通过链接访问
Step 4: 团队成员可以基于快照继续工作

注意事项：

• 敏感信息脱敏处理
• 明确版本和更新时间
• 建立共享快照的权限管理

---

四、故障排除

4.1 常见问题

问题1：快照生成失败

症状：系统提示"快照生成失败"

原因：

• 存储路径不存在
• 磁盘空间不足
• 权限不足

解决：

1. 检查存储路径是否存在
2. 清理磁盘空间
3. 检查文件权限
4. 尝试备用存储路径

问题2：恢复快照不完整

症状：恢复后发现信息缺失

原因：

• 原始快照信息不完整
• 恢复过程中出错
• 快照文件损坏

解决：

1. 检查原始快照文件完整性
2. 尝试恢复上一个版本
3. 手动补充缺失信息

问题3：找不到历史快照

症状：系统提示"未找到相关快照"

原因：

• 快照被删除
• 存储路径变更
• 搜索关键词不匹配

解决：

1. 检查IMA笔记中的快照目录
2. 检查Obsidian知识库
3. 使用模糊搜索
4. 检查本地备份

4.2 诊断命令

检查快照存储:
  命令: 检查IMA笔记/上下文快照/目录
  预期: 显示所有快照文件列表

检查快照完整性:
  命令: 验证快照文件格式
  预期: 所有必需字段都存在

测试恢复流程:
  命令: 恢复测试快照
  预期: 完整加载所有信息

---

五、模板参考

5.1 标准快照模板

# 上下文快照 · {项目名称}

## 项目/任务信息
- **名称**: 
- **类型**: 开发/写作/分析/规划/其他
- **领域**: 
- **优先级**: P0/P1/P2/P3
- **生成时间**: YYYY-MM-DD HH:MM

## 已完成事项
- [x] 事项1 (YYYY-MM-DD)
- [x] 事项2 (YYYY-MM-DD)
累计进度: X%

## 关键决策记录
| 决策内容 | 依据 | 时间 | 相关文件 |
|---------|------|------|---------|
| | | | |

## 待办事项
### 高优先级
- [ ] 

### 中优先级
- [ ] 

### 低优先级
- [ ] 

## 关键上下文
### 核心概念
- 

### 重要数据
- 

### 相关文件路径
- ``

## AI记忆状态
- **已加载Skills**: 
- **激活引擎**: 
- **知识库引用**: 

## 风险提示
| 已知问题 | 解决方案 |
|---------|---------|
| | |

## 会话摘要
### 核心产出

### 下一步建议

### 需确认事项
- [ ] 

## 接力说明
### 如何恢复上下文
1. 启动新会话
2. 说"恢复任务"
3. 选择本文件

### 相关快照文件
- 本文件: 

5.2 快速记录模板

# 快速快照 · {项目名}

时间: 
进度: 

## 完成
- 

## 待办
- [ ] 

## 备注

---

六、最佳实践清单

生成快照前检查

• [ ] 项目/任务名称清晰
• [ ] 进度百分比准确
• [ ] 已完成事项完整
• [ ] 待办事项分优先级
• [ ] 关键决策已记录

恢复快照后检查

• [ ] 项目信息正确加载
• [ ] 进度状态准确
• [ ] 待办事项完整
• [ ] AI记忆状态已恢复
• [ ] 可以继续执行

定期维护任务

• [ ] 每周清理过期快照
• [ ] 每月归档已完成项目
• [ ] 每季度优化快照模板
• [ ] 每年回顾快照使用数据

---

上下文工程实操指南 v1.0 从入门到精通，掌握AI任务连续性管理 🎯