用途:当用户需要一份可供继任者直接执行的交接提示、继续提示、下一智能体提示或会话转移文件时,使用该技能把当前工作打包成单份自包含的提示文件。默认输出为当前项目根目录下的 handoff-prompt.md;必须真正写出文件,而不是只在对话中展示草稿。
主要能力:从当前请求确认交接范围,支持用户指定的输出路径;多仓库任务放在最近公共工作区根目录,并标注每个仓库。收集最小的权威证据集,包括当前用户目标、意图、约束与明确决定,相关计划、进度笔记、结果、规格与日志,仓库实时状态、变更文件、分支与版本及 diff,以及支撑完成结论的测试、构建、渲染或命令结果,还有未解决问题、阻碍、风险与剩余工作。冲突时以当前用户明确指示决定意图与范围,以实时文件、版本控制状态和最新工具输出决定实现状态;旧笔记与对话声称仅作背景。
使用方式:填写 assets/handoff-prompt.template.md,替换所有占位符,删除空的可选行,使内容直接面向继任者;指向具体文件、命令、提交与证据,而非粘贴长源码或完整对话记录。移除密钥、令牌、凭据、个人数据、私有推理与无关历史,保留关键注意事项与权限边界。冷读一遍生成文件,确认首批动作可执行、每项完成声明都有可核查证据。仅在维护交接契约或适配新智能体运行时时读取 references/source-notes.md。
生成文件需包含:继任者角色与操作契约、主要目标与可观察的完成定义、意图与背景、范围内/范围外/需确认动作、当前状态与仓库或产物状态及重要决定、已完成工作及其证据、含路径与理由的产物地图、按依赖与影响排序的剩余工作、阻碍/未知/风险及解决方式、首一到三个可执行动作、验证要求与最终交付预期。仅在有歧义处使用已验证、推断、未知标签。
继续行为:把交接写成继续执行的指令而非回顾报告;让继任者先依据指定证据重新定位,保留已验证工作、避免重复已完成调查,在范围内继续而不为常规可逆操作询问,仅在破坏性或不可逆操作、重大范围变更或只有用户能提供的信息时暂停,报告前先验证结果;若需再次交接,更新或替换过时信息。已有交接提示时应先读取,保留仍有效的背景与用户决定,但替换过时状态与证据。
输出契约:返回生成提示的路径、整体继续状态及其编码的首个动作;仅当证据缺口影响继任者推进时提及。文件本身即交付物。限制与注意:不要倾倒对话,不要包含隐藏或私有推理,不要把下一步动作埋在背景之后,不要从环境文件、日志、认证输出或工具结果复制密钥,不要静默合并无关仓库或任务,保持单一提示为唯一事实来源,除非用户明确要求,否则不要创建镜像交接文件。