名称: session 描述: “会话管理的综合窗口。处理初始化、记忆、状态一手包办。用于管理Claude Code会话、/session命令。不要用于:应用用户会话、登录状态、认证功能。” 英文描述: “统一会话管理窗口。一手处理初始化、记忆、状态。用于管理Claude Code会话、/session命令。不要用于:应用用户会话、登录状态、认证功能。” 日文描述: “会话管理的综合窗口。处理初始化、记忆、状态一手包办。用于管理Claude Code会话、/session命令。不要用于:应用用户会话、登录状态、认证功能。” 允许的工具: [“Read”, “Bash”, “Write”, “Edit”, “Glob”] 参数提示: “[list|inbox|broadcast "message"]”
会话技能(统一版)
将所有与会话相关的功能整合到一个技能中。
使用方法
/session # 显示可用选项
/session list # 显示活跃会话
/session inbox # 检查收件箱消息
/session broadcast "message" # 向所有会话广播消息
子命令
/session list - 列出活跃会话
显示当前项目中的所有活跃Claude Code会话。
📋 活跃会话
| 会话 ID | 状态 | 最后活动 |
|------------|--------|---------------|
| abc123 | 活跃 | 2 分钟前 |
| def456 | 空闲 | 15 分钟前 |
/session inbox - 检查收件箱
检查来自其他会话的传入消息。
📬 会话收件箱
| 来源 | 时间 | 消息 |
|------|------|---------|
| abc123 | 5分钟前 | "准备审核" |
| def456 | 10分钟前 | "API 实现完成" |
/session broadcast "message" - 广播消息
向所有活跃会话发送消息。
/session broadcast "审核完成,准备合并"
能力
| 功能 | 描述 | 参考 |
|---|---|---|
| 初始化 | 启动新会话,加载上下文 | 参见 …/session-init/SKILL.md |
| 记忆 | 跨会话持久化学习内容 | 参见 …/session-memory/SKILL.md |
| 状态控制 | 基于标志恢复/分支会话 | 参见 references/session-control.md |
| 通信 | 跨会话消息传递 | 参见 …/session-state/SKILL.md |
内存优化(CC 2.1.49+)
Claude Code 2.1.49 及更高版本,会话恢复时的内存使用量减少了 68%。
长时间会话管理的最佳实践
| 工作负载 | 推荐策略 |
|---|---|
| 通常实现 | 每1-2小时使用 --resume 恢复 |
| 大规模重构 | 按功能单元分割会话 → 每个会话使用 --resume |
| 并行任务 | 使用 /work all 并行执行,长时间任务中途使用 --resume |
| 内存警告时 | 立即使用 --resume 恢复(比以前更快) |
会话名称自动生成(CC 2.1.41+)
执行 /rename 不带参数时,根据对话上下文自动生成会话名称。
在长时间会话或频繁使用 --resume 的工作流程中,更容易识别会话。
高效工作流程示例
# 实现阶段1
claude "实现认证功能"
# → 1小时后
# 会话恢复(内存高效)
claude --resume "添加密码重置功能"
# → 1小时后
# 再次恢复
claude --resume "添加测试"
内存管理推荐事项
| 推荐事项 | 理由 |
|---|---|
| 积极恢复会话 | 68% 内存减少,恢复成本低 |
| 定期恢复 | 整理上下文,保持专注力 |
| 按功能单元分割 | 将大任务分割成小块恢复 |
| 利用 Plans.md | 恢复时的交接更顺畅 |
💡 由于内存效率大幅改善,请积极利用会话恢复。
使用时机
- 会话初始化 (
/harness-init) - 会话恢复/分支 (
/work --resume,/work --fork) - 记忆持久化(自动)
- 跨会话通信 (
/session broadcast)
执行流程
1. 会话初始化
/harness-init
↓
├── 加载项目上下文
├── 初始化 session.json
├── 加载先前会话记忆(如果存在)
└── 显示会话状态
2. 会话控制(来自 /work)
/work --resume
↓
├── 检查 session.json 是否存在
├── 加载会话状态
└── 从最后一个检查点继续
/work --fork
↓
├── 创建新会话分支
├── 复制相关上下文
└── 从新开始使用上下文
3. 记忆持久化
会话结束
↓
├── 提取学习内容(注意事项、模式)
├── 更新 .claude/memory/*.md
└── 准备交接摘要
4. 跨会话通信
/session broadcast "message"
↓
├── 查找活跃会话
├── 写入 session.events.jsonl
└── 通知所有会话
管理的文件
| 文件 | 目的 |
|---|---|
.claude/state/session.json |
当前会话状态 |
.claude/state/session.events.jsonl |
跨会话通信的事件日志 |
.claude/memory/*.md |
持久化记忆文件 |
迁移说明
此技能整合了:
session-init→ 会话初始化session-memory→ 记忆持久化session-control→ 恢复/分支控制session-state→ 状态管理与通信
个别技能已弃用,但为向后兼容仍可工作。