用途:在 .turbo/handoff/<YYYY-MM-DD>-<slug>.md 写入会话交接文件,让新会话能从上次中断处继续。
主要能力:
- 解析目标路径:用 date +%Y-%m-%d 取日期;slug 取小写、非字母数字替换为连字符、合并连续连字符、去掉首尾连字符、按词边界截断到 40 字符;若已有 .turbo/plans/<slug>.md 则复用该 slug;用户显式指定的 slug 或输出路径优先。用 git rev-parse --show-toplevel 定位仓库根;在链接工作树内(--git-dir 与 --git-common-dir 不同)改用 common dir 的父目录,使文件落在主检出而非随分支销毁的工作树。生成的 slug 冲突时依次用 -2、-3 等;用户指定的 slug 或路径已存在时用 AskUserQuestion 提供覆盖、加数字后缀或换 slug。
- 收集会话状态:运行 git status --short 查看未提交改动;梳理当前任务、工作流状态、活动产物路径、待决事项、进行中的改动、已排除的路径及证据、下一步具体动作;必要时读取 .turbo/improvements.md 并记录本交接接管的条目。
- 写入交接文件:用 Write 工具创建 .turbo/handoff/(即使位于当前工作目录之外的主检出,因 Bash 沙箱不允许在该处 shell 写入)。以 # Handoff: <Task Title> 开头,按会话形态组织内容,结尾写明下一步具体动作,保持紧凑。若某待决事项将超出本次会话状态,单独为其生成交接文件并在原文件中指向新路径。
- 确认:写入后删除本交接接管的 .turbo/improvements.md 条目,若无剩余则删除该文件;告知用户写入位置、删除的条目、被指向的拆分文件,并引用下一步陈述。
限制:在链接工作树内且写入被拒时,无法从此处持久化,需完整打印交接内容以便从可写入主检出的会话粘贴,并将其排除在工作树自身被 gitignore 的 .turbo/ 之外。资料未提供具体的收费、平台或效果信息。