orocoa

Handoff — Codex 本地项目对话交接 Skill

Handoff 是面向 macOS Codex 桌面端的对话交接 Skill:在同一个已保存 Local 项目中整理必要上下文,再创建后续对话继续工作。当前公开源码标记为 Alpha。

什么时候交接

当现有对话已经很长、下一阶段需要保留目标和决定时,可以明确调用交接。记录包含目标、最近决定、已完成与待办、约束、文件路径和证据。

原始文件留在原处,后续对话按需读取。它不会让所有历史细节自动变得完整无误,也不保证新对话没有理解偏差。

在已保存的本地项目中使用

需要 macOS Codex 桌面端、Python 3.9+、已保存的 Local 项目,以及所需的文件写入和项目/对话工具权限。按公开 README 安装完整 handoff 目录。

正式使用时在当前项目中明确选择交接 Skill,或输入其公开调用命令。普通提及、维护说明和技能测试不会自动触发交接;本页仅介绍使用方式,不执行交接。

确认真实结果

交接会核对项目,保存记录,尝试创建后续对话,并返回对话链接与实际启动状态。创建失败或结果不明确时,应保留记录并说明原因,不能盲目重复创建。

接收方核对现有项目文件和未完成工作后继续。仍需连续推敲细节时,可以留在原对话,不必为了交接而丢失有用上下文。

当前公开边界

这是 Alpha 源码,具体构建以仓库 CHANGELOG 为准。摘要质量依赖来源对话和整理者,没有测量相对于其他方法的完整耗时优势。

Skill 本身不增加另一层审批,也不改变权限。它依赖当前桌面端和宿主工具,不应被描述成所有 Agent 或客户端都已验证可用。

项目入口