用途
ft-handoff 用于在需要切换执行框架（harness）或模型、结束一次会话，或用户明确要求“handoff”时，捕获一份可直接移植的工作上下文文档，存放于 fast-track-ai/handoffs 之下。它的目标是把当前会话中真正需要延续的信息固化下来，使下一个接手者能够准确了解目标、状态与下一步动作。
主要能力
该技能会读取 fast-track-ai/INDEX.md 与当前对话，识别以下内容：活动的目标、已验证的状态、尚未解决的决策，以及相关的持久化产物。它要求将每条活动的用户指令原样保留在 Active user instructions 下，仅省略机密或不必要的个人数据，并披露所做的省略；对于措辞会约束下一个代理的指令，不做改写。它把已验证完成的工作与后续行动分开，并在一份有序的 ## Next actions 列表中给出后续动作，其中第一项就是第一个具体步骤。它还会记录阻塞项、风险、相关路径和观察到的命令结果，并明确要求不把推断当作观察来呈现。对于规格、研究、参考资料、决策、评估、diff 及其他持久化文档，采用按路径引用的方式，而不复制其内容。
使用方式
交接文档的最终路径由当前 UTC 时刻计算得出，形如 fast-track-ai/handoffs/YYYY-MM-DD-HHmmssZ-<slug>.md。写入前会检查该路径在活动目录和 fast-track-ai/handoffs/archive/ 中是否都不存在；若发生冲突，则停止并报告，而不是覆盖。文档依据 ./assets/handoff.md 直接写入该路径，并把 captured 字段设为与文件名相同的 UTC 时刻，格式为 YYYY-MM-DDTHH:MM:SSZ，不使用生命周期状态字段。
写入后会先校验这份新交接文档，再触碰任何其他交接文档：确认 ./assets/handoff.md 中的每个标题都出现，captured 符合 YYYY-MM-DDTHH:MM:SSZ 形式且与文件名时刻一致，frontmatter 符合规范子集（第一行为 ---，之后有 --- 行闭合，其间每个非空行是一个 key: value 字段，且没有重复的键）。校验失败时，修复新交接文档或停止并报告失败，不做任何归档。
仅当上述校验通过后，才按 captured 时刻（而非文件名字符串）对活动交接文档排序，保留最新三份于 fast-track-ai/handoffs/，并将其余较旧的交接文档移动到 fast-track-ai/handoffs/archive/，且仅在目标尚不存在时才移动；遇到冲突则停止并报告，不覆盖。归档完成之后，再使用 owner 副本运行 ../ft-init/scripts/fast-track-ai-index.sh <target>，并报告任何验证错误。
路径解析方面：./ 路径与 ../ft-* 同级路径从该技能自身的安装目录解析，fast-track-ai/ 路径从目标仓库根目录解析。
适用场景
适用于需要跨执行框架或跨模型延续工作的场合、会话结束前的状态固化，以及用户明确要求交接时。它以可移植、可引用的方式保存工作上下文，便于下一个接手者按图索骥。
限制
该技能仅保存工作上下文与交接文档，不执行其他业务操作。关于其收费、价格、平台支持情况与具体效果，资料中暂未提供。