用途:让 Claude Code 在上下文重置、会话中断或长时间暂停后仍能无缝继续工作,通过结构化文档保存当前任务、决策与进度。
主要能力:采用三文件结构,位于 plans/active/{task-name}/。{task-name}-plan.md 记录高层策略、需求、架构、阶段、依赖与风险,仅在方案变化时更新;{task-name}-context.md 记录当前状态、决策、发现、阻塞、修改文件与快速恢复说明,其中 SESSION PROGRESS 是核心,包含已完成、进行中、待办、阻塞和下一步动作;{task-name}-tasks.md 是带验收标准的可执行清单,按阶段拆分任务并标注状态。
使用方式:提到 Waypoint 计划、恢复工作、会话存活、上下文重置、任务交接、进度跟踪、长期功能或需要记录当前状态时自动激活。命令包括 /create-plan [task-name] 创建三文件结构,/update-context 更新 SESSION PROGRESS,/resume 或 /resume [task-name] 显示最新上下文与下一步,/archive [task-name] 归档已完成工作。
适用场景:超过 2 小时的功能、多会话工作、复杂实现、可能被打断的工作、团队交接、影响多文件的重构。简单修复、文档更新、小 UI 调整和配置变更可选;琐碎改动、自动化任务和一行修复不建议使用。
限制:资料未提供安装方式、收费、价格、平台支持或效果保证。需避免记录凭据、API 密钥等敏感信息;上下文超过 3 天未更新视为过期,恢复前应核对代码与 git log。文件命名建议小写、连字符分隔、描述性且不超过 3-4 个词。