用途
fast-track-ai-handoff 用于在切换运行框架(harness)或模型、结束会话,或用户明确要求「handoff」时,捕获可移植的工作上下文,并保存到 fast-track-ai/handoffs 目录下。
主要能力
- 读取 fast-track-ai/INDEX.md 与当前对话,识别当前目标、已验证状态、未决决策与相关的持久产物。
- 逐字保留所有仍然生效的用户指令,置于 Active user instructions 之下;只省略机密或非必要个人数据,并说明省略内容,不对约束后续代理的指令做转述。
- 将「已验证完成的工作」与「下一步行动」分开记录。下一步行动以单个有序的 ## Next actions 列表呈现,第一项即第一个具体步骤。
- 记录阻塞项、风险、相关路径与观察到的命令结果,且不把推断当作观察陈述。
- 对规格、研究、引用、决策、评估、差异等持久文档,以路径引用代替内容复制。
使用方式
- 以当前 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 符合规范子集(第 1 行为 ---,其后某行 --- 闭合,期间每个非空行是一个 key: value 字段,键不重复)。若失败,修正新文档或停止并报告失败,不归档任何内容。
- 仅在上述校验通过后,按 captured 时刻(而非文件名字面顺序)对活动交接文档排序:最新三份保留在 fast-track-ai/handoffs/,更旧的逐份移入 fast-track-ai/handoffs/archive/,且仅当目标不存在时才移动;遇到冲突则停止并报告,不覆盖。
- 仅在归档完成后,使用 owner 副本运行 ../fast-track-ai-init/scripts/fast-track-ai-index.sh <target>,并报告任何校验错误。
路径解析
./ 路径与 ../fast-track-ai-* 同级路径从本技能安装目录解析;fast-track-ai/ 路径从目标仓库根目录解析。
限制
文档未提供该技能的更多平台、收费、价格或效果信息;相关事实暂未提供。