用途:在 OpenAI Agents Python 仓库中,当变更影响运行时代码、测试或构建/测试配置时,使用该技能执行强制验证栈,确保只有格式化、lint、类型检查和测试全部通过后才将工作标记为完成。仅文档或仓库元数据变更可跳过,除非用户要求完整验证。
主要能力:提供一键脚本按固定顺序执行完整验证序列,并具备 fail-fast 语义;同时给出手动工作流,便于在依赖变化或脚本不可用时逐步执行。
使用方式:将技能放在 ./.codex/skills/code-change-verification 以便仓库自动加载。macOS/Linux 运行 bash .codex/skills/code-change-verification/scripts/run.sh;Windows 运行 powershell -ExecutionPolicy Bypass -File .codex/skills/code-change-verification/scripts/run.ps1。若依赖未安装或已变化,先在仓库根目录运行 make sync 通过 uv 安装开发依赖。手动流程需在仓库根目录按顺序执行:make format、make lint、make mypy、make tests。
限制与要求:不得跳过任何步骤;命令失败时立即停止并修复,修复后需重新运行完整栈以保证顺序正确。任何命令失败都应修复、重跑脚本并报告失败输出;仅当所有命令成功且无遗留问题时才确认完成。