handoff

SkillDocs & knowledge

Use only when the user explicitly invokes `$handoff` or explicitly requests a session handoff document. Compresses the current conversation into a sanitized, actionable handoff document for the next agent to continue the work; do not trigger automatically.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the handoff skill

What this skill tells your AI

The instructions your AI receives, as published by feiskyer/codex-settings in skills/handoff/SKILL.md and read by ahel’s review.

撰写一份交接文档,总结当前对话内容,使全新的 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 轮实质交流),直接告知用户无需生成交接文档,除非用户坚持。

Signals

GitHub stars
236
Forks
33
Last commit
Aug 2026
Hacker News mentions
20
Advanced
Catalog kind
skill
Gateway key
handoff-3
Source
github.com/feiskyer/codex-settings