用途:把进行中或可恢复的对话转成执行交接,保护当前 Git 状态,并在运行时支持时启动新的 Codex 对话。它不是通用聊天摘要,只保留下一个智能体所需的操作上下文:当前目标、最新回顾检查点、工作区、决策、文件、验证证据、风险、约束和确切的下一步动作。
主要能力:触发场景包括新对话、换对话、交接、续接、上下文快满、对话丢失恢复、沉淀到项目文档等。交付模式先做能力检查,优先直接创建 Codex 线程;不可用时生成可粘贴提示或仅内联交接。工作流涵盖证据收集、恢复模式、上下文精简、持久化位置选择、项目 Markdown 同步扫描、Git 快照保护,以及生成紧凑的下一对话提示。
使用方式:在 Codex 中可用 tool_search 发现 create_thread 等线程工具;若直接创建可用且 Git 快照门通过,则在同一本地项目环境创建新线程并发送提示。否则提供手动粘贴提示并说明回退原因。交接文件默认写入 mydocs/handoff/YYYY-MM-DD_hh-mm_<task>_new-chat.md,无合适工作区时内联输出。
适用场景:与 SDD-RIPER、CodeMap、expcap、普通编码任务、本地对话恢复和项目级 Markdown 同步配合使用。
限制:不得编造工具可用性;不转储长日志、私密数据、凭据、令牌或 .env 内容;除非用户明确要求,不暴露原始记录;未包含验证证据不得声称任务完成。Git 保护在仓库中直接创建线程前是强制的,脏工作区需已验证的本地快照提交,远程推送可选。项目 MD 同步扫描每次必做,写入则视条件而定。交接默认约 120 行以内,下一对话提示约 60 行以内。默认使用中文,除非项目或用户使用其他语言。需区分已确认、推断和未知事实,并给出文件、规格、代码地图、测试和验证证据的精确路径。