session

Session Skill（统一版）

将所有与会话相关的功能整合为一个技能。

用法

/session              # Show available options
/session list         # Show active sessions
/session inbox        # Check incoming messages
/session broadcast "message"  # Send message to all sessions

子命令

/session list - 列出活动会话

显示当前项目中的所有活动 Claude Code 会话。

📋 Active Sessions

| Session ID | Status | Last Activity |
|------------|--------|---------------|
| abc123     | active | 2 min ago     |
| def456     | idle   | 15 min ago    |

/session inbox - 检查收件箱

检查是否有来自其他会话的消息。

📬 Session Inbox

| From | Time | Message |
|------|------|---------|
| abc123 | 5m ago | "Ready for review" |
| def456 | 10m ago | "API implementation done" |

/session broadcast "message" - 广播消息

向所有活动会话发送消息。

/session broadcast "Review complete, ready for merge"

---

功能

功能	描述	参考
初始化	开始新会话，加载上下文	参见 ../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	恢复时可以顺利交接

💡 内存效率已大幅提升，请积极利用会话恢复功能。

Codex 0.123.0 的 session shell / terminal 修复

在 Codex 0.123.0 中，stale proxy env 不易再从 shell snapshot 恢复；VS Code WSL terminal 的 Unicode / dead-key input 和 keyboard 输入也已在主体中修复。 Harness 会自动继承主体修复，无需添加 proxy snapshot scrubber 或 key input wrapper。

---

适用场景

• 会话初始化（/harness-init）
• 会话恢复/分叉（/work --resume、/work --fork）
• 内存持久化（自动）
• 跨会话通信（/session broadcast）

执行流程

1. 会话初始化

/harness-init
    ↓
├── Load project context
├── Initialize session.json
├── Load previous session memory (if exists)
└── Display session status

2. 会话控制（来自 /work）

/work --resume
    ↓
├── Check session.json exists
├── Load session state
└── Continue from last checkpoint

/work --fork
    ↓
├── Create new session branch
├── Copy relevant context
└── Start fresh with context

3. 内存持久化

Session end
    ↓
├── Extract learnings (gotchas, patterns)
├── Update .claude/memory/*.md
└── Prepare handoff summary

4. 跨会话通信

/session broadcast "message"
    ↓
├── Find active sessions
├── Write to session.events.jsonl
└── Notify all sessions

管理的文件

文件	用途
.claude/state/session.json	当前会话状态
.claude/state/session.events.jsonl	跨会话通信的事件日志
.claude/memory/*.md	持久化记忆文件

迁移说明

此技能整合了：

• session-init → 会话初始化
• session-memory → 内存持久化
• session-control → 恢复/分叉控制
• session-state → 状态管理与通信

这些独立技能已弃用，但仍可用于向后兼容。