用途:在多次工作会话之间跟踪项目进度,用 SESSION.md 记录当前阶段、状态与下一步动作,并通过 git 检查点保存进度,便于上下文清空后恢复工作。
主要能力:区分阶段(IMPLEMENTATION_PHASES.md,工作单元,含验证/退出标准)与会话(SESSION.md,上下文单元,在清空或压缩上下文前完成);用 emoji 状态图标标记 ⏸️ 未开始、🔄 进行中、✅ 完成、🚫 受阻;阶段内区分 Implementation、Verification、Debugging 三个阶段并更新进度;提供 /wrap-session(分析状态、更新 SESSION.md 与相关文档、创建检查点提交、输出摘要)和 /continue-session(加载 SESSION.md 与规划文档、显示 git 历史与摘要、打开 Next Action 文件、询问是否继续)自动化命令;提供 SESSION.md.template、checkpoint-commit-format.md、CLAUDE-session-snippet.md 模板及 resume.sh 脚本。
使用方式:在 project-planning 生成 IMPLEMENTATION_PHASES.md 后,生成 SESSION.md,将 Phase 1 设为 🔄 并填写 Next Action;会话结束时运行 /wrap-session 或手动更新 SESSION.md 后创建 git 检查点,再设置具体的 Next Action;恢复时运行 /continue-session 或读取 SESSION.md,按 Next Action 继续。SESSION.md 建议放在项目根目录,保持 200 行以内,仅在显著进展后更新;检查点提交使用“checkpoint: Phase [N] [Status] - [描述]”格式,说明阶段、状态、本次会话完成内容、改动文件与下一步。
限制:SESSION.md 在检查点提交后更新哈希,因此在恢复时通常处于未提交状态,这属于正常设计;CLAUDE.md 与 .roomodes 也可能未提交。若源码、配置或规划文档出现未提交改动,/continue-session 会发出警告。资料未提供具体安装方式、价格或平台支持信息。