开发与工程 ✓ OpenAI · 官方 integration-testingremote-executiondockerwinebazelrust

远程执行器集成测试

为本地与远程执行环境验证 Codex 集成功能。

FollowSkills 评估 · FSRS-2.0
不推荐
50/ 100 五分制 2.5 / 5
信任安全16 / 25 · 3.2/5

技能明确限定远程执行测试场景,并说明 Docker、Wine、环境变量和 devbox 的数据流;但未说明敏感数据处理、权限边界、用户确认、回滚策略或远程主机信任模型,因此扣分。

可靠稳定8 / 20 · 2.0/5

文档提供了 codex_core、app-server、Docker、Wine 的具体命令和跳过宏,路径较清晰;但依赖、版本兼容性、失败诊断和异常输入处理说明不足,且静态审查不能证明可运行,因此扣分。

适用触发8 / 15 · 2.7/5

目标受众和适用场景明确,覆盖 Linux、Wine 及 macOS devbox;但要求 x86_64 Linux,未定义更多不适用情形、触发条件或中文环境支持,远程/devbox 访问可能受中国大陆网络影响,因此扣分。

规范维护8 / 15 · 2.7/5

结构简洁,包含测试夹具、跳过规则、Docker、Wine 和 devbox 示例,并有 Apache-2.0 许可及 OpenAI 来源;但缺少安装依赖、版本策略、变更记录、维护责任和故障排查说明,因此扣分。

有效结果6 / 15 · 2.0/5

文档直接给出可复制的 core 与 app-server 测试命令,能够覆盖主要任务;但结果格式、成功判据、替代方案和环境失败时的可用输出未充分说明,静态证据不足以确认实际效果,因此扣分。

证据核验4 / 10 · 2.0/5

文档包含具体命令、宏名称和脚本路径,仓库工作流还提及 Linux remote-env tests,具备有限可审计性;但没有本技能专属的可复现测试证据或独立交叉验证,且本次未执行,因此扣分。

证据充分度: 评估于 2026年7月19日 审查版本 678157acaa81
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
使用前请注意
  • 远程测试会启动 Docker/Wine 执行器,并可能通过 SSH 使用 devbox;使用前应明确主机权限、网络访问、凭据和测试数据边界。
  • 文档未提供依赖版本、失败排查、成功判据或 Windows/macOS 非目标环境的完整行为说明。
查看完整评分方法 →

它能做什么 & 适用场景

该技能指导针对远程执行器运行 Codex 集成测试,覆盖 app-server/exec-server 分离架构。它支持两种执行器方案:Linux Docker 容器和通过 Wine 运行的 Windows exec-server。测试默认要求 x86_64 Linux 主机;macOS 用户可以连接 devbox 执行测试。内容还说明了 core 与 app-server 测试夹具、配置相关的跳过宏,以及 Docker 和 Bazel 命令。

指导测试用例通过 TestCodexBuilder::build_with_auto_env() 或 TestAppServer::new_with_auto_env() 选择远程执行环境;为 app-server 线程发送自动环境启动请求;使用 skip_if_target_windows!、skip_if_wine_exec!、skip_if_host_windows!、skip_if_remote! 和 skip_if_no_remote_env! 按配置跳过测试;通过 scripts/test-remote-env.sh 启动和清理 Docker 远程环境;运行 codex-core 和 codex-app-server 集成测试;通过 Bazel 运行 Wine exec-server 测试;指导用户通过 SSH 使用 macOS devbox。

  1. 维护 codex-core 集成测试,并希望验证其在 Docker 远程执行器上的行为。
  2. 维护 app-server 测试,需要在 Linux 主机与远程 exec-server 分离的环境中运行测试。
  3. 开发跨 Windows 执行器功能,并通过 Wine 验证 Windows exec-server。
  4. 测试因主机、目标系统或远程执行器限制而需要按配置跳过的用例。
  5. 在 macOS 上开发 Codex,并通过包含 codex 检出的 devbox 运行远程测试。

优缺点一览

优点
  • 同时覆盖 Docker Linux exec-server 和 Wine Windows exec-server。
  • 提供 core、app-server 夹具和配置化跳过宏的具体用法。
  • 包含可直接复制的 Docker、Bazel 和 devbox 测试流程。
局限
  • 远程执行器测试目前要求 x86_64 Linux 主机。
  • Wine 测试依赖跨平台构建,因此只能在 Bazel 中运行。
  • 未提供独立技能的安装步骤,也未说明完整的环境版本要求。

如何安装

README 只说明如何安装整个 Codex CLI 集合,例如在 macOS 或 Linux 上运行 curl -fsSL https://chatgpt.com/codex/install.sh | sh,或使用 npm install -g @openai/codexbrew install --cask codex。未说明如何单独安装或注册 .codex/skills/remote-tests/SKILL.md

