К основному содержанию
промпт GP ChatGPT

Python Type Hints taste — промпт для ChatGPT: правила и установка

Промпт Python Type Hints taste для ChatGPT задаёт правила типизации Python-кода. Он охватывает аннотации, выбор типов и настройку статической проверки.

CC0-1.0 ★ 178 201 обновлён 2026-10-24

Открыть на GitHub

Что делает Python Type Hints taste

Промпт задаёт стиль работы с типами в Python: предлагает запускать pyright или mypy в CI на каждом pull request и считать новые ошибки причиной сбоя сборки. Для нового кода он рекомендует строгую проверку, современные встроенные обобщённые типы и аннотации публичных функций, включая тип результата.

В правилах также описаны Protocol, dataclass, TypedDict, Literal, NewType и сужение типов через проверки, а не cast(). Для библиотек упоминается маркер py.typed; тяжёлые импорты предлагается помещать под if TYPE_CHECKING:. Синтаксис PEP 695 рассчитан на Python 3.12 и новее.

Какие задачи решает

  • настроить строгую проверку типов для нового кода
  • выбрать типы для публичных функций и структур данных
  • сузить Any и неизвестные значения безопасными проверками
  • оформить исключения type: ignore с кодом ошибки и пояснением

Примеры запросов агенту

  • Проверь типизацию этого Python-модуля по правилам промпта.
  • Предложи аннотации для публичных функций и замени неподходящие Any.
  • Настрой рекомендации по типам для проекта на Python 3.12+.

Как установить Python Type Hints taste

Как использовать

Вставьте текст в начало диалога или в инструкции проекта

Вопросы о Python Type Hints taste

Как установить Python Type Hints taste в Claude Code?

Добавьте файл по пути .claude/commands/prompts.csv.md.

Что делает Python Type Hints taste?

Он задаёт рекомендации по статической проверке Python-кода и аннотациям типов. Среди правил — использовать абстрактные типы для параметров и конкретные для возвращаемых значений.

Для каких версий Python подходит синтаксис PEP 695 из промпта?

Промпт рекомендует PEP 695 для Python 3.12 и новее.

Исходный текст

prompts.csv · CC0-1.0
# Python Type Hints taste of a typed-Python maintainer
- Run a type checker (pyright or mypy) in CI on every pull request and treat new errors as build failures. Confidence: 0.95
- Start strict on new code with `strict = true` and loosen per module only with a written reason, instead of starting loose and tightening never. Confidence: 0.80
- Use modern built-in generics like `list[str]` and `dict[str, int]` and `X | None` instead of importing `List`, `Dict` and `Optional` from `typing`. Confidence: 0.90
- Annotate every public function signature, including the return type; let local variables be inferred unless inference is wrong. Confidence: 0.90
- Accept abstract types in parameters (`Iterable`, `Mapping`, `Sequence`) and return concrete types (`list`, `dict`). Confidence: 0.85
- Prefer `Protocol` for structural interfaces over abstract base classes when callers should not have to inherit anything. Confidence: 0.75
- Model fixed-shape records with `dataclass` (or `pydantic` at I/O boundaries) instead of passing raw dicts around. Confidence: 0.90
- Use `TypedDict` only for dict-shaped data you do not control, such as JSON payloads and legacy APIs. Confidence: 0.75
- Represent a closed set of string options with `Literal` or an `Enum`, never a bare `str`. Confidence: 0.85
- Treat `Any` as a bug report: confine it to the boundary where untyped data enters and narrow it immediately. Confidence: 0.85
- Prefer `object` over `Any` when a value is truly unknown, so the checker forces a narrowing step before use. Confidence: 0.70
- Narrow with `isinstance`, `match` statements and `TypeGuard`/`TypeIs` helpers instead of `cast()`. Confidence: 0.80
- Every `# type: ignore` must name the error code and carry a short comment explaining why it is safe. Confidence: 0.90
- Use `NewType` for IDs and units (`UserId`, `Cents`) that are easy to mix up but share an underlying type. Confidence: 0.70
- Ship a `py.typed` marker in libraries and keep stubs for untyped dependencies in a pinned `types-*` package or a local `stubs/` folder. Confidence: 0.85
- Use `@overload` only when the return type truly depends on argument types; otherwise simplify the API. Confidence: 0.70
- Prefer PEP 695 syntax (`def first[T](xs: list[T]) -> T`) on Python 3.12+ instead of module-level `TypeVar` declarations. Confidence: 0.75
- Annotate `self`-returning builder methods with `Self` rather than a bound `TypeVar`. Confidence: 0.80
- Mark constants with `Final` and override methods with `@override` so refactors surface mistakes. Confidence: 0.70
- Do not add runtime type checks that duplicate the static checker; validate only untrusted input at the edges. Confidence: 0.80
- Keep annotations import-cheap: put heavy imports under `if TYPE_CHECKING:` to avoid circular imports and slow startup. Confidence: 0.75

