上下文工程 · 实操指南

> 文档定位：上下文工程的详细操作步骤与实战技巧 > 版本：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 诊断命令

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

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

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

---

五、模板参考

5.1 标准快照模板

```markdown

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

项目/任务信息

名称:

类型: 开发/写作/分析/规划/其他

领域:

优先级: 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 快速记录模板

```markdown

快速快照 · {项目名}

时间: 进度:

完成

待办

[ ]

备注

```

---

六、最佳实践清单

生成快照前检查

[ ] 项目/任务名称清晰

[ ] 进度百分比准确

[ ] 已完成事项完整

[ ] 待办事项分优先级

[ ] 关键决策已记录

恢复快照后检查

[ ] 项目信息正确加载

[ ] 进度状态准确

[ ] 待办事项完整

[ ] AI记忆状态已恢复

[ ] 可以继续执行

定期维护任务

[ ] 每周清理过期快照

[ ] 每月归档已完成项目

[ ] 每季度优化快照模板

[ ] 每年回顾快照使用数据

---

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