python-uv-workflow

name	python-uv-workflow
description	Apply Python development policy using uv-first execution, test-first behavior validation, and pre-commit quality gates. Use when implementing or refactoring Python code.

Python UV Workflow

Overview

Use this workflow to keep Python implementation and refactoring aligned with repository policy.

Read Acknowledgement

• After reading this skill, say: 🐍 私は python-uv-workflow を読みました。

Workflow

1. Use uv as the default toolchain for Python projects.
2. Run scripts with uv run <script>.
3. Write tests when behavior changes and verify expected behavior.
4. Add standard dev dependencies with uv.
5. Install pre-commit hooks after dependency setup.
6. Create .pre-commit-config.yaml when missing.
7. Create Makefile with setup target when missing.
8. For refactoring from non-uv originals, align dependencies, raise coverage, and verify output parity.

Testing Expectations

• Add tests before refactoring.
• Prefer real data over mocks and monkeypatches when feasible.
• Target coverage expansion toward 90%+ for refactoring tasks.

Use python-uv-rules.md for exact commands and canonical hook configuration.