vscode-python-environments

Critical patterns for cross-platform path handling in this VS Code extension. Windows vs POSIX path bugs are the #1 source of issues. Use this skill when reviewing or writing path-related code.

Generate a codebase health snapshot for technical debt tracking and planning. Analyzes git history, code complexity, debt markers, and dependencies to identify hotspots and refactoring priorities.

Environment manager-specific discovery patterns and known issues. Use when working on or reviewing environment discovery code for conda, poetry, pipenv, pyenv, or venv.

Run the mandatory pre-commit checks before committing code. Includes lint, type checking, and unit tests. MUST be run before every commit.

VS Code settings precedence rules and common pitfalls. Essential for any code that reads or writes settings. Covers getConfiguration scope, inspect() vs get(), and multi-workspace handling.

Debug a failing test using an iterative logging approach, then clean up and document the learning.

Run E2E tests to verify complete user workflows like environment discovery, creation, and selection. Use this before releases or after major changes.

Run integration tests to verify that extension components work together correctly. Use this after modifying component interactions or event handling.

Run smoke tests to verify extension functionality in a real VS Code environment. Use this when checking if basic features work after changes.