核心功能
claude-session 是一套面向 Claude Code 的深度会话管理技能,提供从基础查询到高级治理的完整工具链:
信息查询类:id 查询当前会话UUID并支持关键词检索;summarize 跨会话查看与摘要;url 生成 web 浏览链接。
分析治理类:analyze 统计工具使用模式与优化建议;classify 智能分类会话(删除/保留/提取);split 识别话题边界推荐分割点。
数据流转类:import 向其他 agent/skill 管道化输送数据;migrate 主仓库与工作树间批量迁移;move 指定ID精确转移并更新 cwd。
维护修复类:repair 修复断裂的 chain、孤立的 tool_result、重复 UUID;purge 清理死会话;compress AI 压缩会话体积;rename 自定义会话标题;destroy 删除当前会话。
显著优点
- 功能覆盖完整,形成会话全生命周期管理闭环
- 深度集成 Claude Code 内部数据结构(UUID、chain、tool_result 等)
- 支持工作树(worktree)场景,适应复杂多仓库开发
- 提供
--dry-run预览机制,降低误操作风险 - 与 claude-sessions-mcp、Serena MCP 服务联动扩展能力
潜在局限
- 依赖外部 MCP 服务(claude-sessions-mcp),部署门槛较高
- 部分功能(如
classify --depth=medium)有性能/精度权衡 - 项目名转换规则硬编码,跨平台兼容性待验证
- 社区维护(es6kr),无官方背书,长期支持存在不确定性
- 会话修复逻辑为启发式,极端损坏场景可能无法完全恢复
适合人群
- 高频使用 Claude Code 的专业开发者
- 需要管理数十至数百会话的大型项目维护者
- 使用工作树模式的多分支并行开发团队
- 对会话数据有归档、审计、迁移合规需求的组织
常规风险
destroy、purge --delete、migrate --execute等操作不可逆,需严格使用预览模式- 会话压缩为有损操作,关键历史可能丢失
- 跨项目迁移时 cwd 路径更新可能引发工具调用路径错误
- MCP 服务异常时功能降级,需有 fallback 预案