用途:作为内部子技能,用于跨会话交接、持久化学习与记忆保存,仅由 session/memory 工作流调用。触发短语包括“前次做了什么”“从上次继续”“显示历史”“过去的作业”“介绍这个项目”等,由会话自动启动。
主要能力:在 .claude/memory/ 下记录并引用过去的工作内容、决定事项与学到的模式;提供 session-log.md(会话日志)、decisions.md(重要决定)、patterns.md(模式)、context.json(项目上下文),以及 .claude/state/agent-trace.jsonl(工具执行历史)作为 Agent Trace。自动记录带会话 ID 的信息,优先使用 Claude Code 的 ${CLAUDE_SESSION_ID},其次 Codex runtime 的 session/thread ID,再退回到 .claude/state/session.json 中的 .session_id,最后按日期生成。
使用方式:会话开始时读取 context.json、上次日志与 Agent Trace,识别未完成任务并生成摘要;会话中把决定写入 decisions.md、新模式写入 patterns.md、文件生成写入 session-log.md;结束时生成摘要、更新 context.json、记录交接事项。可通过 tail -50 .claude/state/agent-trace.jsonl | jq -r '.files[].path' | sort -u 取得上次编辑文件,tail -1 .claude/state/agent-trace.jsonl | jq '.metadata' 取得项目信息。长任务建议用 claude --resume 或 claude --resume "続きから" 定期重启会话;Claude Code 2.1.108+ 可用 /recap(/rewind 别名)查看当前会话进展。
适用场景:长时间实现、大规模重构、内存不足警告时按功能单位分割或重启会话。
限制与注意:建议 decisions.md/patterns.md 纳入共享版控,session-log.md、context.json、.claude/state/ 本地保存;不要记录机密信息;自动保存依赖 hooks/Stop 或其他设置,未采用时以手动方式运行;与 Claude Code 自动内存三层共存,可用 /memory ssot 提升为项目级;Agent Teams 并行写入需注意。具体细节以 docs/MEMORY_POLICY.md 与相关文档为准,其他平台、收费与效果信息暂未提供。