用途:把用户请求的编码或实现工作委派给一个非交互式 Codex CLI 进程,并回传其结果。该技能明确不适用于 Codex 自身,只供外部编排框架(Claude Code、OpenCode)调用。
主要能力与用法:先确认操作在用户授权范围内。默认嵌套代理可在所选工作区内写入并使用网络,但不能越过该文件系统边界;只有编排方可以选用 danger-full-access,且仅在用户已授权、可信仓库中的 Git 写入工作流时使用。构造自包含提示词,保留全部要求:具体目标与交付物、已知仓库路径与上下文、约束(尤其是适用的 AGENTS.md 指令)、所需验证或验收标准,并要求代理检查仓库、完整实现、运行相称的检查,并在最终回复中总结改动与检查。不要编造产品需求或粘贴密钥;仅当缺失决策会实质改变结果时才询问用户。
通过 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,effort medium,sandbox 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,它会移除嵌套进程的文件系统沙箱,绝不要为从无关失败中恢复而启用。
输出与验证:stdout 只携带嵌套代理的最终消息,stderr 携带事件日志路径;完整事件流写入该日志文件而非调用方。仅在退出码非零、最终消息缺失,或第 5 步与其声明矛盾时才读取日志(先 tail -n 100),成功运行时不要整体载入上下文。退出后检查相关工作区改动并运行低成本检查以验证声明。失败时,在修正后的自包含重试提示词中列出已完成或未提交的工作,以便下次运行保留;读一遍组合后的提示词以发现截断或引号损坏。始终通过 runner 重试,不要重建原始 codex exec 命令(全局选项必须位于 exec 子命令之前)。最后报告结果、实质改动的文件与验证结果;明确报告非零退出或部分完成。
权限与限制:runner 默认使用 --sandbox workspace-write --ask-for-approval never 并允许网络访问,Codex 在仓库内自主工作,工作区外与 Git 元数据写入会失败而非提示。显式 danger-full-access 覆盖支持已授权的 Git 写入工作流,但会移除文件系统隔离。绝不要静默启用它、扩大任务范围、暴露凭据或执行无关的破坏性操作。