code-change-verification

代码更改验证

概述

确保只有在安装依赖、构建、Lint、类型检查（包括生成的声明文件）和测试全部通过后，才将工作标记为完成。当更改影响运行时代码、测试或构建／测试配置时，请使用此技能。这是审查后的最终关卡：当 $implementation-final-review 适用时，在其干净审查条件满足之前，不要运行完整的验证流程。

快速开始

1. 将此技能保存在 ./.agents/skills/code-change-verification，以便它自动加载到仓库中。
2. 在用户选定的检出目录中运行此技能，不要更改工作树或分支。
3. Codex on macOS/Linux：/usr/bin/env -u OPENAI_API_KEY bash .agents/skills/code-change-verification/scripts/run.sh。
4. 其他 macOS/Linux 环境：bash .agents/skills/code-change-verification/scripts/run.sh。
5. Windows：powershell -ExecutionPolicy Bypass -File .agents/skills/code-change-verification/scripts/run.ps1。
6. 如果任何命令失败，请修复问题，重新运行脚本，并报告失败的输出。
7. 只有在所有命令均成功且没有遗留问题时，才能确认完成。

启动条件和主机容量

• 在迭代审查期间，仅运行有针对性的测试；只有当更改的类型边界需要时，才运行范围较窄的静态检查。在审查通过之前，推迟运行仓库范围的 pnpm -r build-check 及其余完整验证流程。
• 开始完整验证流程前，立即使用可用的只读任务或进程信息，检查同一主机上是否已有其他仓库范围的测试、类型检查、构建、示例运行器或集成命令在运行。
• 当发现明确的资源争用时，继续进行有价值且不繁重的工作，例如审查、修复、准备验证材料或运行有针对性的检查，之后再重新检查。不要创建或等待仓库锁、主机级互斥锁或哨兵文件。
• 审查通过、差异稳定且可观察到主机有可用容量后，自动开始。不要要求用户发送 finalize 消息来触发。如果无法获取主机遥测数据，不要仅因无法测量容量而阻止执行。

Codex 执行策略

仓库验证及其所有子进程都必须在正常的 Codex 工作区沙箱中运行。绝不要请求提升验证的沙箱权限，也不要在失败后重试并扩大主机访问权限。

在 macOS/Linux 上，使用“快速开始”中的准确 Codex 命令，在仓库控制的包装脚本启动前移除继承的 OPENAI_API_KEY。在工作区沙箱内调查失败，并报告沙箱无法提供的任何覆盖范围，而不是削弱沙箱边界。

手动工作流

• 从仓库根目录按以下阶段运行：pnpm i --frozen-lockfile、pnpm build，然后运行 pnpm -r build-check、pnpm -r -F "@openai/*" dist:check、pnpm lint、pnpm test 和 pnpm format:check:changed。
• 此技能可以并行执行最后的验证阶段，但上述每个步骤都必须通过。
• 不要跳过步骤；任何步骤失败时，立即停止并修复问题。
• 应用修复后，重新运行完整验证流程，确保命令在相同的关卡和覆盖范围下执行。
• 安装步骤会有意不强制启用 CI 或提示确认设置。如果 pnpm 报告 node_modules 不兼容，请停止并诊断配置不匹配，而不要在未说明的情况下重新创建依赖。

资源

scripts/run.sh

• 以快速失败语义执行完整验证流程（包括声明文件检查）。
• 将 pnpm i --frozen-lockfile 和 pnpm build 作为关卡，然后通过 pnpm 并行运行根目录的 verify:* 脚本。
• 优先使用此入口，以确保命令始终从仓库根目录按预期的快速失败行为运行。

scripts/run.ps1

• 适用于 Windows 的包装脚本，可通过快速失败语义运行相同的验证流程。
• 如果环境要求，可在 PowerShell 中绕过执行策略后使用。