用途:在数据科学(DS)工作流会话暂停时,把当前状态结构化地写入 .planning/HANDOFF.md,使新会话能准确接续,避免重新摸索。
主要能力:要求先读取状态文件再写交接文档,包括 .planning/SPEC.md(需求)、.planning/PLAN.md(任务分解与进度)、.planning/LEARNINGS.md(流水线状态与发现),并检查 git 状态与最近提交,评估已完成与剩余工作。交接模板包含 Current State、Completed Work、Remaining Work、Decisions Made、Rejected Approaches、Blockers、Uncommitted Changes、Next Action 等必填部分,并带 phase、task、total_tasks、status、context_remaining、decisions_count、last_updated 等 frontmatter。
使用方式:按流程先读状态,再评估进度,然后写文档,最后人工核验完整性。可用命令:git status --short 2>/dev/null 与 git log --oneline -10 2>/dev/null。完成后提示“Session handoff saved to .planning/HANDOFF.md”,并可通过 /ds 检测并恢复。
适用场景:DS 工作流会话需要暂停、跨会话交接、或需要记录决策、死路与下一步时。
限制:资料未提供安装方式、平台支持、收费与价格信息;强调必须先读状态文件,否则不得写交接文档。