Skip to content

docs(skill): fix-ci-failures skill#2725

Draft
caroger wants to merge 1 commit intomainfrom
improve/fix-ci-failures-skill
Draft

docs(skill): fix-ci-failures skill#2725
caroger wants to merge 1 commit intomainfrom
improve/fix-ci-failures-skill

Conversation

@caroger
Copy link
Collaborator

@caroger caroger commented Feb 12, 2026

Implemented /fix-ci-failures skill to debug daily cron failures

@dosubot dosubot bot added the size:XXL This PR changes 1000+ lines, ignoring generated files. label Feb 12, 2026
…mpatibility fixes

Adds comprehensive guidance based on real-world debugging of daily cron failures,
particularly focusing on transitive dependency issues and Python version compatibility.

Key improvements:

1. Python Version-Specific Compatibility Issues
   - Investigation strategy for Python 3.13+ stdlib changes (setuptools/pkg_resources)
   - Transitive dependency chain analysis (e.g., openlit → opentelemetry-instrumentation → pkg_resources)
   - Fix strategies: version updates vs. dependency additions vs. conditional imports
   - Real example from fixing py313-ci-openlit failure

2. Import-Time vs Runtime Failures
   - Clear distinction between collection errors and execution errors
   - Why pytest.mark.skip works for runtime but not import-time failures
   - How to identify each type from pytest output
   - Critical for choosing the right fix approach

3. Comparing -latest vs Non-Latest Environments
   - Systematic workflow integrated into Step 4 for when non-latest fails but -latest passes
   - Commands to compare installed versions and trace dependency chains
   - Strategy for identifying problematic version combinations

4. Stale Environment Detection
   - Symptoms of cached .tox environments causing false failures
   - When to rebuild (always after pyproject.toml changes!)
   - Verification commands to check if rebuild worked
   - Common source of "this should work now" confusion

5. Documenting Version Requirement Changes
   - Detailed commit message template with technical explanation
   - PR description template with dependency chain details
   - Examples: root cause, transitive deps, rationale, backward compatibility

6. Enhanced Quick Reference Commands
   - Compare package versions between environments
   - Dependency tree comparison
   - Full package list diff for systematic analysis

These improvements capture lessons learned from fixing daily cron failures including:
- langchain: Removed test using private API
- pipecat: Mock missing required attribute
- openlit: Parameter rename + upstream async bug + Python 3.13 compatibility
- agent-framework: @tool decorator requirement

Real-world examples throughout based on actual debugging sessions.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@caroger caroger force-pushed the improve/fix-ci-failures-skill branch from 3bf8e73 to bc0b0c4 Compare February 12, 2026 00:56
@caroger caroger changed the title docs(skill): enhance fix-ci-failures skill with Python 3.13 compatibility lessons docs(skill): fix-ci-failures skill Feb 12, 2026
@caroger caroger marked this pull request as draft February 12, 2026 01:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XXL This PR changes 1000+ lines, ignoring generated files.

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

1 participant