AGENT SKILL

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

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>)" or codex -- "$(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>)"
    

    --worktree keeps 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 with claude agents, claude attach, and claude 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

dougborg
dougborg/harness-kit

teach

Teach yourself a topic over several sessions, with lessons, references, and a record of what you've learned.

教师与教育
★ 0
dougborg
dougborg/harness-kit

svg-logo-designer

Generate SVG logos with multiple concepts, layouts, and color variations.

图像与多媒体
★ 0
dougborg
dougborg/harness-kit

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.

内容创作者写作与文案
★ 0
dougborg
dougborg/harness-kit

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.

★ 0
dougborg
dougborg/harness-kit

wait-what

That last message didn't land: re-explain it with the missing context.

★ 0
dougborg
dougborg/harness-kit

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.

★ 0