Context Handoff Skill

一个用于 Codex 的轻量上下文交接 skill：帮助你在长任务、换对话、继续任务时，生成和读取精简、可执行、不会撑爆上下文窗口的任务交接信息。

中文

适合什么时候用

• 你想让 Codex 输出、保存、压缩、沉淀或交接当前任务上下文。
• 你想让 Codex 读取已有上下文并继续工作。
• 你想避免新对话一上来就扫描整个项目、日志或历史文档。
• 你想把当前任务状态固定在少数几个稳定入口文件里。

它做什么

• 输出简洁 handoff，而不是完整聊天记录。
• 优先更新当前上下文文件，例如 01-CURRENT-TASK.md 和 02-CURRENT-DECISIONS.md。
• 约束上下文目录根部，只保留稳定入口文件。
• 历史快照进入 archive/stages/ 或 archive/handoffs/。
• 读取上下文时先看文件列表和入口文件，避免无差别读取所有 Markdown、JSON、日志和阶段文件。

安装

把本仓库克隆到 Codex skills 目录：

mkdir -p ~/.codex/skills
git clone https://github.com/ggboss/codex-context-handoff-skill.git ~/.codex/skills/context-handoff

如果你已经有同名目录，可以先备份或删除旧目录后再克隆。

常用触发语

• 输出上下文
• 生成上下文
• 沉淀上下文
• 交接上下文
• 阅读上下文
• 读取上下文
• 接上上下文
• 继续任务
• 换对话继续

推荐上下文目录结构

context-folder/
  README.md
  00-READ-FIRST.md
  01-CURRENT-TASK.md
  02-CURRENT-DECISIONS.md
  archive/
    stages/
    handoffs/
  tools/
    scripts/
    outputs-archive/

设计原则

• 少读：先读入口文件，只在必要时深入历史。
• 少写：当前状态写到固定文件，历史细节归档。
• 可继续：交接内容包含目标、当前状态、决策、验证、关键文件和下一步。
• 可判断：不确定信息用 confirmed、inferred 或 needs check 标记。

English

What This Is For

This Codex skill creates and reads compact task handoffs for long-running work. It is meant for continuing a task in a new conversation without dumping transcripts, logs, large diffs, or every project file into context.

When To Use It

• You want Codex to output, save, summarize, compress, or hand off task context.
• You want Codex to read an existing context folder and resume work.
• You want future agents to start from a small set of entry files.
• You want to keep generated logs, snapshots, and tool outputs out of the context root.

What It Enforces

• Concise handoffs instead of full transcripts.
• Current state in stable files such as 01-CURRENT-TASK.md and 02-CURRENT-DECISIONS.md.
• Historical snapshots under archive/stages/ or archive/handoffs/.
• Layered reading: list files first, read entry files first, and only open archives when needed.
• Context-budget discipline for logs, JSON, command output, and broad searches.

Installation

Clone this repository into your Codex skills directory:

mkdir -p ~/.codex/skills
git clone https://github.com/ggboss/codex-context-handoff-skill.git ~/.codex/skills/context-handoff

If a context-handoff directory already exists, back it up or remove it before cloning.

Example Prompts

• Output context
• Save a handoff for this task
• Read the context and continue
• Continue from the existing handoff
• 生成上下文
• 读取上下文
• 换对话继续

Recommended Context Folder

context-folder/
  README.md
  00-READ-FIRST.md
  01-CURRENT-TASK.md
  02-CURRENT-DECISIONS.md
  archive/
    stages/
    handoffs/
  tools/
    scripts/
    outputs-archive/

License

MIT