$npx -y skills add parcadei/Continuous-Claude-v3 --skill environment-triageEnvironment Triage
| 1 | # Environment Triage |
| 2 | |
| 3 | When `uv sync` or `pip install` behaves unexpectedly, check the actual interpreter. |
| 4 | |
| 5 | ## Pattern |
| 6 | |
| 7 | System Python is not authoritative if uv/venv selects a different interpreter. |
| 8 | |
| 9 | ## DO |
| 10 | |
| 11 | ```bash |
| 12 | # What uv ACTUALLY uses |
| 13 | uv run python --version |
| 14 | |
| 15 | # What's pinned (this controls uv) |
| 16 | cat .python-version |
| 17 | |
| 18 | # Confirm package is installed |
| 19 | uv pip show <package> |
| 20 | |
| 21 | # Confirm import works in uv context |
| 22 | uv run python -c "import <package>; print(<package>.__version__)" |
| 23 | ``` |
| 24 | |
| 25 | ## Common Fix |
| 26 | |
| 27 | If optional deps require Python 3.12+ but .python-version is 3.11: |
| 28 | |
| 29 | ```bash |
| 30 | echo "3.13" > .python-version |
| 31 | rm -rf .venv && uv venv && uv sync --all-extras |
| 32 | ``` |
| 33 | |
| 34 | ## DON'T |
| 35 | |
| 36 | - Trust `python3 --version` when using uv |
| 37 | - Assume install succeeded without verifying import |
| 38 | - Debug further before checking interpreter version |
| 39 | |
| 40 | ## Source Sessions |
| 41 | |
| 42 | - 2243c067: symbolica-agentica skipped due to `python_version >= 3.12` marker, but uv was using 3.11 |
| 43 | - 4784f390: agentica import failures traced to wrong interpreter |