#会话管理

#命名与恢复

会话用于保存围绕某项任务的对话与执行记录。终端版会话与项目目录相关，并在本地持续保存。任务需要分多次完成时，可使用明确的名称区分不同工作，例如“搜索功能调整”“导入错误排查”。

在会话中输入：

/rename {search-adjustment}

退出后，可在操作系统终端恢复：

claude --resume {search-adjustment}

需要从列表选择时，运行 claude --resume；继续当前目录最近会话时，运行 claude --continue。恢复后应先核对当前分支和文件变化，尤其是在其他人员或程序已经修改项目的情况下。

恢复对话不会自动将文件恢复到历史状态。 会话中保留的结论可能来自较早版本，后续分析仍应以当前文件为依据。终端、网页、桌面及编辑器入口的会话管理方式也存在差异，不能假定所有历史记录都会自动同步。

#压缩与清理

/compact 与 /clear 的用途不同：前者通过摘要减少当前会话占用，适合继续同一任务；后者开启空上下文的新会话，适合切换到另一项任务。两者都不表示撤销文件修改。

/compact 请重点保留当前任务目标、允许修改范围、已确认方案、修改文件、测试结果和未完成事项，省略已经排除的调试过程。

压缩后，可先要求复述当前目标与下一步安排，检查重要约束是否仍然清晰。存在必须逐字保留的需求或较长规格说明时，应保存为文件，并在后续任务中重新引用。

请依据{docs/task-handoff.md}和当前项目文件，说明本轮需要继续完成的事项。
如文件内容与会话摘要不一致，请指出差异，先确认当前有效依据。

运行 /clear 后，先前会话仍可通过 /resume 查找。项目中的长期规则与已有文件也不会因此被删除。

#分支与旁问

需要比较不同实现方向时，可使用 /branch 创建对话分支，在保留原会话的基础上展开另一条讨论路线。

/branch alternative-search

对话分支与 Git 分支不同。复制会话并不自动创建独立代码目录；如果两个会话修改同一目录，仍可能相互影响。需要隔离文件修改时，应使用独立工作目录或 Git worktree。

只需询问当前上下文中的细节时，可使用 /btw，例如查询此前确认的文件名称。其回答不加入主会话历史，也不会为了回答问题读取新文件或执行工具；需要进一步查证或修改时，应回到正常任务对话。

#上下文范围

上下文是当前会话用于理解任务的信息，包括对话、已读取内容、工具结果及相关规则。它具有容量限制，不能理解为能够始终完整保留全部历史信息。可运行 /context 查看占用情况；会话较长时，系统会按需清理较早工具输出并进行摘要。

长期有效的项目规范宜写入 CLAUDE.md；阶段目标、验收标准和当前进度可保存到明确的项目文档。临时日志和无关分析不宜反复加入会话。需要交接时，可以要求汇总当前状态：

请整理当前任务的交接说明，包含：

1. 已确认目标及处理范围；
2. 当前采用的需求版本；
3. 已修改文件及修改目的；
4. 实际执行的检查和结果；
5. 尚未完成的事项；
6. 已取消或被替代的要求；
7. 下一步应执行的工作。

请以当前文件和实际执行记录为依据。
将说明保存到{docs/task-handoff.md}，不要添加未经确认的结论。