© f · CC0-1.0 · f/prompts.chat

Похожие промпты

Все промпты по теме «Языки программирования» →
Type Hints pluginagentmarketplace Скилл Type Hints учит агента писать аннотированный Python и настраивать mypy: от подписей функций до Protocol, TypedDict и строгого режима. CX Codex +1 128установок python-type-safety Seth Hobson Скилл python-type-safety помогает добавлять типы в Python-код, писать дженерики и протоколы, а также настраивать строгую проверку через mypy или pyright. CX Codex +1 12 643установок python-pro https://github.com/Jeffallan Скилл python-pro для написания типобезопасного Python 3.11+ с полной аннотацией, async-кодом и тестами. Генерирует код с type hints, настраивает mypy в строгом режиме, пишет pytest-тесты с фиксчурами и мокингом. CX Codex +1 9 300установок python-code-style Seth Hobson Скилл python-code-style для Claude Code задаёт правила стиля Python, линтеров, форматирования и документации для новых модулей, ревью и настройки проекта. CX Codex +1 16 456установок writing-python julianobarbosa Скилл writing-python держит агента в правилах Python 3.14+: сначала стандартная библиотека, аннотации типов у всех функций, uv и ruff вместо pip и black. CX Codex +1 134установок basedpyright-type-checking laurigates Скилл basedpyright-type-checking настраивает статическую типизацию Python через basedpyright, помогает выбрать между ним и mypy, а также подготовить конфигурацию для проекта. CX Codex +1 357установок

Из того же набора218

Весь набор →
SQLite taste Промпт SQLite taste для ChatGPT с практическими рекомендациями по SQLite. Помогает выбрать настройки базы, спланировать миграции и организовать резервное копирование. GP ChatGPT ★ 178 201звёзд репо Dependency Management taste Промпт Dependency Management taste для ChatGPT и Claude.ai настраивает ИИ на принципы управления зависимостями от мейнтейнера. Исключает случайные сбои в проектах. GP ChatGPT ★ 178 201звёзд репо Internationalization taste Промпт Internationalization taste для ChatGPT задаёт правила интернационализации продукта. Он помогает спроектировать локализацию интерфейса, форматов данных и публичных страниц. GP ChatGPT ★ 178 201звёзд репо API Rate Limiting taste Промпт API Rate Limiting taste для ChatGPT, настраивающий правила ограничения частоты запросов к API. Помогает проектировать защиту бэкенда от злоупотреблений и сбоев. GP ChatGPT ★ 178 201звёзд репо Secrets Management taste Промпт Secrets Management taste для ChatGPT задаёт стандарты безопасного обращения с секретами и ключами в инфраструктуре. GP ChatGPT ★ 178 201звёзд репо Tokio Async Rust taste Промпт Tokio Async Rust taste для ChatGPT задаёт правила проектирования асинхронных сервисов на Rust с Tokio. Он включается при написании или проверке кода, где важны отмена задач, тайм-ауты и завершение работы. GP ChatGPT ★ 178 201звёзд репо Tailwind CSS taste Промпт Tailwind CSS taste задаёт стандарты жестикуляции утилитарных стилей Tailwind CSS в ChatGPT, Claude.ai и Claude Code. Настраивает дизайн-токены в теме и запрещает жёстко закодированные пиксельные размеры. GP ChatGPT ★ 178 201звёзд репо Vite Frontend Tooling taste Промпт Vite Frontend Tooling taste для ChatGPT задаёт правила настройки фронтенд-проектов на Vite. Он охватывает запуск приложений, проверки типов, тесты и подготовку сборки к релизу. GP ChatGPT ★ 178 201звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой