SuperAPI AI 工具集

codex-handoff

智能体与模型

查看项目

更新于 10-16 03:16

技能介绍

用途:Codex Handoff 用于在当前会话内编排只读研究,或调度 1 至 8 个 Codex 智能体来规划并实现所请求的工作。它与 task-handoff 不同:后者为全新的独立会话写出决策完整的文件,适合工作稍后或异地继续;本技能适合现在就实现请求的工作。

主要能力:支持研究型任务(仅收集证据与发现,不做仓库改动)与实现型任务(先进入 Plan Phase,再直接启动,无需单独的用户批准步骤)。父会话负责决策、最终计划与编排;研究智能体只收集证据,绝不编辑文件或返回计划;实现智能体按最终计划检查、编辑并验证各自分配的部分,不重新设计。研究智能体最多 3 个(R1-R3),实现智能体最多 8 个,使用最小有效团队。

使用方式:仅在显式调用后运行。先检查可调用的编排工具来选择宿主适配器:若存在 spawn_agent、wait_agent、send_message、followup_task,则读取 references/codex-cli-host.md;否则若存在 Claude Code 的 Agent 与 Bash 工具,则读取 references/claude-code-host.md;两者都没有则报兼容性错误。必须只使用一个适配器,不得混用。任务可用 $ARGUMENTS 指定,否则使用当前用户请求。

适用场景:需要将实现工作拆分给多个智能体并行或按依赖波次执行;需要先做只读调查再规划;需要与其它技能组合(如 $fresh-eyes-sweep)时由本技能负责委派机制。

限制:Codex 宿主必须原生支持多智能体,绝不回退到嵌套 Codex CLI 进程。实现智能体不得提交、推送、部署或扩大范围,父会话在协调后提交。不得添加计划未明确要求的验证机制。命名草稿无授权且七天后过期。智能体无法加载技能,需内联具体指令。若宿主无法启动用户指定的模型,应报告不兼容并询问后再回退。