name: fix-test-case description: Fix a specific failing test case in this repo by identifying the root cause, adding a minimal repro under tests/, explaining the cause, applying a targeted fix, re-running the test, and reporting any new failures uncovered.
Fix a failing test case
Scope
- Work on one concrete failing test at a time.
- Keep the repro small and isolated under tests/.
- Do not try to fix failures that are due to changing the source layout; add them to
EXPECTED_FAILURE.mdinstead. - If a failure is due to shifting line numbers or changed source content (literal tracebacks, linecache, etc.), add it to
EXPECTED_FAILURE.md.
Workflow
-
Reproduce the failure
- Re-run the failing test directly (use the narrowest command possible, e.g.
uvx pytest tests/test_file.py -k "test_name"). - Capture the exact error, traceback, and any assertion mismatch.
- Re-run the failing test directly (use the narrowest command possible, e.g.
-
Identify the root cause
- Inspect the failing code path and surrounding logic.
- Map the failure back to the minimal incorrect behavior (state mismatch, wrong transform, missing edge case).
- If needed, use the
python-debugskill for pdb stepping or thepython-monitoring-traceskill for a sys.monitoring trace.
-
Always add a minimal repro under tests/
- Create a new test file or extend the most relevant existing test file.
- Keep the input as small as possible while still reproducing the failure.
- Prefer integration-style tests consistent with existing tests/ conventions.
-
Explain the cause
- Summarize the bug in one or two sentences.
- Point to the relevant code path and why it misbehaves.
-
Implement the fix
- Apply the smallest change that makes the repro pass.
- Avoid unrelated refactors or behavior changes.
- Never change the cpython source to fix a test.
- The goal is to transform python to a minimal form, so do not selectively disable that to fix the tests.
-
Re-run the test
- Re-run the specific failing test and the new repro.
- If it uncovers additional failures, summarize them and continue iterating.
-
Final verification
- Run the full required test commands (
cargo testanduvx pytest tests/).
- Run the full required test commands (
Output expectations
- Provide a short cause explanation and the fix rationale.
- List the exact tests re-run and the results.
- If more failures appear, list them with a brief classification (ERROR/FAIL/TIMEOUT/CRASHED).
chat Comments (0)
Sign in to join the discussion and leave a comment.
Skill Details
GitHub Stars
0
GitHub Forks
0
Created
Jan 2026
Last Updated
5个月前
tools
tools testing
Related Skills
Build your own?
Join 12,000+ developers contributing to the Claude ecosystem.
No comments yet. Be the first to share your thoughts!