# recommendation-system

Скилл помогает развернуть API рекомендаций на FastAPI и Redis с фиче-стором, многоуровневым кэшированием и отслеживанием метрик в Prometheus.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 398 установок · ★ 237
- Автор: secondsky
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/secondsky/claude-skills/tree/HEAD/plugins/recommendation-system/skills/recommendation-system/SKILL.md
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/skills/recommendation-system

## Что делает

Скилл содержит архитектурные шаблоны для рекомендательных сервисов. В его основе лежат FastAPI, Redis и Prometheus. Пользовательские признаки сохраняются в фиче-сторе с TTL в 3600 секунд, а выдача рекомендаций распределяется между несколькими моделями для A/B-тестирования.

Кэширование разделено на уровни: быстрый L1 в оперативной памяти и L2 в Redis. Для новых пользователей без истории покупок предусмотрен fallback на популярные товары каталога. Чтобы кэш не отдавал уже купленные позиции, настроена инвалидация при событиях оплаты или добавлении в корзину. Для запуска этой связки обязательно нужен работающий Redis на порту 6379.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill recommendation-system -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill recommendation-system -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill recommendation-system -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install secondsky/claude-skills recommendation-system
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill recommendation-system -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/secondsky/claude-skills --path plugins/recommendation-system/skills/recommendation-system
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add secondsky/claude-skills --skill recommendation-system -a opencode
```

### Claude.ai

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

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

## Когда брать
- развернуть API рекомендаций на FastAPI и Redis
- настроить многоуровневое кэширование L1 и L2
- организовать A/B-тестирование нескольких моделей рекомендаций
- решить проблему холодного старта для новых пользователей
- настроить инвалидацию кэша при оформлении заказа

## Примеры запросов агенту
- Создай сервис рекомендаций на FastAPI с кэшированием ответов в Redis на 5 минут
- Добавь fallback на популярные товары для пользователей без истории покупок
- Настрой класс FeatureStore для хранения признаков пользователей в Redis с TTL 3600

## Похожие
- [redis-observability](https://affpapa.org/nevibecode/skills/redis-observability.md) — скилл · 2300 установок
- [python-backend](https://affpapa.org/nevibecode/skills/python-backend.md) — скилл · 2200 установок
- [fastapi-microservices-serverless](https://affpapa.org/nevibecode/skills/fastapi-microservices-serverless.md) — скилл · 724 установки
- [microservices](https://affpapa.org/nevibecode/skills/microservices.md) — скилл · 722 установки
- [recommendations](https://affpapa.org/nevibecode/skills/recommendations.md) — скилл · ★ 27
- [recommendation-canvas](https://affpapa.org/nevibecode/skills/recommendation-canvas.md) — скилл · 2100 установок

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

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

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