code-change-verification

Original🇺🇸 English
Translated
2 scripts

Run the mandatory verification stack when changes affect runtime code, tests, or build/test behavior in the OpenAI Agents Python repository.

5installs
Added on

NPX Install

npx skill4agent add openai/openai-agents-python code-change-verification

Code Change Verification

Overview

Ensure work is only marked complete after formatting, linting, type checking, and tests pass. Use this skill when changes affect runtime code, tests, or build/test configuration. You can skip it for docs-only or repository metadata unless a user asks for the full stack.

Quick start

  1. Keep this skill at
    ./.agents/skills/code-change-verification
    so it loads automatically for the repository.
  2. macOS/Linux:
    bash .agents/skills/code-change-verification/scripts/run.sh
    .
  3. Windows:
    powershell -ExecutionPolicy Bypass -File .agents/skills/code-change-verification/scripts/run.ps1
    .
  4. If any command fails, fix the issue, rerun the script, and report the failing output.
  5. Confirm completion only when all commands succeed with no remaining issues.

Manual workflow

  • If dependencies are not installed or have changed, run
    make sync
    first to install dev requirements via
    uv
    .
  • Run from the repository root in this order:
    make format
    ,
    make lint
    ,
    make mypy
    ,
    make tests
    .
  • Do not skip steps; stop and fix issues immediately when a command fails.
  • Re-run the full stack after applying fixes so the commands execute in the required order.

Resources

scripts/run.sh

  • Executes the full verification sequence with fail-fast semantics from the repository root. Prefer this entry point to ensure the required commands run in the correct order.

scripts/run.ps1

  • Windows-friendly wrapper that runs the same verification sequence with fail-fast semantics. Use from PowerShell with execution policy bypass if required by your environment.