Project Handoff Skill

A Codex skill for moving long-running project work into a fresh task without losing the global roadmap, hard constraints, evidence, or approval boundaries.

What it does

• Silently audits recoverability after the first observed context compaction.
• Asks before migration after the second compaction, and asks immediately after the third.
• Builds and validates a compact, evidence-backed Markdown handoff packet.
• Creates a separate clean task instead of forking completed conversation history.
• Reuses the previous task title when it can identify that title safely.
• Makes the new task ask exactly: 接下来最重要的工作是什么？
• Keeps the old task as an audit trail unless the user explicitly asks to archive it.
• Requires separate confirmation for destructive, external, or otherwise protected actions.

Install

Ask Codex:

Use $skill-installer to install the project-handoff skill from
https://github.com/somnus-J-307/project-handoff-skill/tree/main/skills/project-handoff

Or run the bundled installer directly:

python "$HOME/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo somnus-J-307/project-handoff-skill \
  --path skills/project-handoff

The skill becomes available on the next Codex turn.

Use

Invoke $project-handoff when you want to checkpoint, migrate, resume, or refresh a long-running project. Migration never creates a new task without current explicit consent.

The handoff packet records the objective, global plan, focus-confirmation gate, constraints, approval boundaries, evidence, changes, validation results, risks, and a bootstrap prompt for the new task.

Repository layout

skills/project-handoff/
├── SKILL.md
├── agents/openai.yaml
├── references/handoff-template.md
└── scripts/validate_handoff.py

Validate a saved packet with:

python skills/project-handoff/scripts/validate_handoff.py path/to/handoff.md

License

MIT