用途:把当前对话压缩为一份自包含的交接文档,让新的智能体(新聊天、另一台机器、另一个 AI 客户端)能接着干活。改编自 mattpocock/skills(skills/productivity/handoff,MIT)。原则是引用持久产物,不复制它们。
触发:用户说“handoff”“compact session”“/handoff”“save context for continuation”“brief the next session”,或俄语等价说法如“сделай handoff”“передай контекст”“сохрани контекст для продолжения”。
参数:若参数像路径(以 .md 结尾或指向已存在目录)则作为目标路径;否则视为下一会话焦点,写入交接文档头部;两者都有时第一个词为路径,其余为焦点。无参数时用一行询问焦点,然后走默认路径。
写入位置:默认目录为项目根目录的 handoffs/,不存在则创建;默认文件名 handoff-<YYYYMMDD-HHMMSS>.md(本地时间)。用户给了路径就用它(直接覆盖不确认)。写前用 Read 读目标文件,预期的“不存在”错误正常,用于防止覆盖同名无关文件。若项目有 .gitignore 且未提及 handoffs/,可建议添加但不自动加。PowerShell 约定见 powershell-windows 技能。
文档结构:标题为 Handoff: <一行会话目标>;含 When、Branch / commit、Next session focus;Current State(1-3 句);Open Questions(无则省略);Files Changed In This Session(仅本次会话 diff,无则省略);Verification State(verification-checklist.md 各门禁通过/失败/跳过,最近 syntaxcheck / check_1c_code / review_1c_code 结果简述);Next Steps(1-5 条祈使句);What To Load Next Session(子智能体、按需规则、MCP 工具、斜杠命令);Links(只链接不复制内容)。
不要写:已有产物内容(PRD、OpenSpec proposal/design/tasks、ADR、ITS 页、commit、PR 描述);完整模块代码;密钥、令牌、密码、.dev.env、信息库连接串;长 MCP 输出转储。
写完后:告知用户文件绝对路径与行数;若会话产生可能进入 memory.md 或 1c-templates-mcp(remember)的修正/事实,单独列为长期记忆候选,不自动保存。
边界:handoff 是会话产物,不是配置也不是代码,不要对它跑 syntaxcheck / check_1c_code / review_1c_code;不替代 OpenSpec proposal,若任务需要而尚无 proposal,可建议 /opsx:propose 并在 handoff 中引用未来 ID;不重复 memory.md 与 recall 笔记;用正常语法书写,便于下一智能体无歧义阅读。