用途:在长时间开发会话中维持上下文,支持中断后从上次状态无缝恢复。核心原则是在自然断点处检查点、恢复时即时接续。
主要能力:采用三级摘要。一级为快速更新,仅在 current-state.md 中更新活动任务、进度与下一步,约30秒;二级为完整检查点,更新完整 current-state.md 并记录决策到 decisions.md,触发条件包括完成功能或重要改动、做出架构或库决策、约20次工具调用、切换代码区域;三级为会话归档,创建 archive/YYYY-MM-DD[-topic].md、执行完整检查点、清理冗余笔记,并在引入新模式时更新 code-landmarks.md,触发条件为会话结束、完成重大功能或里程碑、上下文切换前、约50次以上工具调用。
使用方式:在项目中创建 _project_specs/session/ 目录,包含 current-state.md、decisions.md、code-landmarks.md 和 archive/。current-state.md 每15至20分钟或取得明显进展后更新,记录活动任务、阶段、进度、阻塞、被修改文件表、下一步、需保留的关键上下文与恢复说明。decisions.md 为只追加日志,记录决策、背景、备选方案、选择理由与权衡。code-landmarks.md 记录入口点、核心业务逻辑、配置、关键模式、测试与易错点。会话开始时读取 current-state.md,查看活动待办与近期决策,从下一步继续;会话结束或接近上下文限制时创建归档、更新交接状态、确保下一步具体可执行。
适用场景:长时间编码、多阶段功能开发、需要跨会话交接、上下文接近上限或频繁切换代码区域的开发工作。
限制:本技能依赖人工或模型主动执行更新与归档规则,需要将这些规则写入 CLAUDE.md 等入口文件才能被遵循;未提供强制自动化机制、具体平台支持范围或安装命令。文件命名、目录结构与脚本别名依据资料示例,实际使用需按项目调整。