# Handoff

> Compact the current conversation into a handoff document for another agent to pick up.

- Skill: `yugasun/handoff` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yugasun/handoff`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yugasun/handoff/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: yugasun (https://skillmd.com/u/yugasun)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yugasun/handoff

---


Write a handoff so a fresh agent can continue.

## Before writing

1. Update `.scratch/<slug>/flow.state.yaml` — set `current_phase_id`, `current_issue`, `phases_done`, `gates_satisfied` as appropriate.
2. Then write handoff to the **OS temp directory** (not the workspace).

## Handoff body

- **Goal** — what the next session should accomplish
- **Decisions** — what is settled
- **Open questions** — what is not
- **Artifacts** — paths to PRDs, issues, ADRs, `flow.state.yaml` (reference, don't duplicate)
- **Suggested next** — `/aiops` or `/aiops 继续` with slug; or specific phase skill from journey

Redact secrets. If the user passed arguments, treat them as the next-session focus.