---
name: Handoff
slug: handoff-9
category: Writing
description: Handoff compresses a conversation into a sanitized transfer document for the next agent. Use it when a user explicitly asks for session handoff or invokes $handoff.
github: "https://github.com/feiskyer/codex-settings/tree/main/skills/handoff"
language: Python
stars: 237
forks: 33
install: "npx degit https://github.com/feiskyer/codex-settings/tree/main/skills/handoff ~/.claude/skills/handoff"
installs_to: ~/.claude/skills/handoff
source_path: skills/handoff/SKILL.md
collection_size: 11
category_size: 1109
collection_url: "https://dirskills.com/collections/feiskyer/codex-settings"
added: 2026-09-03T06:04:02.744Z
last_synced: 2026-09-03T06:04:02.744Z
canonical_url: "https://dirskills.com/skills/handoff-9"
---

# Handoff

Handoff compresses a conversation into a sanitized transfer document for the next agent. Use it when a user explicitly asks for session handoff or invokes $handoff.

**Install:**

```bash
npx degit https://github.com/feiskyer/codex-settings/tree/main/skills/handoff ~/.claude/skills/handoff
```

## README

撰写一份交接文档，总结当前对话内容，使全新的 agent 能够无缝继续工作。

## 输出位置

先解析当前平台的系统临时目录，再保存为 `handoff-YYYY-MM-DD-HHMM.md`（用实际时间戳替换）。优先使用平台 API，例如 Python 的 `tempfile.gettempdir()`；在 Unix 环境可使用 `$TMPDIR`，未设置时回退到 `/tmp`。生成后告知用户完整绝对路径。

## 文档结构

按以下结构组织交接文档：

1. **背景与目标** — 一句话概述当前任务
2. **已完成工作** — 带路径/URL 引用
3. **当前状态** — 进展到哪一步、卡在哪里
4. **待办事项** — 下一个 agent 需要做什么
5. **推荐技能** — 建议调用的 skill 列表
6. **关键上下文** — 环境、分支、配置等必要信息

## 规则

- 不要重复已存在于其他产物（规格文档、计划、ADR、issue、commit、diff）中的内容，改为通过路径或 URL 引用。
- 脱敏处理：删除 API key、密码、个人身份信息等敏感内容。
- 如果用户传入了参数，将其视为下一次会话的重点方向，据此调整文档内容。
- 如果当前对话极短（少于 3 轮实质交流），直接告知用户无需生成交接文档，除非用户坚持。