Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

modernize-python

/modernize-python

Modernizuje kod Python do aktualnych standardów: podpowiedzi typów, dataclasses, pathlib, f-stringi, match i menedżery kontekstu.

Licencja
MIT
Ostatnia zmiana repozytorium
11.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Modernizuje kod Python do aktualnych standardów: podpowiedzi typów, dataclasses, pathlib, f-stringi, match i menedżery kontekstu.

Wyzwalacze z opisu

type hints everywheremove to pathlibuse dataclasses
Oryginalny opis (EN)

Modernize a Python codebase to current standards with type hints, dataclasses, pathlib, f-strings, match statements, context managers, logging, and async hygiene, one package at a time. Use when the user asks to modernize, update, standardize, or apply Python best practices to a file, package, or codebase, or asks for "type hints everywhere", "move to pathlib", "use dataclasses". This is the mechanical, low-risk pass. It does NOT restructure code or separate I/O from logic - use function-first-refactor for that. Run cleanup-code first to prune dead code.

Jak działa

  1. Ground rules
  2. Process
  3. Report
  4. See also
Sekcje z nagłówków SKILL.md, w oryginale · 60 linii, 453 słów
Podgląd SKILL.md
---
name: modernize-python
description: Modernize a Python codebase to current standards with type hints, dataclasses, pathlib, f-strings, match statements, context managers, logging, and async hygiene, one package at a time. Use when the user asks to modernize, update, standardize, or apply Python best practices to a file, package, or codebase, or asks for "type hints everywhere", "move to pathlib", "use dataclasses". This is the mechanical, low-risk pass. It does NOT restructure code or separate I/O from logic - use function-first-refactor for that. Run cleanup-code first to prune dead code.
---

# Modernize Python

> Prune with `cleanup-code` first. Modernize code that _should exist_, not code that should be deleted.
> Restructuring logic vs. I/O is a different job: use `function-first-refactor` afterwards.

## Ground rules

- **Preserve behavior.** Outputs, error types, and side-effect order stay identical unless the user asks otherwise.
- **Types and syntax, not structure.** Dataclasses are fine as plain records (prefer `frozen=True`). Converting classes to functions, or splitting logic from I/O, is structural — that is `function-first-refactor`'s job, not this pass (checklist Section 6).
- **Skip when** the code is already clear and short, the feature is gated above the project's minimum Python, the file is generated or one-off, or the new construct is heavier than what it replaces.
- **Stay in the user's style** and test framework (pytest by default).

## Process

### 1. Scope (codebase-sized work)

Never modernize a whole codebase in one sweep. Pick a unit (one package or directory), say which in one line, and finish it before the next. After each unit, stop and summarize so the user can review and commit. If the user said "the whole codebase", do it unit by unit, starting with the most-imported modules.

### 2. Assess

1. **Minimum Python version**: check `pyproject.toml`, `setup.cfg`, `.python-version`, CI config. Use only features at or below that floor.
2. **Inventory** against `references/checklist.md`: _applies and safe_, _needs version check_, _changes behavior - confirm first_, or _not present_.

### 3. Baseline

Record results before touching anything. Defaults for a `uv` project (adapt to actual tooling and layout):

```bash
uv run mypy src/
uv run ruff check .
uv run pytest --tb=short
uv run pytest --cov=src --cov-report=term-missing
```

Flag pre-existing failures so they aren't mistaken for regressions. If the unit has no tests, say so; behavior-preservation can't be verified, so keep changes to the safest mechanical ones.

### 4. Apply

1. Run `pyupgrade` / `ruff --fix` first for bulk mechanical changes. Reserve manual work for structural ones.
2. Apply one pattern at a time across the unit, run tests after each.
3. Checklist items marked **[behavior change]** (print to logging, configparser to tomllib, narrowing broad `except`) are applied only if the user wants them; otherwise list them as suggestions.

Examples for each pattern: `references/scenarios.md`.

### 5. Verify

Re-run the baseline. Pass: no new mypy errors, no new lint violations, test pass rate same or better, coverage at or above baseline.

## Report

1. What was changed, per pattern, and in which files.
2. Baseline vs. after for tests, types, lint.
3. Behavior-changing modernizations held back for approval.
4. Purity smells spotted (functions mixing I/O and logic) - list them, don't fix them; suggest `function-first-refactor`.

## See also

`cleanup-code` (run first) - `function-first-refactor` (structure) - `review-code` (final gate)
Pliki w paczce (3)
  • SKILL.md 4 KB
  • references/checklist.md 3 KB
  • references/scenarios.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie modernize-python.

Migawka bazy z 13.11.2026 · wersja paczki a1e3969b814b (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 95python-conventions
    Podpowiada nowoczesne idiomy Pythona 3.10+: podpowiedzi typów, dataclasses, pathlib i dopasowanie wzorców.
  • 90python-guide
    Podpowiada przy pisaniu i edycji Pythona 3.12+ dla API, przetwarzania danych, skryptów i narzędzi: async, typy, pathlib i pytest.
  • 100python-patterns
    Stosuje wzorce projektowe i dobre praktyki Python: protokoły, dataclasses, menedżery kontekstu, dekoratory, async/await, adnotacje typów i organizacja pakietów.
  • 100python
    Wspiera pisanie aplikacji w Python 3.10 do 3.14: typowanie, async, dataclasses, menedżery kontekstu, instrukcja match i nowoczesne wzorce.
  • 90python-language
    Stosuje podstawowe standardy Pythona 3.11+ dla typowania, dataclasses, importów, pathlib i kodu opartego na bibliotece standardowej w modułach i stubach.
  • 100python
    Pomaga pisać idiomatyczny kod Python 3.11+: adnotacje typów, async/await, generatory, dataclasses, menedżery kontekstu, środowiska wirtualne i optymalizacja wydajności.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.