name: mpm-session-pause description: 暂停会话并保存当前工作状态以供稍后恢复 user-invocable: true version: “1.0.0” category: mpm-command tags: [mpm-command, session, pm-recommended]

/mpm-pause

暂停当前会话并保存所有工作状态以供稍后恢复。

功能

当调用时，此技能：

捕获当前工作状态（待办事项、Git状态、上下文摘要）
在 .claude-mpm/sessions/session-{timestamp}.md 创建会话文件
更新 .claude-mpm/sessions/LATEST-SESSION.txt 指针
可选地将会话状态提交到Git
向用户显示会话文件路径以供稍后恢复

用法

/mpm-pause [可选消息描述当前工作]

示例:

/mpm-pause
/mpm-pause 正在处理身份验证重构，即将测试登录流程
/mpm-pause 需要上下文切换到紧急错误修复

实现

执行以下Python代码以暂停会话:

from pathlib import Path
from claude_mpm.services.cli.session_pause_manager import SessionPauseManager

# 可选：从用户命令中获取消息
# 如果用户在 /mpm-pause 后提供了消息，提取它
# 否则，消息 = None

# 创建会话暂停管理器
manager = SessionPauseManager(project_path=Path.cwd())

# 创建暂停会话
session_id = manager.create_pause_session(
    message=message,  # 可选上下文消息
    skip_commit=False,  # 如果在仓库中，将提交到Git
    export_path=None,  # 无需额外导出
)

# 向用户报告成功
print(f"✅ 会话暂停成功！")
print(f"")
print(f"会话ID: {session_id}")
print(f"会话文件:")
print(f"  - .claude-mpm/sessions/{session_id}.md (人类可读)")
print(f"  - .claude-mpm/sessions/{session_id}.json (机器可读)")
print(f"  - .claude-mpm/sessions/{session_id}.yaml (配置格式)")
print(f"")
print(f"快速恢复:")
print(f"  /mpm-resume")
print(f"")
print(f"查看会话上下文:")
print(f"  cat .claude-mpm/sessions/LATEST-SESSION.txt")
print(f"  cat .claude-mpm/sessions/{session_id}.md")

保存内容

会话状态:

会话ID和时间戳
当前工作目录
Git分支、最近提交和文件状态
主要任务和当前阶段
上下文消息（如果提供）
TaskList状态（来自Claude Code的待处理/进行中任务）

恢复指令:

快速启动命令
验证命令
要审查的文件

文件格式:

.md - 人类可读的markdown（用于阅读）
.json - 机器可读（用于工具）
.yaml - 人类可读的配置（用于编辑）

会话文件位置

所有会话文件存储在：

.claude-mpm/sessions/
├── LATEST-SESSION.txt          # 指向最近会话的指针
├── session-YYYYMMDD-HHMMSS.md
├── session-YYYYMMDD-HHMMSS.json
└── session-YYYYMMDD-HHMMSS.yaml

令牌预算

令牌使用: 约5-10k令牌执行（上下文预算的2-5%）

好处: 保存所有剩余上下文以供将来恢复，允许您：

上下文切换到紧急任务
休息后稍后恢复
在进行重大更改前存档当前工作状态

稍后恢复

要恢复此会话：

/mpm-resume

或手动：

cat .claude-mpm/sessions/LATEST-SESSION.txt
cat .claude-mpm/sessions/session-YYYYMMDD-HHMMSS.md

Git集成

如果在Git仓库中，会话将自动提交，消息为：

会话: 暂停于 YYYY-MM-DD HH:MM:SS

会话ID: session-YYYYMMDD-HHMMSS
上下文: [您的可选消息]

使用案例

上下文切换:

/mpm-pause 切换到紧急生产错误

工作会话结束:

/mpm-pause 完成API重构，准备明天测试

进行重大更改前:

/mpm-pause 在尝试风险重构前保存状态

当接近上下文限制时:

/mpm-pause 达到150k令牌，开始新会话

注意

会话文件是项目本地的（不在机器间同步）
Git提交是可选的（如果不是仓库，自动跳过）
LATEST-SESSION.txt 总是指向最近会话
会话格式与自动暂停功能兼容（70%上下文触发）

MPM会话暂停Skill mpm-session-pause