用途:在多个工作会话之间追踪项目进度。它把实施计划(IMPLEMENTATION_PHASES.md)中的阶段(工作单元)转换为 SESSION.md(上下文单元),记录当前阶段、阶段状态与具体下一步动作,并配合 git 检查点便于恢复上下文。
主要能力:区分“阶段”和“会话”——阶段有验证与退出门槛,可能跨多个会话;会话在清空或压缩上下文前完成。阶段状态用图标标记:⏸️ 未开始、🔄 进行中、✅ 完成、🚫 阻塞。阶段内部还有实现、验证、调试三个子阶段。提供 SESSION.md 模板、检查点提交格式、CLAUDE 会话片段,以及 resume.sh(显示当前状态)。
使用方式:自动化命令 /wrap-session 会分析状态、更新 SESSION.md 和相关文档、创建检查点提交、输出摘要,可选推送;/continue-session 会加载 SESSION.md 与规划文档、显示 git 历史与摘要、展示验证标准(若处于验证阶段)、打开“下一步动作”文件并询问是否继续。手动流程为:更新 SESSION.md → git 检查点 → 写下具体下一步动作;恢复时读 SESSION.md、查看下一步动作再继续。检查点提交信息有固定格式,包含阶段、状态、本次会话成果、改动文件和下一步。
适用场景:project-planning 生成 IMPLEMENTATION_PHASES.md 后的新项目启动;上下文清空后恢复工作;阶段中期上下文写满时打检查点;阶段转换;跟踪实现→验证→调试循环。
限制与注意:SESSION.md 建议控制在 200 行以内,不复制代码、不重复规划文档、动作要具体(文件+行号+任务)。SESSION.md 在恢复时通常处于未提交状态,这是设计使然;但源码、配置文件、规划文档或新增未跟踪文件未提交时会触发警告。资料未提供具体收费、价格或平台信息。