用途:把一项有界任务移交给一个新建的原生 Codex 线程,结束当前回合,并验证工作线程的回调消息。只有用户指明任务并请求开启任务时才获得授权,否则不得创建任务。
前置条件:缺少任一条件就说明并停止,不得创建孤立任务,也不得承诺无法兑现的唤醒。需要 create_thread 与 send_message_to_thread 已暴露,且 CODEX_THREAD_ID 非空。
模型与投入度:严格使用用户所选,两者独立处理;未指定模型就省略 model 字段,未指定投入度就省略 thinking 字段,各自回退到默认配置。模型不可用时应说明并询问,不得替换。
工作区:涉及文件时用 list_projects 定位目标;遵循用户指定的分支、工作树状态或已保存检出,未指定时 Git 项目默认用 worktree,否则用本地。默认 worktree 从默认分支开始且不含未提交改动。
移交简报:工作线程不继承本对话任何内容,需携带完整意图、最小上下文、所属文件与范围、确切路径与产物、工作区选择、所需检查、授权边界,以及来源线程 ID 和主机。同时嵌入要求:只做有界任务、不再创建任务;完成后向来源发送一条消息,含线程 ID、主机、结果、实际工作区与产物路径、检查及结果、限制;无法继续则发送阻塞消息,之后结束回合。
派发:调用 create_thread,返回就绪的 threadId 与 hostId 或待定的 clientThreadId;不得把 clientThreadId 传给读取、发送或等待工具。若待定,最多做一次 list_threads 检查,仅在已知就绪 ID 后用即时 wait_threads 快照;仍待定则报告并结束。
回调:若回调在本回合结束前到达,立即处理,不得人为延迟。以就绪 ID 验证发送方,否则用 read_thread 比对创建提示与移交内容。需在实际工作区中验证结果,报告声明与已验证的成功。不做盲目合并,不进行确认往复;授权范围内的修正可通过 send_message_to_thread 处理。重复回调不重复内容,也不新建工作线程。
限制:具体模型选项、错误处理细节及定价等资料未提供。