用途:handoff 用于把一个正在进行的会话中某一具体方面整理成交接文档,让完全没有上下文的新智能体能够接着做。触发方式包括用户说“handoff”“summarize for handoff”等;用户提示需指明要交接的方面,不明确时应先询问。
主要能力:针对指定方面,摘要覆盖目标、当前状态、关键决策、待解问题、下一步行动、相关文件六个部分;没有实质内容的部分可省略。写作面向“冷读者”,要求精确写明文件路径、分支名和术语。
使用方式:摘要写入 handoff.md。输出位置规则为:用户提示中指定路径则使用该路径;项目配置(如 AGENTS.md、openspec 配置或类似约定)指定变更目录则写到那里;否则从上下文推导相关变更 slug(正在处理的变更,或由主题转化的 kebab-case slug),写入 ~/.agent-skills/changes/<slug>/handoff.md。不需要让用户确认位置,直接写入解析后的路径。
适用场景:需要把当前会话的某一部分移交给另一个智能体继续处理时,例如任务中断、换会话、并行分工。
限制与约束:只依据当前上下文写作,除用户明确要求外,不得探索文件、执行搜索或做额外调研;不得总结整段对话;不得编造上下文中未出现的细节;不得为待解问题规定解决方案,只陈述问题;模板包含标题与 Objective、Current State、Key Decisions、Open Questions、Next Steps、Relevant Files 等小节,关键决策需附简要理由。