用途：在项目根目录维护 SESSION_PROGRESS.md，让多会话工作可以暂停、恢复和交接，避免每次重建上下文。文件需与实际情况一致，应在完成任务、计划变更、失败或向用户提问前主动记录，而不是等待指令。
主要能力：文件采用固定 frontmatter（schema、project、session_id、roadmap_ref、started、last_updated、status）和 HTML id 标记，cc-dash 仪表盘会读取这些内容。正文包含 Plan、Current Status 两个必需段落，以及 Decisions、Failed Attempts、Completed Work 等可选段落。任务用 t_ 前缀 id，失败尝试用 f_ 前缀，dep: 引用任务 id。
使用方式：无参数调用时按分支处理——无文件则 Start；当前对话有未记录工作则 checkpoint 后继续；文件已完成则交接；否则 Resume。save 会检查点后停止，verify 验证已完成任务，recover 从 Claude Code 转录重建文件。时间戳应取自系统时钟，例如 date +%Y-%m-%dT%H:%M:%S%z | sed -E 's/([0-9]{2})$/:\1/'。
适用场景：跨多个会话的长期开发任务、需要交接给后续会话的工作、需要记录决策与失败原因以免重复尝试的场景。
限制：只有顶部 frontmatter 会被解析；SESSION_PROGRESS.md 常被公开仓库 gitignore，替换前需用 git ls-files --error-unmatch 检查，未跟踪时应先归档。id 格式错误会导致 cc-dash 丢弃该条目。文件应使用 Edit 或 Write 写入，而非 Bash heredoc 或 sed -i，否则 recover 无法重建。每个仓库仅根目录一个文件。其他细节暂未提供。