Codex TUI 交互式测试指南
帮助开发者启动 Codex TUI 并以可调试的方式验证代码变更。
技能要求交互启动、启用 trace 日志并写入指定临时目录，提供了一定的调试可见性；但未说明权限范围、敏感数据和日志内容处理、网络或外部副作用、用户确认、隔离边界或回滚方式，因此扣分。
步骤较短且相互一致，明确了 just codex、日志参数和分开发送文本与 Enter；但依赖 just、Codex TUI 和可用终端环境，未说明异常输入、启动失败、参数错误或环境缺失时的诊断和恢复，因此静态评估不超过10分并扣分。
目标场景是交互式验证 Codex TUI 变更，受众和基本触发场景清楚；但没有声明不适用范围、输入输出边界、平台要求或中文交互支持，也没有证据证明适合中国大陆网络环境，因此扣分。
具备基本名称、描述和少量操作要点，且仓库提供 Apache-2.0 许可及 OpenAI 归属；但缺少安装前提、参数说明、示例、FAQ、已知限制、版本与变更记录、维护责任和更新路径，因此扣分。
按说明可帮助用户启动 TUI、保留 trace 日志并进行程序化输入，这覆盖了核心验证动作；但没有定义预期结果、检查清单、输出格式或完整故障闭环，结果仍需较多人工判断，因此只给有限分数。
技能文本本身可审计，仓库还包含相关测试和 CI 背景材料；但这些材料并未证明该技能指令被实际执行或覆盖其关键路径，也没有第三方执行记录，因此静态证据有限并扣分。
- 执行前应确认 TUI 运行权限、日志目录位置及日志中是否可能包含提示词、代码或凭据等敏感信息。
- 该技能未定义失败判定、预期输出或清理回滚步骤，不能仅凭成功启动推断变更已被正确验证。
- 未提供中文交互和中国大陆网络可达性的证据；若 Codex 登录或服务依赖海外连接，实际可用性可能受限。
它能做什么 & 适用场景
这是 Codex 仓库中的一个测试辅助技能，专门指导如何交互式测试 Codex TUI。它要求以交互模式启动程序，并始终启用 trace 级别日志。测试时需要把日志写入指定临时目录，并遵循分开发送测试文本和 Enter 键的操作顺序。该技能适合已经具备 Codex CLI 开发环境、需要复现或验证终端界面行为的开发者。
指导用户使用 just codex 启动 Codex TUI，设置 RUST_LOG="trace"，通过 -c log_dir=<some_temp_dir> 指定日志目录，并在程序测试中先写入文本、再单独写入 Enter。
- Codex CLI 开发者修改 TUI 后，需要交互式验证界面行为。
- 测试人员需要复现终端交互问题，并保留 trace 级别日志供调试。
- 开发者通过程序化输入测试消息时，需要避免将文本和 Enter 合并发送。
- 维护 Codex 仓库的人员需要使用项目既有的 `just codex` 目标运行 TUI。
优缺点一览
- 提供了明确的 TUI 启动方式和日志配置要求。
- 强调交互启动和分开发送 Enter，有助于保持测试行为一致。
- 通过指定日志目录便于定位和保留调试信息。
- 仅覆盖 Codex TUI 的测试指导，不是通用 TUI 测试框架。
- 依赖 `just codex` 目标和 Codex CLI 环境。
- 未提供自动化测试套件、断言方式或失败诊断流程。
- 未说明 Windows 或其他平台上的测试步骤。
如何安装
将技能目录放置在 Agent Skills 客户端识别的技能目录中，目录内包含 .codex/skills/test-tui/SKILL.md。源材料未说明通用客户端的具体安装路径，也未提供该技能的独立安装命令。运行测试前还需要可用的 Codex CLI 和仓库中的 just codex 目标。
如何使用
在具备 Codex 仓库开发环境的终端中运行 RUST_LOG="trace" just codex -c log_dir=<some_temp_dir>。开始交互测试；如果程序化发送测试消息，先单独写入消息文本，再进行一次独立的 Enter 写入。具体测试提示词由测试场景决定，源材料未规定固定示例。