SuperAPI AI 工具集

codex-external-handoff

通用与其它

查看项目

更新于 10-16 08:10

技能介绍

用途:让外部 Agent 把正式任务交给本地 Codex,在保留后台执行顺畅的同时,提供可见 Thread 的监督、恢复与人工接管能力。需要跨项目检索、复杂研究、架构设计、代码审校、确定性工程、重要判断、继续追问或人工接管时,用本 Skill 创建持久 Thread;输出用完即丢、无需监督和追问的格式检查或简单提取,直接用 codex exec --ephemeral;Codex 已是当前宿主且只涉及内部多 Agent 分工时,用 Codex 原生团队能力。

主要能力:创建可见、命名、持久的 Codex Thread,并支持继续追问、状态查询、结果取回、取消和打开。

使用方式:从已安装 Skill 目录调用脚本。首次使用、Codex 升级或调用失败时先运行 doctor: HANDOFF="skills/codex-external-handoff/scripts/codex_external_handoff.py" python3 "$HANDOFF" doctor 正式任务先读 task-package.md;排查协议或兼容问题读 app-server-contract.md。

创建 Thread: python3 "$HANDOFF" ask
--title "架构设计与方案审查"
--task-file /absolute/path/to/task.md
--cwd "$PWD"
--model gpt-5.6-sol
--effort high ask 默认后台运行,需本轮等结果时加 --wait。

后台任务管理: python3 "$HANDOFF" status <JOB_ID_OR_THREAD_ID> python3 "$HANDOFF" result <JOB_ID_OR_THREAD_ID> python3 "$HANDOFF" continue <JOB_ID_OR_THREAD_ID> --task-file /path/to/follow-up.md python3 "$HANDOFF" cancel <JOB_ID_OR_THREAD_ID> python3 "$HANDOFF" open <JOB_ID_OR_THREAD_ID>

适用场景:复杂研究、跨项目取材、章节审校、确定性工程或重要决策需要持久线程和人工监督时。

限制:默认以 read-only + approvalPolicy=never 创建 Thread,仅任务包明确授权写入并列出目标路径时才传 --sandbox workspace-write;不提供 danger-full-access。同一 Thread 同一时刻只运行一个外部任务,并行判断需新建 Thread,不并发续问同一 Thread。外部 Agent 或最终集成者是 canonical 文件和状态的唯一写入者,Codex 只返回证据、产物和建议增量,不直接修改项目权威状态或绕过人工确认。任务正文启动前暂存、Worker 读取后删除;运行回执保存在本机 Codex 状态目录,不进入项目 Git。默认线程工作目录为当前项目根,跨项目检索仍在项目根 cwd 下声明只读来源范围。