---
name: session-recovery
type: checklist
when: '会话启动, 新会话, 上下文恢复, 状态恢复, 断点续传'
scope: ['*']
products:
  - '*'
id: ka-checklist-会话恢复
asset_kind: checklist
lifecycle_status: active
authority: supporting
routes: ['*']
primary_triggers:
  - 会话启动
  - 新会话
  - 上下文恢复
  - 状态恢复
  - 断点续传
secondary_triggers: []
negative_triggers: []
priority: P1
specificity: 5
emits: []
version: 1.1.0
last_reviewed: '2026-06-01'
stages: ["代码审查", "联调验证"]
owner_mechanism_id: mc-task-context-lifecycle
---

## 适用场景

每次新会话启动时，AI 必须首先执行上下文对齐，防止在失忆状态下产生无效交付。

## 步骤

1. 调用 sf_resume_workspace 扫描 .soloforge/state/ 目录
2. 若 resumed=true：播报中断工单的 task_id、阶段、已完成的产出，询问人类是否继续
3. 若 resumed=false：工作区干净，正常进入分类流程
4. 恢复时读取 .soloforge/output/ 下的前序产出文件
5. 基于 state/current-task.json 中的 snapshot 字段恢复上下文

## 检查点

- [ ] 已调用 sf_resume_workspace 且获得 resumed 状态
- [ ] resumed=true 时已向人类展示中断进度
- [ ] 恢复后的任务阶段与 state 记录一致
- [ ] 前序产出文件存在且可读

## 注意事项

- AI 禁止在未执行上下文对齐的情况下直接开始新任务
- 状态文件格式为 JSON，包含 task_id、phase、snapshot、created_at 字段
- 若 state 文件损坏，标记为 dirty 并向人类报告，不自动忽略
