SuperAPI AI 工具集

manual-interacting-with-codex-via-cli

测试与质量

查看项目

更新于 10-16 04:55

技能介绍

用途:这是一份通过真实 codex 命令进行手动验证与冒烟测试的工作流技能,适合在需要运行时证据依赖 Codex CLI 行为的场景中,配合手动测试使用。参考资料包括 CLI、命令参考、沙箱说明及开源仓库等官方链接。

主要能力与核心规则:要求显式选择沙箱与审批行为;当 Codex 仅作为辅助代理或用户特定复现时保留用户配置;测试 Codex 行为、配置、profiles、skills、plugins、MCP、hooks、rules、权限或沙箱语义时进行激进隔离;所有非交互运行使用 --cd 明确工作区;可信辅助、验证和编辑场景默认使用具备网络的 workspace-write;除非专门测试网络拒绝或不可信代码隔离,否则加上 -c sandbox_workspace_write.network_access=true;danger-full-access 与 --dangerously-bypass-approvals-and-sandbox 仅在外部加固的一次性环境或用户明确允许时使用,旧 --yolo 示例视为遗留指导;不要默认使用已废弃的 --full-auto,应使用显式的沙箱与审批标志;没有新的命令输出或 JSON 证据不得声称兼容。

使用方式:先检查本地可用性与已安装行为:type -a codex、codex --version、codex --help、codex exec --help、codex login status;若未安装则停止并报告缺少 CLI 引导,除非任务仅为文档研究。典型非交互命令:codex --sandbox workspace-write -c sandbox_workspace_write.network_access=true --ask-for-approval never exec --cd "$repo" --json "…"。复杂提示可用 prompt 文件或 stdin;输出证据用 --json 获取 JSONL 事件,用 --output-last-message 保存最终答案。隔离构建块涵盖工作目录、临时 CODEX_HOME、--ignore-user-config、--ignore-rules、--ephemeral、沙箱、审批、网络、内联配置、profiles、MCP 及输出证据等。

适用场景:辅助代理运行、通用运行检查、工具或文件效果检查、沙箱与审批检查、恢复与会话、skills/plugins/MCP/hooks/rules 检查、CI 与自动化、用户特定复现及严格行为/配置测试。

限制与注意事项:技能/插件/MCP 特性变化快,需对照已安装帮助与官方文档;注意标志位置(如 0.134.0 中审批策略是顶层标志,需放在 exec 之前);不得打印密钥、认证文件或配置;失败需按缺失引导、认证前置条件、不安全自主、交互死锁、配置污染、过度隔离、工作目录错误、Git 仓库守卫、网络混淆、假阳性、版本漂移等类别明确命名;需收集最小完整证据集并按场景、命令、版本、隔离层、沙箱、通过/失败、输出片段与失败类别进行报告。