handoff
Write a handoff document so another session, host, or person can continue the work.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-13
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- handoff
- description
- Write a handoff document so another session, host, or person can continue the work.
- argument-hint
- [what the next session is for]
02 资源文件 1
- 参考文档agents/openai.yaml166 B
03 SKILL.md 正文
Handoff
Write a document that lets a fresh agent, another host, or a colleague continue this work. A handoff buys portability: use it when the work is moving to a new host (Claude Code to Codex or back), another directory or repo, another person, or a side task split off mid-phase. To keep going in the same place, the ask-harness skill's phase-boundary guide usually points to a cheaper move.
1. Write it
Write handoff-<slug>.md to the operating system's temp directory ($TMPDIR,
else /tmp; %TEMP% on Windows), not the workspace, and report its absolute
path. If the user said what the next session is for, write for that. Cover:
- Goal and destination: what this work is for, and what done looks like.
- Where it stands: what's finished, what's in flight, the branch, open PRs and their state.
- Decisions and why, including approaches tried and dropped.
- Next steps, in order, and anything blocked and on what.
- Gotchas you found that the next agent would otherwise rediscover.
- Suggested skills for the next agent to call through the Skill tool.
Point at what already exists (issues, PRs, specs, ADRs, commits, files) by URL or path rather than copying it in. Redact secrets, tokens, and personal data, since the document may become another agent's prompt. Done when the file exists, every next step names what it starts from, and nothing secret is in it.
2. Hand it over
Commit and push first if the next session starts in a new worktree or another checkout: it begins from the repository, not from this session's uncommitted changes.
-
Another person or host: give the path. To start a new session from it, the recipient runs
claude -- "$(cat <path>)"orcodex -- "$(cat <path>)"in the repository. -
A fresh background session, when the user asks for one. On Claude Code:
claude --bg --worktree "<slug>" --name "<descriptive name>" -- "$(cat <path>)"--worktreekeeps the new session's edits off this one's files, and"$(cat <path>)"passes the document without the shell running anything inside it. The session starts in the permission mode from the user's settings, and it can't answer a permission prompt until someone attaches; manage it withclaude agents,claude attach, andclaude logs.On Codex, run it non-interactively in a new managed worktree, as a background process:
codex exec --worktree -- "$(cat <path>)"It runs until the task is done, under the user's sandbox and approval settings.
Done when the user has the path, or the background session's id.
04 同仓库更多 Skills
teach
Teach yourself a topic over several sessions, with lessons, references, and a record of what you've learned.
svg-logo-designer
Generate SVG logos with multiple concepts, layouts, and color variations.
documentation-writer
Writes and revises human-facing documentation — READMEs, contributor and setup guides, reference pages, architecture notes, CLAUDE.md, and changelog entries. Covers picking the right document type for the question being asked, structuring for skimming, writing examples that actually run, and keeping docs from going stale. Use when creating or rewriting docs, when a README has drifted from the code, or when deciding where a piece of information belongs. For SKILL.md and agent files, use /skill-writer instead.
adhd-mode
Shapes every response for a reader with ADHD: the next action first, numbered steps, progress restated each turn, tangents held back, concrete time estimates, wins made visible. Stays on for the rest of the session until the reader says "stop adhd mode". On Claude Code, the harness-kit:adhd output style does the same without invoking this skill.
wait-what
That last message didn't land: re-explain it with the missing context.
to-questionnaire
Turn a decision you can't make alone into a questionnaire for the one person who can answer it, filled in async or together in a meeting.