Prepare Handoff

中文说明

Prepare Handoff is an AI agent handoff skill for creating project-scoped handoff bundles. It is packaged in a Codex-compatible Skill format, but the core workflow can be adapted to any AI agent environment that can read Markdown instructions and run local helper scripts.

It is useful when one or more AI work windows need to transfer state to a later window, or when a single window needs a durable checkpoint before continuing later.

Features

• Creates single-window checkpoints and multi-window handoff sessions.
• Keeps different projects isolated under separate project keys.
• Lets multiple windows contribute to the same active project session.
• Maintains registry.json, project .active.json, index.md, resume-prompt.md, state.json, and per-window handoff files.
• Collects objective workspace state such as git branch, git head, git status --short, and changed files.
• Separates objective state collection from human/agent judgment, so the next agent can verify before continuing.

Repository Layout

skills/
  prepare-handoff/
    SKILL.md
    agents/
      openai.yaml
    references/
      handoff-template.md
      resume-template.md
    scripts/
      handoff_state.py

Use With Codex-Compatible Skill Runtimes

Copy skills/prepare-handoff into your local skills directory:

Copy-Item -Recurse .\skills\prepare-handoff "$env:USERPROFILE\.codex\skills\prepare-handoff"

Then restart or open a new AI work window so the skill list is refreshed.

Use With Other AI Agents

Other agents can use the same workflow by reading:

• skills/prepare-handoff/SKILL.md
• skills/prepare-handoff/references/handoff-template.md
• skills/prepare-handoff/references/resume-template.md

The helper script can be run directly:

python skills/prepare-handoff/scripts/handoff_state.py --init --project my-project --window main

By default, handoff bundles are written under work/handoffs in the current project.

Example Prompts

Create a handoff for the web-dashboard project.

Start a new handoff for the codex-plugin project.

Resume from the web-dashboard handoff.

License

MIT