mcpField
C
codex-background

codex-background

github.com/amelnagdyAgent 工作流2.5k531 次安装2 周前更新
代码仓库

关于 codex-background

面向 Codex 的辅助 Skill，通过 MCP 服务委派任务，并让请求保持等待直至委派完成。它规定注册委派 Skill 的配置、派发、等待、恢复与审查边界。

主要功能

  1. 01初始化委派 Skill 配置
  2. 02通过 delegate_run 派发任务
  3. 03等待期间不轮询状态
  4. 04处理中断等待与恢复
  5. 05区分适配器结果和产物审查

适用场景

  1. 01配置 Codex 后台委派
  2. 02通过委派执行获准任务
  3. 03中断后恢复等待
  4. 04落地更改前审查返回结果

MCP 相关

使用 MCP 服务的 delegate_run、delegate_wait 和 delegate_abort 工具来派发、等待或明确终止委派任务。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/amelnagdy/delegate-skills --skill codex-background

安装后在 Claude Code 中输入/codex-background确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
configuration.md
scripts/
bootstrap.mjs
bootstrap.test.mjs
linux-owner.c
server.mjs
server.test.mjs
supervisor.mjs
windows-job.cs
windows-job.ps1

详细介绍

Codex 后台委派

此支持技能会改变 Codex 的等待边界。所选委派技能仍负责任务说明、提供方参数、权限、结果解读、审核、门禁和落地。Claude 的后台 Bash 工作流保持不变。支持工具需单独安装，绝不会隐式成为 codex-delegate 的依赖项。详情请参阅：references/configuration.md。

首次使用 / 设置

如果 delegate_run 工具不可用，则表示设置尚未完成。告知用户，引导程序将更新 $CODEX_HOME/config.toml（默认路径为 ~/.codex/config.toml，且会先备份），并写入已安装 *-delegate 技能的注册表，然后运行：

node "<skill-dir>/scripts/bootstrap.mjs"

<skill-dir> 是此技能的安装目录（包含此 SKILL.md 的文件夹）。该程序会写入工作区之外，因此请申请 Codex 所需的批准或沙盒权限提升。报告其输出，然后请用户重启 Codex（或重新加载 MCP 服务）；之后这些工具才会出现。 如果引导程序失败，请报告失败情况。不要回退到通过 Shell 轮询。安装更多委派技能后，请再次运行。node "<skill-dir>/scripts/bootstrap.mjs" --check 可验证设置，且不会写入任何内容。

操作流程

  1. 遵循所选委派技能，准备完整的任务说明和已批准的工作区。 将任务说明写入 codex-background 目录下的 briefs/ 目录 （$CODEX_HOME/codex-background/briefs/<runId>.txt），并将其旁边的 runs/<runId> 用作 outputDirectory，或遵循服务端指令中指定的路径。如果沙盒无法写入该目录，也接受将任务说明放在已批准的工作区内。绝不接受任务说明提供的中继路径。
  2. 使用唯一的 runId、已注册的实施者 key、绝对路径的任务说明/工作区/outputDirectory、明确指定的 relayTimeoutSeconds 和提供方原生 relayArgs，恰好调用一次已配置 MCP 服务的 delegate_run。将通用参数放入结构化字段；提供方专用参数保持原样传递。恢复标识符须保持不透明。
  3. 保持该 MCP 请求处于待处理状态，直至完成。不要使用模型驱动的休眠、状态或日志轮询。不要将请求包装在会提前返回、并恢复推理以继续等待的工具运行器中。
  4. 分别审核返回的适配器结果和 resultText。后者是未经修改的 result.json 内容（只有非 UTF-8 字节才会使用 base64）；请按照所选技能解读。适配器完成表示中继以零退出码结束并生成了文件，并不意味着其报告已证明实现正确。审核 diff、重新运行门禁，并在现有授权范围内落地。

等待被中断后，请使用相同的 runId 调用 delegate_wait；绝不要重新派发任务。 MCP 取消操作会使等待者脱离，但已授权的任务仍会继续运行。只有在明确需要终止时，才使用 delegate_abort。服务端正常关闭时会中止其拥有的任务。 服务端崩溃后，未解决状态会返回 recovery_required；请检查保留的制品，并使用实施者自身的恢复工作流进行处理。绝不要接管或终止已持久化的 PID。

宿主配置的工具超时必须比中继超时长 30 秒以上。 服务端会验证声明的超时预算，但无法强制执行宿主的实际设置。测试夹具中的协议测试展示了单个待处理请求且没有中间消息，但这并不代表测得的 Codex Desktop token 用量，也不保证宿主等待时间没有上限。

评论

支持 Markdown