session

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Session Skill (Unified)

Session Skill（统一版）

Consolidates all session-related functionality into one skill.

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

Usage

使用方法

bash

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

bash

/session              # 显示可用选项
/session list         # 显示活跃会话
/session inbox        # 查看收到的消息
/session broadcast "message"  # 向所有会话发送消息

Subcommands

子命令

/session list

- List Active Sessions

/session list

- 列出活跃会话

Shows all active Claude Code sessions in the current project.

📋 Active Sessions

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

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

📋 活跃会话

| 会话ID | 状态 | 最后活动时间 |
|--------|------|--------------|
| abc123 | 活跃 | 2分钟前      |
| def456 | 空闲 | 15分钟前     |

/session inbox

- Check Inbox

/session inbox

- 查看收件箱

Checks for incoming messages from other sessions.

📬 Session Inbox

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

查看来自其他会话的消息。

📬 会话收件箱

| 发送方 | 时间 | 消息内容 |
|--------|------|----------|
| abc123 | 5分钟前 | "准备好审核" |
| def456 | 10分钟前 | "API实现完成" |

/session broadcast "message"

- Broadcast Message

/session broadcast "message"

- 广播消息

Sends a message to all active sessions.

bash

/session broadcast "Review complete, ready for merge"

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

bash

/session broadcast "Review complete, ready for merge"

Capabilities

功能特性

Feature	Description	Reference
Initialization	Start new session, load context	See ../session-init/SKILL.md
Memory	Persist learnings across sessions	See ../session-memory/SKILL.md
State Control	Resume/fork session based on flags	See references/session-control.md
Communication	Cross-session messaging	See ../session-state/SKILL.md

功能	描述	参考文档
初始化	启动新会话、加载上下文	参考 ../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+）

Claude Code 2.1.49 以降、セッション再開時のメモリ使用量が 68% 削減 されました。

从Claude Code 2.1.49版本开始，会话恢复时的内存使用量减少了68%。

長時間セッション管理のベストプラクティス

长会话管理最佳实践

ワークロード	推奨戦略
通常実装	1-2時間ごとに `--resume` で再開
大規模リファクタ	機能単位でセッション分割 → 各セッションで `--resume`
並列タスク	`/work all` で並列実行、長時間なら途中で `--resume`
メモリ警告時	即座に `--resume` で再開（以前より高速）

工作负载	推荐策略
常规实现	每1-2小时使用 `--resume` 恢复会话
大规模重构	按功能划分会话 → 每个会话使用 `--resume`
并行任务	使用 `/work all` 并行执行，若耗时较长则中途使用 `--resume`
收到内存警告时	立即使用 `--resume` 恢复会话（速度较之前更快）

セッション名の自動生成（CC 2.1.41+）

会话名自动生成（Claude Code 2.1.41+）

/rename

を引数なしで実行すると、会話コンテキストからセッション名を自動生成します。長時間セッションや

--resume

を多用するワークフローでセッションの識別が容易になります。

不带参数执行

/rename

时，会根据对话上下文自动生成会话名。这会让长会话或频繁使用

--resume

的工作流中，会话识别变得更简单。

効率的なワークフロー例

高效工作流示例

bash

undefined

bash

undefined

実装フェーズ1

实现阶段1

claude "認証機能を実装"

claude "实现认证功能"

→ 1時間後

→ 1小时后

セッション再開（メモリ効率的）

恢复会话（内存更高效）

claude --resume "パスワードリセット機能を追加"

claude --resume "添加密码重置功能"

→ 1時間後

→ 1小时后

さらに再開

再次恢复

claude --resume "テストを追加"

undefined

claude --resume "添加测试用例"

undefined

メモリ管理の推奨事項

内存管理推荐事项

推奨事項	理由
積極的なセッション再開	68% メモリ削減で再開コストが低い
定期的な再開	コンテキストを整理し、集中力を維持
機能単位の分割	大規模タスクを小さく分けて再開
Plans.md を活用	再開時の引き継ぎがスムーズ

💡 メモリ効率が大幅に改善されたため、セッション再開を積極的に活用してください。

推荐事项	理由
积极恢复会话	内存减少68%，恢复成本更低
定期恢复会话	整理上下文，保持专注
按功能拆分	将大型任务拆分为小部分后恢复
活用Plans.md	恢复时的交接更顺畅

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

When to Use

使用场景

Session initialization (
```
/harness-init
```
)
Session resume/fork (
```
/work --resume
```
,
```
/work --fork
```
)
Memory persistence (automatic)
Cross-session communication (
```
/session broadcast
```
)

会话初始化（
```
/harness-init
```
）
会话恢复/分叉（
```
/work --resume
```
,
```
/work --fork
```
）
记忆持久化（自动）
跨会话通信（
```
/session broadcast
```
）

Execution Flow

执行流程

1. Session Initialization

1. 会话初始化

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

/harness-init
    ↓
├── 加载项目上下文
├── 初始化session.json
├── 加载之前的会话记忆（如果存在）
└── 显示会话状态

2. Session Control (from /work)

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

/work --resume
    ↓
├── 检查session.json是否存在
├── 加载会话状态
└── 从最后一个检查点继续

/work --fork
    ↓
├── 创建新的会话分支
├── 复制相关上下文
└── 基于上下文重新开始

3. Memory Persistence

3. 记忆持久化

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

会话结束
    ↓
├── 提取学习内容（注意事项、模式）
├── 更新.claude/memory/*.md
└── 准备交接摘要

4. Cross-Session Communication

4. 跨会话通信

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

/session broadcast "message"
    ↓
├── 查找活跃会话
├── 写入session.events.jsonl
└── 通知所有会话

Files Managed

管理的文件

File	Purpose
`.claude/state/session.json`	Current session state
`.claude/state/session.events.jsonl`	Event log for cross-session communication
`.claude/memory/*.md`	Persistent memory files

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

Migration Note

迁移说明

This skill consolidates:

```
session-init
```
→ Session initialization
```
session-memory
```
→ Memory persistence
```
session-control
```
→ Resume/fork control
```
session-state
```
→ State management & communication

The individual skills are deprecated but still work for backward compatibility.

本技能整合了以下内容：

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

原有的独立技能已被弃用，但为了向后兼容仍可使用。