# python-expert-best-practices-code-review

Набор правил по Python для написания, ревью и рефакторинга кода. Пригодится, когда агент правит обработку ошибок или чистит словари.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 673 установки · ★ 8
- Автор: wispbit
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/wispbit-ai/skills/tree/HEAD/skills/python-expert-best-practices-code-review/SKILL.md
- Обновлён: 2026-02-11
- HTML: https://affpapa.org/nevibecode/skills/python-expert-best-practices-code-review

## Что делает

Скилл задаёт агенту восемь правил, разбитых по приоритету. Первый уровень — обработка ошибок: обращение к обязательным ключам словаря через `d[key]`, чтобы падать сразу с `KeyError`, и запрет на общий `except`, который прячет неожиданные сбои. Второй — типичные баги: изменяемые значения по умолчанию в параметрах и возврат `NotImplemented` для неподдерживаемых операндов.

Дальше идёт читаемость: списковые включения должны возвращать значение, которое вы используете, а не работать ради побочных эффектов; импорты держатся в начале файла; лишние комментарии и блоки `else` после `return` или `break` убираются. У каждого правила есть свой файл в `rules/` с разбором, примерами неправильного и правильного кода и ссылками.

Скилл рассчитан на Python 3.14+. Если ваш проект живёт на более старой ветке, часть примеров придётся проверять руками — синтаксис и поведение там отличаются. Установка идёт через `npx skills add`, для GitHub Copilot команда другая.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add wispbit-ai/skills --skill python-expert-best-practices-code-review -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/python-expert-best-practices-code-review/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/python-expert-best-practices-code-review/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add wispbit-ai/skills --skill python-expert-best-practices-code-review -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/python-expert-best-practices-code-review/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add wispbit-ai/skills --skill python-expert-best-practices-code-review -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/python-expert-best-practices-code-review/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install wispbit-ai/skills python-expert-best-practices-code-review
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/python-expert-best-practices-code-review/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add wispbit-ai/skills --skill python-expert-best-practices-code-review -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/wispbit-ai/skills --path skills/python-expert-best-practices-code-review
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/python-expert-best-practices-code-review/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add wispbit-ai/skills --skill python-expert-best-practices-code-review -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/wispbit-ai/skills/tree/HEAD/skills/python-expert-best-practices-code-review/SKILL.md

## Когда брать
- поймать обязательный ключ словаря сразу, а не через десять шагов
- убрать общий `except`, который глотает чужие ошибки
- найти изменяемое значение по умолчанию в параметрах функции
- переписать списковое включение, которое работает ради побочного эффекта
- разложить импорты по началу файла и вычистить лишние `else`

## Примеры запросов агенту
- Отревьюй этот модуль по правилам скилла и покажи, где нарушен `no-mutable-defaults`
- Отрефактори `parser.py`: убери общий `except` и замени обращения к словарю на `d[key]` там, где ключ обязателен
- Проверь списковые включения в `report.py` — есть ли среди них те, что не возвращают значение

## Похожие
- [python-anti-patterns](https://affpapa.org/nevibecode/skills/python-anti-patterns.md) — скилл · 13278 установок
- [python-code-review](https://affpapa.org/nevibecode/skills/python-code-review.md) — скилл · 920 установок
- [Python Backend Architecture Review](https://affpapa.org/nevibecode/skills/python-backend-architecture-review.md) — скилл · 503 установки
- [python-design-patterns](https://affpapa.org/nevibecode/skills/python-design-patterns.md) — скилл · 22842 установки
- [python](https://affpapa.org/nevibecode/skills/pproenca-python.md) — скилл · 315 установок

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