mcpField
C
codex-subagent

codex-subagent

github.com/beeltecAgent 工作流238 次安装11 周前更新
代码仓库

关于 codex-subagent

codex-subagent 是供 Claude Code、OpenCode 等外部 harness 使用的技能，可将任务委派给非交互式 Codex CLI 进程。它规定了包含权限控制、结果核验和状态汇报的执行流程。

主要功能

  1. 01将任务委派给 Codex CLI
  2. 02构建包含约束的完整提示词
  3. 03默认使用 workspace-write 沙箱
  4. 04核验更改和所报告的检查
  5. 05汇报完成情况与部分失败

适用场景

  1. 01从 Claude Code 委派仓库工作
  2. 02通过 OpenCode 运行 Codex CLI 任务
  3. 03核验并汇报委派的实现工作

安装

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

$npx skills add https://github.com/beeltec/skills --skill codex-subagent

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

附带文件agents/openai.yamlscripts/run-codex-subagent.sh

详细介绍

Codex 子 Agent

重要

请勿从 Codex 调用此技能。此技能仅供外部运行环境（Claude Code、OpenCode）委派工作给 Codex CLI 使用。

将请求的工作委派给非交互式 Codex CLI 进程，并转达其结果。

工作流

  1. 确认操作属于用户授权范围。默认情况下，嵌套 Agent 可以在所选工作区内写入并使用网络，但不能越过该文件系统边界。只有编排器可以选择 danger-full-access，且仅限用户已授权在可信仓库中执行 Git 写入工作流的情况。

  2. 构建一份自包含的提示词，保留所有要求：具体目标和交付内容；已知的仓库路径和上下文；约束，尤其是适用的 AGENTS.md 指令；所需的验证或验收标准；以及要求检查仓库、完整实施、运行适度检查，并在最终回复中总结变更和检查结果的指示。不要编造产品要求或粘贴机密信息；只有在缺失的决策会实质性改变结果时才询问用户。

  3. 将提示词通过 stdin 管道传入 scripts/run-codex-subagent.sh。必须通过运行环境的托管后台任务模式运行——前台调用会在执行工具的固定超时时间被中止，而使用 & 会创建不受托管的进程。不要轮询；等待运行环境报告完成，在任务完成前不要开始依赖此任务的工作。

    printf '%s\n' "$prompt" | /absolute/path/to/codex-subagent/scripts/run-codex-subagent.sh --model gpt-5.6-sol --effort high /path/to/repository

    默认值：模型为 gpt-5.6-sol，工作力度为 medium，沙箱为 workspace-write。可分别通过 --model、--effort（none|minimal|low|medium|high|xhigh|max|ultra；不同模型支持的选项可能不同）和 --sandbox（workspace-write 或 danger-full-access）覆盖默认值。

    workspace-write 会有意将 .git 设为只读。如果委派的工作流必须创建分支、暂存或提交，且用户已在可信仓库中授权此类操作，请使用 --sandbox danger-full-access。这会移除嵌套进程的文件系统沙箱；切勿为了应对无关故障而启用它。

  4. 阅读输出：stdout 仅包含嵌套 Agent 的最终消息；stderr 包含事件日志路径。完整事件流会写入该日志文件，而不会发送给调用方。仅当退出码非零、缺少最终消息，或第 5 步的结果与其声明矛盾时，才读取日志（从 tail -n 100 开始）；运行成功时，切勿将整个日志加载到上下文中。

  5. 退出后，检查相关工作区变更，并运行简单检查以验证嵌套 Agent 的声明。失败时，在一份经过修正且自包含的重试提示词中列出已完成或未提交的工作，以便下次运行保留这些内容；仔细检查一次组装好的提示词，确认没有截断或引号损坏。始终通过运行器重试——切勿重构原始的 codex exec 命令（全局选项必须放在 exec 子命令之前）。

  6. 报告结果、重要变更文件及验证结果；明确说明非零退出码或部分完成的情况。

权限

运行器默认使用 --sandbox workspace-write --ask-for-approval never，并启用网络访问：Codex 可在仓库内自主工作，而仓库外写入和 Git 元数据写入会直接失败，不会触发询问。显式使用 danger-full-access 可支持已授权的 Git 写入工作流，但会移除文件系统隔离。切勿在未说明的情况下启用此选项、扩大任务范围、暴露凭据或执行无关的破坏性操作。

评论

支持 Markdown