菜单
Work on Python projects with uv. Use for repositories with pyproject.toml, uv.lock, package directories, dependency groups, .venv environments, uv sync/run/add/remove/lock workflows, or project-level tests and validation.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | uv-python-project |
| description | Work on Python projects with uv. Use for repositories with pyproject.toml, uv.lock, package directories, dependency groups, .venv environments, uv sync/run/add/remove/lock workflows, or project-level tests and validation. |
Default to uv for project management and command execution.
pyproject.toml, uv.lock, .venv, package directories, dependency groups, extras, tests, and tools.uv-python-script for standalone single-file scripts with PEP 723 inline dependencies.uv run, uv sync, uv add, uv remove, uv lock, uv format, and uv check over direct system python3, pip, or ad hoc virtualenv commands.python3 unless the project explicitly documents that path.python3 -m py_compile as the project check.requires-python and write modern Python for that version, such as match, str | None, list[str], and Path-based filesystem code. Add a focused CLI library such as click when it makes parsing clearer than handwritten plumbing.Inspect the project first:
uv --version
uv tree
Install or refresh the environment when needed:
uv sync
uv sync --all-groups
Run project commands through uv:
uv run python -m pytest
uv run pytest
uv run <tool> <args>
Manage dependencies through uv:
uv add <package>
uv add --dev <package>
uv remove <package>
uv lock
Follow existing dependency groups, extras, and lockfile conventions.
Use uv's project-aware commands when available:
uv format
uv format --check
uv check
If the project already uses specific tools, run them through uv:
uv run ruff check .
uv run mypy .
uv run basedpyright
uv run pytest
Prefer documented validation commands over generic guesses. Report the exact uv commands run and whether they passed.
Prepare a claim-centered adversarial review packet for independent review. Use when a consequential, disputed, high-uncertainty, or large-scope design, recommendation, plan, assumption, implementation conclusion, or PR conclusion must be tested against evidence, scope, falsification criteria, and residual risk; not for ordinary patch defect review or security scanning.
Run and interpret Rust test coverage with cargo llvm-cov through a bundled script. Use for crate or workspace coverage summaries, uncovered lines/functions, diff-focused coverage review, targeted Rust test-gap recommendations, or cargo llvm-cov troubleshooting.
Maintain this chezmoi repo's portable package manifest. Use when adding, updating, removing, or verifying standalone GitHub release CLI packages in home/.chezmoidata/portable-pkgs.yaml.
Edit the shared agent contract — the chezmoi-managed AGENTS.md / CLAUDE.md instruction files generated from home/.chezmoitemplates/agents/ partials. Use when adding, changing, or removing a durable behavior rule for the agents, or when asked to update AGENTS.md, CLAUDE.md, the shared partials, or a tool's contract residue.
Drive a live marimo notebook as a workspace: run Python in the same kernel the user does, inspect live notebook state, and commit durable notebook changes. Use when the user wants to start a marimo notebook or pair on an active marimo session.
Capture or refresh persisted project conventions. Use when the user wants to initialize AGENTS.md, project style, validation commands, or tool preferences so agents stop rediscovering rules each session.