用途：当用户要求暂停工作、交接会话、保存进度或创建交接文档，或上下文即将耗尽时，使用 dev-handoff 捕获当前会话状态，写入 .planning/HANDOFF.md，供新会话准确恢复。
主要能力：先读取现有状态文件再写交接文档。必须读取 .planning/SPEC.md（需求）、.planning/PLAN.md（任务拆分与进度）、.planning/progress.md（只追加的完成台账，对“不要重做”具有权威性）、.planning/ACTIVE_WORKFLOW.md（当前阶段），并评估已完成与剩余工作。随后按模板生成包含当前状态、已完成工作、剩余工作、决策、被否决方案、阻塞项、未提交变更和下一步具体行动的交接文档，最后校验各字段完整且下一步可立即执行。
使用方式：按流程先运行命令检查状态，例如 cat .planning/ACTIVE_WORKFLOW.md、cat .planning/progress.md、git status --short、git log --oneline -10，再评估进度并写入 .planning/HANDOFF.md。完成后报告阶段、任务编号和下一步摘要，并提示在项目中启动 /dev 可自动检测并恢复。
适用场景：开发会话中断、上下文不足、需要把工作交接给新会话或同事时。
限制：资料未提供安装方式、收费、价格、平台支持或效果数据；交接前必须先读取状态文件，否则不应写入；交接文档各字段为必填，模糊内容需修正。