102-python-patterns — правило для Claude Code: суть и установка
Правило 102-python-patterns задаёт стандарты написания кода на Python: строгую типизацию, асинхронный ввод-вывод, следование PEP 8 и кастомные исключения. Срабатывает при редактировании **/*.py.
MIT ★ 97 обновлён 2026-06-11
.cursor/rules/102-python-patterns.mdcЧто делает 102-python-patterns
Инструкция формулирует требования к коду в файлах **/*.py. Она обязывает указывать типы аргументов и возвращаемых значений во всех сигнатурах функций, использовать pathlib вместо устаревшего os.path и валидировать структуры данных через модели Pydantic или dataclasses.
Для асинхронных операций правило предписывает asyncio.gather(), запрещая смешивать синхронные и асинхронные вызовы на критических участках. Ошибки требуют точных типов или доменных исключений: пустой перехват except: запрещён.
На версиях интерпретатора ниже Python 3.10 структурное сопоставление шаблонов match / case завершится синтаксической ошибкой.
Какие задачи решает
- обязать агента типизировать сигнатуры функций и проверять структуры через Pydantic
- запретить неспецифичные перехваты через голый
except - перевести операции ввода-вывода на
async/awaitиasyncio.gather() - заменить
os.pathна методыpathlib
Примеры запросов агенту
- Напиши асинхронный клиент для скачивания файлов и валидируй конфиг через Pydantic
- Добавь обработчик заказов со структурным сопоставлением шаблонов
- Сделай менеджер контекста через
contextlibдля работы с сокетом
Как установить 102-python-patterns
Вручную: положить файлы
.cursor/rules/102-python-patterns.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.claude/rules/102-python-patterns.mdПоле paths во frontmatter ограничивает файлы: globs из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.github/instructions/102-python-patterns.instructions.mdПоле applyTo задаёт, к каким файлам применять: globs из источника → applyTo
Вручную: положить файлы
.devin/rules/102-python-patterns.mdВручную: положить файлы
.clinerules/102-python-patterns.mdПо шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules
Вопросы о 102-python-patterns
Как установить 102-python-patterns в Claude Code?
Сохраните файл по пути .claude/rules/102-python-patterns.md. Правило будет подхватываться при работе с файлами по маске **/*.py.
Что делает 102-python-patterns?
Задаёт для ИИ-ассистента конвенции Python: аннотации типов, отказ от os.path в пользу pathlib, строгий PEP 8 и явную обработку исключений.
С какими версиями Python совместимо правило?
В правиле прописано использование структурного сопоставления шаблонов, поэтому проект должен использовать как минимум Python 3.10.
Исходный текст
102-python-patterns.mdc · MIT
--- description: Python coding patterns and conventions globs: ["**/*.py"] alwaysApply: false --- # Python Patterns ## Type Hints - Required for all function signatures (params + return type) - Use Pydantic models for data validation - Use TypeVar and Generic for reusable types ## Async - Use async/await for all I/O operations - Use asyncio.gather() for concurrent operations - Never mix sync and async code in hot paths ## Style - Follow PEP 8 strictly - Use structural pattern matching (Python 3.10+) over complex if/else - Prefer dataclasses or Pydantic over plain dicts - Use pathlib over os.path ## Error Handling - Use specific exception types (never bare except) - Create custom exceptions for domain errors - Use contextlib for resource management
© obviousworks · MIT · obviousworks/vibe-coding-ai-rules