name: handoff
description: 当用户要求“撰写交接文档”、“交接这项工作”、“为他人打包这项工作”、“总结当前进展以便其他人/代理可以继续”或“在切换任务前创建背景文档”时，应使用此技能。
license: MIT + Commons Clause
metadata:
    version: 1.0.0
    author: borghei
    category: workflow
    domain: collaboration
    updated: 2026-06-22
    python-tools: handoff_context.py
    tags: [handoff, delegation, context, continuity, onboarding, async]

交接

概述

交接是一个自包含的上下文包，让不同的人——或一个全新的AI智能体——无需重新推导一切即可接手进行中的工作。大多数委托失败并非因为接手者能力不足，而是因为发起人脑海中的*上下文*从未被记录下来：已完成、半完成、为何放弃某条路径、下一步该做什么。此技能生成一份结构化的交接文档，准确捕捉这些信息，从而让接收者从第一次行动（而非第十次）就开始高效工作。

在本库的任意领域中使用它——工程任务、项目经理计划、合规审计、文档草稿——任何超出单次工作会话的工作场景。

使用场景

• 交接任务 — 你开始了某项工作，其他人（或未来的你）将完成它。
• 委托给智能体 — 将刚限定的任务交给缺乏你对话历史的子智能体或队友。
• 会话/班次结束 — 异步团队中，下一个人冷启动接手。
• 升级处理 — 将受阻项向上或横向传递，并附上已经尝试过的完整上下文。

先澄清

在编写交接前，确认以下输入。如果有任何未知或模糊，请询问——不要假设。

• [ ] 接收者 — 队友、全新的AI智能体或未来的你（决定需详述与可假设的背景程度）
• [ ] 目标 + 完成状态 — 该工作“完成”的样子（锚定“下一步”部分）
• [ ] 当前状态 — 已完成、进行中、尚未触及的事项（交接的核心）
• [ ] 约束与雷区 — 截止日期、已做出的决定、已尝试并放弃的路径（防止接收者重复死胡同）

停止规则：只询问对输出影响最大的2-3个问题。如果用户说“直接起草吧”，则继续执行，并在交接文档顶部列出你的假设。

快速开始

# Gather objective state (git branch, recent commits, changed/untracked files) to seed the handoff
python scripts/handoff_context.py --repo . --format markdown

1. 运行 handoff_context.py 以捕获客观状态（git状态、最近提交、已更改文件）。
2. 填写交接模板（assets/handoff_template.md）——以目标 + 当前状态开头，而非历史记录。
3. 使每个待办项可操作化：一个动词、一个文件/位置以及期望结果。
4. 列出已放弃的方法及*原因*——这是价值最高但最常被遗漏的部分。
5. 以唯一推荐的下一步行动结束，使接收者对第一步零歧义。

交接结构

反模式

• 叙述历史而非状态。 接收者需要“我们在哪”，而非时间顺序的日记。以当前状态开头。
• 模糊的下一步。 “继续集成”不可操作。“将 auth.py:42 连接到新令牌端点；期望返回 200 及 JWT”才是可操作的。
• 遗漏已放弃的路径。 如果不说明“我们尝试了 X，失败因为 Y”，接收者会浪费数小时重新发现。
• 倾倒整个对话。 交接是精选包，而非记录稿。总结并链接。
• 没有单一的起始行动。 始终以要做的第一件事结尾。

范围与限制

范围内： 为任何领域中的进行中工作生成结构化、自包含的交接文档；通过辅助脚本捕获客观仓库状态；使未完成工作对接收者可操作。

范围外： 向利益相关者汇报项目状态（project-management/execution/status-update-generator/）；事件事后分析（project-management/execution/post-mortem/）；新员工入职整个角色（hr-operations/，project-management/career/pm-onboarding/）。交接是关于一项正在进行的工作，而非一个人的全面适应。

参考

• assets/handoff_template.md — 填空式交接文档。
• scripts/handoff_context.py — 捕获 git 分支、最近提交以及已更改/未跟踪的文件作为种子块。