# python-script

Правило python-script задаёт стандарты написания утилит автоматизации на Python 3.11+ для Claude Code: управление пакетами через uv, строгие типы и единая структура CLI.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 1627 у репозитория
- Автор: microsoft
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/microsoft/hve-core/tree/HEAD/.github/instructions/coding-standards/python-script.instructions.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/python-script

## Что делает

Правило настраивает Claude Code на генерацию скриптов по инженерным стандартам Microsoft. В проектах запрещается прямой вызов `pip install`: любые зависимости ставятся через `uv add`, а запуск кода разрешён только внутри виртуального окружения через `uv run`. Это сразу отсекает проблемы с несовместимостью системных пакетов.

Вместо устаревшего модуля `os.path` агент обязуется применять `pathlib.Path`. Для парсинга аргументов командной строки предписано выносить сборку парсера `argparse` в отдельную функцию либо использовать `click` при наличии подкоманд. Модель применяет современный синтаксис типов Python 3.11 без устаревших конструкций из `typing` вроде `Union` или `Optional`.

Для перехвата ошибок внедряются фиксированные коды возврата: 0 при успехе, 1 при общей ошибке, 2 при сбое конфигурации и 130 при прерывании процесса. В скриптах без виртуального окружения `.venv` в корне проект не запустится.

## Установка

### GitHub Copilot (родная платформа)

**Вручную: положить файлы**
- Файл: `.github/instructions/python-script.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/python-script.md` — Поле paths во frontmatter ограничивает файлы: applyTo из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/python-script.mdc` — Во frontmatter: description, globs, alwaysApply. applyTo из источника → globs, иначе правило само не подключится

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/python-script.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/python-script.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/microsoft/hve-core/tree/HEAD/.github/instructions/coding-standards/python-script.instructions.md

## Когда брать
- запретить прямое использование pip и перевести окружение на uv
- структурировать обработку аргументов CLI через argparse или click
- заменить вызовы os.path на методы pathlib.Path
- внедрить стандартные коды возврата и обработку KeyboardInterrupt

## Примеры запросов агенту
- Напиши CLI-скрипт для пакетной обработки файлов с аргументами через argparse
- Перепиши скрипт автоматизации под требования python-script с типами Python 3.11
- Сделай консольную утилиту с подкомандами на click и логированием в файл

## Похожие
- [writing-python](https://affpapa.org/nevibecode/skills/writing-python.md) — скилл · 134 установки
- [python-scaffold](https://affpapa.org/nevibecode/commands/python-scaffold.md) — команда · ★ 42780 у репозитория
- [cli-anything-hermes](https://affpapa.org/nevibecode/skills/cli-anything-hermes.md) — скилл · 314 установок
- [python-guidelines](https://affpapa.org/nevibecode/skills/python-guidelines.md) — скилл · ★ 1216 у репозитория
- [cli-anything](https://affpapa.org/nevibecode/skills/cli-anything.md) — скилл · 2200 установок
- [click](https://affpapa.org/nevibecode/rules/click.md) — правило · ★ 3589 у репозитория

Из того же набора: [microsoft/hve-core](https://affpapa.org/nevibecode/by/microsoft/hve-core.md) — 148 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
