# Python Backend Architecture Review

Скилл для ревью архитектуры Python-бэкенда: разбирает документ по системе, масштабируемости, безопасности и API. Пригодится, когда проект уже описан, а слабые места надо найти до релиза.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 503 установки · ★ 86
- Автор: rknall
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/rknall/claude-skills/tree/HEAD/python-architecture-review/SKILL.md
- Обновлён: 2025-10-20
- HTML: https://affpapa.org/nevibecode/skills/python-backend-architecture-review

## Что делает

Скилл включается, когда вы просите агента разобрать архитектуру Python-приложения или документ по системному дизайну. Дальше он идёт по разделам: стиль архитектуры и границы сервисов, база данных, API, безопасность, масштабируемость, наблюдаемость.

Внутри — фреймворк ревью с вопросами для уточнения контекста. Агент спросит про ожидаемую нагрузку, требования к задержке, безопасность и состав команды, а потом разберёт схему: связи компонентов, потоки данных, внешние зависимости, стек, топологию развёртывания. Отдельно учтены особенности Python: выбор между ASGI и WSGI, async/await, влияние GIL, многопроцессность против многопоточности, ORM и драйверы, фоновые задачи.

Обратная связь идёт не общими словами, а по пунктам: где связность слишком плотная, где узкое место по нагрузке, каких слоёв кэширования не хватает, что с индексами и миграциями. Скилл не читает ваш код сам — ему нужен документ или описание системы, иначе разбирать будет нечего. Замечания по безопасности опираются на то, что вы описали: механизмы аутентификации, модель авторизации, шифрование, работа с секретами.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill python-backend-architecture-review -a claude-code
```
```bash
npx skills add rknall/claude-skills --skill python-architecture-review -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill python-architecture-review -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill python-architecture-review -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rknall/claude-skills python-architecture-review
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill python-architecture-review -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/rknall/claude-skills --path python-architecture-review
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add rknall/claude-skills --skill python-architecture-review -a opencode
```

### Claude.ai

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

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

## Когда брать
- найти узкие места в архитектуре до того, как они проявятся под нагрузкой
- проверить схему базы данных и стратегию индексов
- оценить безопасность API и модель авторизации
- разобрать границы сервисов и связность между ними
- выбрать между ASGI и WSGI под конкретную нагрузку

## Примеры запросов агенту
- Разбери архитектуру моего Python-бэкенда, вот описание системы и схема компонентов
- Проверь дизайн API и модель авторизации в этом документе
- Посмотри схему базы данных и скажи, где будут проблемы с индексами

## Похожие
- [python-backend](https://affpapa.org/nevibecode/skills/python-backend.md) — скилл · 2200 установок
- [fastapi-python](https://affpapa.org/nevibecode/skills/fastapi-python.md) — скилл · 13900 установок
- [architecture-patterns](https://affpapa.org/nevibecode/skills/secondsky-architecture-patterns.md) — скилл · 493 установки
- [architecture-review](https://affpapa.org/nevibecode/skills/decebals-architecture-review.md) — скилл · 338 установок
- [fastapi-patterns](https://affpapa.org/nevibecode/skills/fastapi-patterns.md) — скилл · 4900 установок
- [Python Security Scan](https://affpapa.org/nevibecode/skills/python-security-scan.md) — скилл · 540 установок

Из того же набора: [rknall/claude-skills](https://affpapa.org/nevibecode/by/rknall/claude-skills.md) — 4 карточки

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