Save and resume Claude Code session context across multiple windows. Perfect for developers juggling multiple tasks.

version
1.0.0
GitHub stars
20

Install

/plugin install context-sync@context-sync-marketplace

Run it inside Claude Code after adding the marketplace with /plugin marketplace add Claudate/claude-code-context-sync.

Contents

Discovered from source

Skills 2

上下文恢复指南

使用场景

在新的 Claude Code 窗口中,需要继续之前未完成的任务时调用此 Skill。


执行步骤

Step 1: 列出所有 Session

读取 docs/context-sessions/ 目录下的所有 .md 文件(排除 .gitkeep)。

输出格式:

📋 待处理的 Session 列表:

1. 20251128-1430-实现用户登录功能.md
   未完成任务: 3 项

2. 20251128-1600-修复导出bug.md
   未完成任务: 1 项

请告诉我要恢复哪个 session(输入序号或文件名)

如果目录为空,输出:

📭 当前没有待处理的 session。

所有任务已完成,或尚未使用 context-save 保存过上下文。

Step 2: 读取并展示 Session 内容

用户选择后,读取对应的 session 文件,完整展示内容。

输出格式:

📂 已加载 Session: {文件名}

---
{session 文件完整内容}
---

🎯 接下来要处理哪个任务?或者需要我继续之前的工作?

Step 3: 开始工作

根据 session 中的信息:

  1. 读取关键文件,恢复上下文理解
  2. 按优先级处理未完成任务
  3. 遵循"下一步行动"的建议

Step 4: 更新任务进度

每完成一个任务后,立即更新 session 文件:

  1. 将已完成的任务从"未完成"移到"已完成"
  2. 更新元信息中的"最后更新"时间
  3. 添加新发现的任务(如果有)

示例更新:

## 已完成任务
- [x] 任务1描述
- [x] 任务2描述
- [x] 🔴 高优先级: 实现 publishArticle 方法  ← 新完成

## 未完成任务
- [ ] 🔴 高优先级: 处理图片上传到微信服务器
- [ ] 🟡 中优先级: 添加发布结果回调

Step 5: 任务完成处理

当所有未完成任务都被完成后:

  1. 立即删除 session 文件
  2. 输出完成信息

输出格式:

🎉 Session 所有任务已完成!

已完成任务汇总:
- [x] 任务1
- [x] 任务2
- [x] 任务3

Session 文件已删除: docs/context-sessions/{文件名}

工作流程图

┌─────────────────┐
│  调用 skill     │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  列出所有       │
│  session 文件   │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  用户选择       │
│  要恢复的       │
│  session        │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  读取并展示     │
│  session 内容   │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  开始处理任务   │◄──────────┐
└────────┬────────┘           │
         │                    │
         ▼                    │
┌─────────────────┐           │
│  完成一个任务   │           │
│  更新 session   │           │
└────────┬────────┘           │
         │                    │
         ▼                    │
    ┌────────────┐            │
    │ 还有未完成 │───Yes──────┘
    │   任务?   │
    └─────┬──────┘
          │ No
          ▼
┌─────────────────┐
│  删除 session   │
│  文件           │
└─────────────────┘

命令快捷方式

在恢复 session 后,可以使用以下指令:

指令作用
继续按优先级继续处理下一个任务
更新进度手动触发 session 文件更新
查看剩余显示剩余未完成任务
换窗口处理-再次保存并切换窗口

注意事项

  1. 及时更新 - 每完成一个任务立即更新 session 文件
  2. 保持文件同步 - 如果发现新任务,添加到未完成列表
  3. 删除确认 - 只有当所有任务完成才删除文件
  4. 关键文件 - 恢复时优先读取 session 中列出的关键文件

上下文保存指南

触发条件

当用户发送 换窗口处理- 时,调用此 Skill。


执行步骤

Step 1: 分析当前上下文

回顾当前会话,提取以下信息:

  1. 核心任务 - 用户最初的请求是什么
  2. 已完成任务 - 本次会话中完成了哪些工作
  3. 未完成任务 - 还有哪些工作待完成
  4. 关键文件 - 正在操作或需要关注的文件
  5. 技术要点 - 重要的技术决策、踩过的坑
  6. 下一步行动 - 建议新窗口首先做什么

Step 2: 生成 Session 文件

文件命名规则: {YYYYMMDD}-{HHMM}-{简短描述}.md

示例: 20251128-1430-实现用户登录功能.md

文件位置: docs/context-sessions/

Step 3: 写入标准格式

# Session: {简短描述}

## 元信息
- **创建时间**: {当前时间}
- **状态**: 进行中

## 上下文摘要
{简洁描述当前正在做什么、背景信息、关键决策}

## 已完成任务
- [x] 任务1描述
- [x] 任务2描述

## 未完成任务
- [ ] 🔴 高优先级: {任务描述}
- [ ] 🟡 中优先级: {任务描述}
- [ ] 🟢 低优先级: {任务描述}

## 关键文件
- `{文件路径}` - {说明}
- `{文件路径}` - {说明}

## 注意事项
{需要注意的技术细节、已知问题、踩过的坑}

## 下一步行动
{建议新窗口首先执行的操作}

Step 4: 告知用户

保存完成后,输出:

✅ 上下文已保存到: docs/context-sessions/{文件名}

新窗口恢复方法:
1. 调用 skill: context-resume
2. 选择对应的 session 文件

未完成任务数: {数量}

优先级标记说明

标记含义使用场景
🔴高优先级阻塞性任务、核心功能
🟡中优先级重要但不紧急
🟢低优先级优化、可选功能

示例输出

# Session: 实现微信公众号发布功能

## 元信息
- **创建时间**: 2025-11-28 14:30
- **状态**: 进行中

## 上下文摘要
用户需要实现微信公众号的自动发布功能。已完成登录态获取和 Cookie 管理,正在实现文章发布 API 对接。

## 已完成任务
- [x] 创建 WechatPublisher 基础类结构
- [x] 实现 Cookie 存储和读取
- [x] 完成登录检测逻辑

## 未完成任务
- [ ] 🔴 高优先级: 实现 publishArticle 方法
- [ ] 🔴 高优先级: 处理图片上传到微信服务器
- [ ] 🟡 中优先级: 添加发布结果回调
- [ ] 🟢 低优先级: 添加草稿箱功能

## 关键文件
- `electron/services/publish/publishers/wechat.publisher.ts` - 主要开发文件
- `electron/services/core/cookie.service.ts` - Cookie 管理
- `shared/types/publish.types.ts` - 类型定义

## 注意事项
- 微信 API 有频率限制,需要添加请求间隔
- 图片需要先上传到微信素材库获取 media_id
- 登录态 24 小时过期,需要定期刷新

## 下一步行动
1. 先读取 wechat.publisher.ts 了解当前进度
2. 继续实现 publishArticle 方法
3. 参考 xiaohongshu.publisher.ts 的图片上传实现

注意事项

  1. 精炼总结 - 只保留关键信息,避免冗余
  2. 可执行性 - 未完成任务要具体、可操作
  3. 文件路径准确 - 确保关键文件路径正确
  4. 优先级合理 - 帮助新窗口快速确定工作重点

Commands 2

Skill(context-resume)

Skill(context-save)

Sponsors

Details

Marketplace
Claudate/claude-code-context-sync
Author
Nano-AI Team
Category
Productivity
License
MIT