Project Handoff Skill

A small, explicit-only Codex skill that writes a concise, evidence-backed HANDOFF.md before you clear a conversation or hand work to another agent.

It does not assume that the project is a Git repository or that it matches the current Codex workspace. When the destination is ambiguous, it asks before writing.

What it records

• current status and project structure;
• completed cases and their file locations;
• decisions, conventions, and reasons;
• unfinished work and the exact next step;
• pitfalls and failed approaches;
• validation status, risks, and open questions.

The skill only updates the confirmed HANDOFF.md. It never runs /clear for you.

Install

macOS and Linux

git clone https://github.com/cf-x/project-handoff-skill.git
mkdir -p ~/.codex/skills
cp -R project-handoff-skill/project-handoff ~/.codex/skills/

Windows PowerShell

git clone https://github.com/cf-x/project-handoff-skill.git
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills" | Out-Null
Copy-Item -Recurse -Force ".\project-handoff-skill\project-handoff" "$env:USERPROFILE\.codex\skills\project-handoff"

Restart Codex after installation if the skill does not appear immediately.

Use

Invoke it explicitly:

$project-handoff

Providing the destination is the most reliable form:

$project-handoff 目标目录：/path/to/project

After reviewing the generated file, run /clear yourself.

中文说明

这是一个仅手动调用的轻量 Codex Skill，用于在清空会话前生成项目交接笔记。它不会默认把 Git 根目录、Codex 工作区或当前目录当作项目根目录；目标有歧义时会先询问。调用方式：$project-handoff，也可以在后面直接附上目标目录。

License

MIT