session-memory

session-memory 技能是一种先进的机制，旨在解决 Claude Code 在隔离执行会话之间丢失上下文的问题。通过在 .claude/memory/ 目录中创建专用的持久化层，此技能确保项目决策、实现模式和任务历史记录在会话重新启动后依然存在。它专为需要长期项目连续性，并希望维护架构选择与开发工作流程单一事实来源 (SSOT) 的软件开发人员与工程师所设计。

• 使用唯一的环境变量自动跟踪会话日志，以实现审计能力与历史跟踪。

• 为关键项目数据维护不同的文件：session-log.md 用于记录历史，decisions.md 用于记录决策理由，patterns.md 用于记录可重用的编码标准。

• 通过 context.json 支持基于 JSON 的项目上下文管理，存储技术栈信息、项目阶段与元数据。

• 与 Agent Trace 日志整合，允许代理在恢复执行时，重建文件系统的近期状态与过去的工具执行历史。

• 实施分层记忆架构 (Layer 1-3)，区分全局工具使用模式与项目特定知识。

• 为 Claude Code 中的 --resume 工作流程提供无缝支持，促进复杂、多阶段开发任务的还原。

• 当您需要在休息后恢复工作，或被询问关于历史记录、项目状态或过去技术决策时，请使用此技能。

• 确保重要的架构决策被移至 decisions.md (SSOT) 以防止知识损耗。

• 在启动完整状态还原之前，利用 /recap 指令快速审查当前会话的进度。

• 将高度变动的临时数据排除在长期存储之外，以保持仓库整洁。

• 使用版本控制时请谨慎：虽然决策与模式应在 Git 中共享，但会话日志与上下文状态通常应保持在本地。

• 请注意，敏感凭证或个人识别信息 (PII) 绝不应提交至内存文件中。