handoff

编写一份交接文档，总结当前对话，以便新的 Agent 能继续工作。将文档保存到操作系统临时目录，并明确解析路径（Windows 上使用 $env:TEMP；Linux / WSL / macOS 上使用 $TMPDIR，否则使用 /tmp）——不要保存到当前工作区。裸 /tmp/... 路径传给 Windows 原生工具（node、python、pi 的 write）时会被解析为 C:\tmp\...，因此在 Windows 上请传入解析后的绝对路径。

将文档路径作为可直接复制粘贴的 pi @ 提及形式回复给用户：前面加一个 @，后接使用正斜杠的绝对路径，并用双引号括起来；该行不得包含其他内容。示例：Windows 上为 @"C:/path/to/handoff-xyz.md"（%TEMP% 目录，例如 AppData/Local/Temp 下）；其他系统上为 @"/tmp/handoff-xyz.md"。

引号至关重要，不是装饰：在 pi 的提示词编辑器中，@ 会打开模糊文件补全弹窗，弹窗打开时按 Enter 会应用顶部建议，而不是发送内容。@ 后未加引号的路径或使用反斜杠的 Windows 路径会变成一个很长的补全词元，按 Enter 时弹窗会覆盖它。带引号的形式（@"..."）会在闭合引号处结束词元，因此不会打开弹窗，粘贴的路径也会原样保留。闭合引号必须是该行的最后一个字符——其后的 . 或 / 会启动新的补全前缀。

还要提供不带引号、使用正斜杠的路径（例如 C:/path/to/handoff-xyz.md），供命令行启动时使用：使用 pi @C:/path/to/handoff-xyz.md 启动 pi。Shell 会在 pi 解析 @file 参数前移除自身的引号，因此引号会导致路径解析失败。

文档开头应包含一段面向下一位 Agent 的交接说明，措辞必须要求其在开始任何工作前暂停并确认理解：

你是接手工作的 Agent。在做任何其他事情之前，请完整阅读本文档及其中引用的每一份材料。然后回复，说明你对以下四点的理解：目标、当前状态、后续步骤和风险。在用户确认之前，请勿开始工作。

在文档中加入“建议使用的技能”部分，说明下一位 Agent 应加载哪些技能（阅读每个 SKILL.md 并遵循其中要求）以及加载顺序。

不要重复其他材料（规范、计划、ADR、问题、提交、差异）中已有的内容。通过路径或 URL 引用这些材料。

对 API 密钥、密码或个人身份信息等敏感信息进行脱敏。

如果用户传入了参数，请将其视为对下一次会话重点的描述，并据此调整文档。