Codex 运行指南
将以下提示词粘贴到你的 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 流程