如何使用

在 codex 仓库中按需将测试夹具改为自动远程环境。Docker core 测试可运行:bash -c 'set -euo pipefail; unset CODEX_TEST_REMOTE_EXEC_SERVER_URL; source scripts/test-remote-env.sh; trap codex_remote_env_cleanup EXIT; cd codex-rs; just test -p codex-core --test all'。app-server 测试将包名替换为 codex-app-server。Wine 测试运行 bazel test //codex-rs/core:core-all-wine-exec-testbazel test //codex-rs/app-server:app-server-all-wine-exec-test

常见问题

这个技能适合普通单机测试吗?
不完全适合。它专门针对 app-server/exec-server 分离下的远程执行测试,并提供了 skip_if_remote! 来标记本地专用测试。
Docker 和 Wine 测试有什么区别?
Docker 使用 Linux exec-server;Wine 构建 Windows exec-server 并在 Wine 下运行,同时让 app-server 保持在 Linux 主机上。
macOS 用户能直接运行这些测试吗?
文档建议使用 devbox:通过 `applied_devbox ls` 查找名称包含 codex 的 devbox,再用 `ssh <devbox_name>` 连接。
测试失败时应该如何跳过?
应根据失败原因选择对应宏,例如 Windows 目标使用 skip_if_target_windows!,Wine runner 限制使用 skip_if_wine_exec!,远程专用或本地专用行为分别使用 skip_if_no_remote_env! 或 skip_if_remote!。

同仓库的其他 Skills

均来自 openai/codex

开发与工程 ✓ OpenAI · 官方

PR 持续看护助手

持续跟踪 GitHub PR 的审查、CI 与合并状态,并处理可安全修复的问题。

开发与工程 ✓ OpenAI · 官方

Codex GitHub Issue 摘要

按功能区域和时间窗口提炼 openai/codex 的近期缺陷与增强请求。

设计与前端 ✓ OpenAI · 官方

Codex 图像生成技能

在项目中生成、编辑并管理面向实际用途的位图图像资产。

开发与工程 ✓ OpenAI · 官方

Codex 插件构建器

为 Codex 创建、验证并维护符合规范的插件。

开发与工程 ✓ OpenAI · 官方

Codex 技能安装器

从精选列表或 GitHub 仓库安装 Codex 技能,降低技能配置与部署成本。

开发与工程 ✓ OpenAI · 官方

OpenAI 官方文档助手

为 OpenAI 产品、API、Codex 与模型迁移问题提供基于官方资料的当前指导。

开发与工程 ✓ OpenAI · 官方

Review Agent 代码审查技能

以缺陷为先审查代码变更,并输出可执行的问题清单。

开发与工程 ✓ OpenAI · 官方

Codex Pull Request 编辑器

根据变更动机与净变更,专业更新一个或多个 GitHub Pull Request 的标题和正文。

开发与工程 ✓ OpenAI · 官方

V8 版本更新助手

帮助维护 Codex 中固定的 V8 版本,并验证候选发布与构建失败原因。

开发与工程 ✓ OpenAI · 官方

变更规模审查指南

帮助开发者控制代码变更规模并规划可审查的分阶段交付。

开发与工程 ✓ OpenAI · 官方

Codex 路径类型指南

为 Codex Rust 代码选择兼容跨平台 URI 与本地路径的类型。

开发与工程 ✓ OpenAI · 官方

Skill Creator 技能创建指南

帮助你设计、编写、验证和迭代可复用的 Agent Skill。

自动化与运维 ✓ OpenAI · 官方

CI 变更推送助手

处理 CI 配置推送限制与临时审批流程

开发与工程 ✓ OpenAI · 官方

代码审查与测试指导

帮助编码代理为逻辑变更设计清晰、合适的测试。

开发与工程 ✓ OpenAI · 官方

Codex Bug 问题诊断助手

帮助判断 openai/codex GitHub 问题应如何验证、补充信息或解释其并非缺陷。

开发与工程 ✓ OpenAI · 官方

破坏性变更审查

系统检查外部集成接口中的破坏性变更,降低升级和兼容性风险。

开发与工程 ✓ OpenAI · 官方

Codex TUI 交互式测试指南

帮助开发者启动 Codex TUI 并以可调试的方式验证代码变更。

开发与工程 ✓ OpenAI · 官方

上下文治理规范

为编码代理建立可控、增量且有上限的模型上下文。

开发与工程 ✓ OpenAI · 官方

拉取请求代码审查

协调多代理完成拉取请求的最终代码审查,并汇总每个具体问题。

相关 Skills