Context Persistence Skill 技能

技能简介

Context Persistence（跨会话上下文持久化）是 DojoCodingLabs 开源的 Agent Skill，解决长周期 AI 编程任务中"上下文一重置，决策、进度、下一步全部丢失"的问题。它定义了一套 waypoint（航点）文件结构，让 Claude、Codex、Claude Code 在会话中断或历史被清空后快速恢复工作状态。Skillstore 审计通过，55 条静态发现全部确认为 Markdown 示例误报，MIT 协议，页面浏览 294 次，是本批候选中关注度最高的技能。

核心能力

1. 三文件航点结构：plan（计划）、context（上下文）、tasks（任务清单）分工明确。
2. 规范进度记录写法：已完成、进行中、阻塞点、决策与下一步动作。
3. 提供快速恢复模板，上下文重置后照模板即可接续任务。
4. 明确航点的创建、更新、归档时机，避免文件腐化。
5. 配套 create、update、resume、archive 四个斜杠命令工作流。

安装配置

1. 一条命令安装：npx skillstore add dojocodinglabs/context-persistence。
2. 支持 Claude、Codex、Claude Code，自动安装与手动安装均被审计允许。
3. 风险因子仅 external_commands，审计确认无可执行脚本与网络行为；航点文件可纳入版本库，但严禁写入密钥与 API Key。

使用步骤

1. 安装技能。
2. 任务开始时让助手创建航点："建一个 waypoint 计划，包含战略计划、当前上下文和任务清单。"
3. 里程碑、决策或遇到阻塞时让助手更新 context，写清改动文件与下一个具体动作。
4. 新会话开始时让助手"读取活动航点，总结状态、核对下一个动作并从记录处继续"；笔记超过三天先刷新再续。

适用场景

1. 跨多个会话的长功能开发，保持进度连续。
2. 项目状态交接给其他贡献者或下一个 AI 会话。
3. 上下文重置、长中断之后的现场恢复。
4. 审计过期航点：对照仓库现状找出陈旧假设并更新任务表。

适用人群

用 AI 助手做多会话长任务的开发者、需要交接项目状态的维护者、被"聊太久上下文被清空"困扰的 Claude Code 与 Codex 重度用户。Skillstore 页面浏览 294 次。

工作原理

技能约定用三个文本文件充当会话外部记忆：plan 存战略拆解，context 存当前状态，tasks 存可执行清单。会话推进中助手持续把决策与进度写回文件；新会话或重置后先读文件重建记忆，再核对下一个动作继续执行。它不自动校验笔记与代码是否一致，效果取决于持续更新，因此建议里程碑必更新、恢复前先刷新陈旧笔记。

最佳实践与反模式

正确用法：里程碑、决策、阻塞或任务切换后立即更新进度；"下一步"写到具体文件、函数与预期结果；笔记超过三天先对照仓库刷新再恢复。反模式：给一行改动或纯机械清理也建航点流程；进度笔记写得模糊、不提当前文件与具体动作；把凭证、API Key 等秘密写进航点文档。审计也点出唯一运营风险：航点笔记过期可能误导后续会话，靠养成刷新习惯化解。

官方链接

Skillstore：https://skillstore.io/skills/dojocodinglabs-context-persistence GitHub：https://github.com/DojoCodingLabs/claude-code-waypoint （MIT）