Agent Skills
返回列表
💻

Codex 运行指南

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/softaworks-agent-toolkit-codex。

技能介绍

要解决什么问题

当你的助手需要通过 Codex CLI 执行代码分析、改写或自动化任务时,若缺少统一约定,很容易出现沙箱选错、codex exec 参数漏填、思考 token 刷屏 stderr,或续开会话时把模型/推理强度配乱等问题。本技能把 RealQ 侧的运维经验收敛成一条可重复的工作流,让每次调用都对齐同一套默认与安全边界。

技能如何工作

核心流程大致是:默认选用 gpt-5.2,用 AskUserQuestion 向用户确认推理强度(xhigh / high / medium / low),再按任务类型选沙箱——只读审阅用 --sandbox read-only,本地改码用 workspace-write 并常配合 --full-auto,需要外网或更大权限时才上 danger-full-access。

组装命令时会固定带上 --skip-git-repo-check;常规执行默认在命令末尾加 2>/dev/null,避免思考过程占满终端。续跑旧会话时走 echo "prompt" | codex exec --skip-git-repo-check resume --last,且不在 resume 里擅自加配置旗标,除非用户明确要求改模型或推理强度。执行结束后应汇总 stdout/stderr,并提示用户可说「codex resume」继续同一会话。

技能内还提供 Quick Reference 表(场景 → 沙箱 → 关键参数)和 Model Options(如 gpt-5.2-max、gpt-5.2-mini 的成本与上下文窗口),并在使用 --full-auto、danger-full-access 等高风险选项前要求先征得用户同意。

适用边界与注意点

  • 需要 Codex CLI v0.57.0+ 才完整支持 GPT-5.2;可用 codex --version 自检。
  • codex exec 非零退出时应停止并上报,不要静默重试。
  • 知识截点等模型能力以技能文档中的说明为准;复杂任务才值得上 xhigh,简单格式化用 low 即可控成本。

使用场景

  • 在只读沙箱里让 Codex 通读本地仓库并输出安全审查结论,且不把思考过程刷满终端
  • 需要改 workspace 内多文件时,用 workspace-write 与 full-auto 跑一轮 codex exec 并汇总改动结果
  • 上次分析到一半被打断,通过 resume --last 用 stdin 续写同一模型与推理强度下的后续任务
  • codex 返回非零或带警告时,先停下来用 AskUserQuestion 确认是否重试或放宽沙箱

适合人员

  • 日常用助手代跑 Codex 的工程师,希望沙箱、full-auto 与危险权限每次都有明确确认
  • 负责 SWE-bench 级重构或架构讨论的 tech lead,需要按任务切换 xhigh/high 推理强度
  • 在 CI 或脚本外手动调试 Codex CLI 的 SRE,需要统一 resume 语法与 2>/dev/null 默认行为
  • 维护多目录单体仓的开发者,需要用 -C 换工作目录且仍遵守 skip-git-repo-check 流程