К основному содержанию
скилл CX Codex

python-scala-idioms — скилл для Claude Code: суть и установка

Скилл python-scala-idioms помогает переводить код с Python на чистый и идиоматичный Scala. Фокусируется на неизменяемости, сопоставлении с образцом и безопасной работе с типами.

Apache-2.0 1 установок ★ 1 933 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add benchflow-ai/skillsbench --skill python-scala-idioms -a claude-code
Открыть на GitHub

Что делает python-scala-idioms

Этот скилл даёт ассистенту правила трансформации скриптового стиля Python в функциональный и типобезопасный стиль Scala. Вместо дословного переноса циклов и классов скилл нацеливает модель на работу с выражениями, замену цепочек if-else на сопоставление с образцом и отказ от прямых проверок null в пользу Option, Either и Try.

Внутри заложены готовые шаблоны перевода: генераторы списков заменяются на map и filter, изменяемые счётчики — на case class с методом copy, а словари со строковыми статусами — на запечатанные трейты sealed trait для исчерпывающего перебора вариантов компилятором. При этом скилл требует избегать Any и isInstanceOf, принуждая помощника соблюдать соглашения о регистре camelCase и CamelCase.

Инструкции рассчитаны на функциональный стиль стандартной библиотеки Scala. Если целевой проект намеренно использует мутабельные структуры ради выжимания наносекунд, рекомендации скилла вступят в конфликт с такой архитектурой.

Какие задачи решает

  • переписать скрипт на Python в идиоматичный функциональный код на Scala
  • заменить проверки на None цепочками с Option или for-comprehension
  • спроектировать доменную модель через sealed trait вместо строковых констант
  • сконвертировать изменяемые циклы-накопители в методы коллекций foldLeft и filter

Примеры запросов агенту

  • Перепиши этот скрипт обработки заказов с Python на идиоматичный Scala без мутабельных структур
  • Сконвертируй класс с проверками if method == 'crypto' в иерархию sealed trait на Scala
  • Переведи функцию с цепочкой проверок на None в код на Scala с Option и flatMap

Как установить python-scala-idioms

1Через Skills CLI (Vercel)

npx skills add benchflow-ai/skillsbench --skill python-scala-idioms -a claude-code

2Вручную: положить файлы

~/.claude/skills/python-scala-idioms/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/python-scala-idioms/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о python-scala-idioms

Как установить python-scala-idioms в Claude Code?

Выполните в терминале команду npx skills add benchflow-ai/skillsbench --skill python-scala-idioms -a claude-code. Либо вручную скопируйте файл спецификации по пути ~/.claude/skills/python-scala-idioms/SKILL.md.

Зачем нужен этот скилл, если модель уже умеет писать на Scala?

Без явных ограничений нейросеть часто делает буквальный подстрочный перевод с Python: оставляет мутабельные переменные var, циклы while и проверки на null. Скилл заставляет генерировать код с учётом системы типов, case class и неизменяемых коллекций.

Как скилл обрабатывает функции, которые в Python возвращают None?

Вместо пустого типа Unit он предлагает возвращать информативные результаты вроде Either[Error, UserId] или оборачивать вызов в Try, чтобы явно передавать контекст ошибок.

Исходный текст

SKILL.md · Apache-2.0
---
name: python-scala-idioms
description: Guide for writing idiomatic Scala when translating from Python. Use when the goal is not just syntactic translation but producing clean, idiomatic Scala code. Covers immutability, expression-based style, sealed hierarchies, and common Scala conventions.
---

# Python to Idiomatic Scala Translation

## Core Principles

When translating Python to Scala, aim for idiomatic Scala, not literal translation:

1. **Prefer immutability** - Use `val` over `var`, immutable collections
2. **Expression-based** - Everything returns a value, minimize statements
3. **Type safety** - Leverage Scala's type system, avoid `Any`
4. **Pattern matching** - Use instead of if-else chains
5. **Avoid null** - Use `Option`, `Either`, `Try`

## Immutability First

```python
# Python - mutable by default
class Counter:
    def __init__(self):
        self.count = 0

    def increment(self):
        self.count += 1
        return self.count
```

```scala
// Scala - immutable approach
case class Counter(count: Int = 0) {
  def increment: Counter = copy(count = count + 1)
}

// Usage
val c1 = Counter()
val c2 = c1.increment  // Counter(1)
val c3 = c2.increment  // Counter(2)
// c1 is still Counter(0)
```

## Expression-Based Style

```python
# Python - statement-based
def get_status(code):
    if code == 200:
        status = "OK"
    elif code == 404:
        status = "Not Found"
    else:
        status = "Unknown"
    return status
```

```scala
// Scala - expression-based
def getStatus(code: Int): String = code match {
  case 200 => "OK"
  case 404 => "Not Found"
  case _ => "Unknown"
}

// No intermediate variable, match is an expression
```

## Sealed Hierarchies for Domain Modeling

```python
# Python - loose typing
def process_payment(method: str, amount: float):
    if method == "credit":
        # process credit
        pass
    elif method == "debit":
        # process debit
        pass
    elif method == "crypto":
        # process crypto
        pass
```

```scala
// Scala - sealed trait for exhaustive matching
sealed trait PaymentMethod
case class CreditCard(number: String, expiry: String) extends PaymentMethod
case class DebitCard(number: String) extends PaymentMethod
case class Crypto(walletAddress: String) extends PaymentMethod

def processPayment(method: PaymentMethod, amount: Double): Unit = method match {
  case CreditCard(num, exp) => // process credit
  case DebitCard(num) => // process debit
  case Crypto(addr) => // process crypto
}
// Compiler warns if you miss a case!
```

## Replace Null Checks with Option

```python
# Python
def find_user(id):
    user = db.get(id)
    if user is None:
        return None
    profile = user.get("profile")
    if profile is None:
        return None
    return profile.get("email")
```

```scala
// Scala - Option chaining
def findUser(id: Int): Option[String] = for {
  user <- db.get(id)
  profile <- user.profile
  email <- profile.email
} yield email

// Or with flatMap
def findUser(id: Int): Option[String] =
  db.get(id)
    .flatMap(_.profile)
    .flatMap(_.email)
```

## Prefer Methods on Collections

```python
# Python
result = []
for item in items:
    if item.active:
        result.append(item.value * 2)
```

```scala
// Scala - use collection methods
val result = items
  .filter(_.active)
  .map(_.value * 2)
```

## Avoid Side Effects in Expressions

```python
# Python
items = []
for x in range(10):
    items.append(x * 2)
    print(f"Added {x * 2}")
```

```scala
// Scala - separate side effects
val items = (0 until 10).map(_ * 2).toList
items.foreach(x => println(s"Value: $x"))

// Or use tap for debugging
val items = (0 until 10)
  .map(_ * 2)
  .tapEach(x => println(s"Value: $x"))
  .toList
```

## Use Named Parameters for Clarity

```python
# Python
def create_user(name, email, admin=False, active=True):
    pass

user = create_user("Alice", "[email protected]", admin=True)
```

```scala
// Scala - named parameters work the same
def createUser(
  name: String,
  email: String,
  admin: Boolean = false,
  active: Boolean = true
): User = ???

val user = createUser("Alice", "[email protected]", admin = true)

// Case class with defaults is often better
case class User(
  name: String,
  email: String,
  admin: Boolean = false,
  active: Boolean = true
)

val user = User("Alice", "[email protected]", admin = true)
```

## Scala Naming Conventions

| Python | Scala |
|--------|-------|
| `snake_case` (variables, functions) | `camelCase` |
| `SCREAMING_SNAKE` (constants) | `CamelCase` or `PascalCase` |
| `PascalCase` (classes) | `PascalCase` |
| `_private` | `private` keyword |
| `__very_private` | `private[this]` |

```python
# Python
MAX_RETRY_COUNT = 3
def calculate_total_price(items):
    pass

class ShoppingCart:
    def __init__(self):
        self._items = []
```

```scala
// Scala
val MaxRetryCount = 3  // or final val MAX_RETRY_COUNT
def calculateTotalPrice(items: List[Item]): Double = ???

class ShoppingCart {
  private var items: List[Item] = Nil
}
```

## Avoid Returning Unit

```python
# Python - None return is common
def save_user(user):
    db.save(user)
    # implicit None return
```

```scala
// Scala - consider returning useful information
def saveUser(user: User): Either[Error, UserId] = {
  db.save(user) match {
    case Right(id) => Right(id)
    case Left(err) => Left(err)
  }
}

// Or at minimum, use Try
def saveUser(user: User): Try[Unit] = Try {
  db.save(user)
}
```

## Use Apply for Factory Methods

```python
# Python
class Parser:
    def __init__(self, config):
        self.config = config

    @classmethod
    def default(cls):
        return cls(Config())
```

```scala
// Scala - companion object with apply
class Parser(config: Config)

object Parser {
  def apply(config: Config): Parser = new Parser(config)
  def apply(): Parser = new Parser(Config())
}

// Usage
val parser = Parser()  // Calls apply()
val parser = Parser(customConfig)
```

## Cheat Sheet: Common Transformations

| Python Pattern | Idiomatic Scala |
|---------------|-----------------|
| `if x is None` | `x.isEmpty` or pattern match |
| `if x is not None` | `x.isDefined` or `x.nonEmpty` |
| `x if x else default` | `x.getOrElse(default)` |
| `[x for x in xs if p(x)]` | `xs.filter(p)` |
| `[f(x) for x in xs]` | `xs.map(f)` |
| `any(p(x) for x in xs)` | `xs.exists(p)` |
| `all(p(x) for x in xs)` | `xs.forall(p)` |
| `next(x for x in xs if p(x), None)` | `xs.find(p)` |
| `dict(zip(keys, values))` | `keys.zip(values).toMap` |
| `isinstance(x, Type)` | `x.isInstanceOf[Type]` or pattern match |
| `try: ... except: ...` | `Try { ... }` or pattern match |
| Mutable accumulator loop | `foldLeft` / `foldRight` |
| `for i, x in enumerate(xs)` | `xs.zipWithIndex` |

## Anti-Patterns to Avoid

```scala
// DON'T: Use null
val name: String = null  // Bad!

// DO: Use Option
val name: Option[String] = None

// DON'T: Use Any or type casts
val data: Any = getData()
val name = data.asInstanceOf[String]

// DO: Use proper types and pattern matching
sealed trait Data
case class UserData(name: String) extends Data
val data: Data = getData()
data match {
  case UserData(name) => // use name
}

// DON'T: Nested if-else chains
if (x == 1) ... else if (x == 2) ... else if (x == 3) ...

// DO: Pattern matching
x match {
  case 1 => ...
  case 2 => ...
  case 3 => ...
}

// DON'T: var with mutation
var total = 0
for (x <- items) total += x

// DO: fold
val total = items.sum
// or
val total = items.foldLeft(0)(_ + _)
```

© benchflow-ai · Apache-2.0 · benchflow-ai/skillsbench

Похожие скиллы

Все скиллы по теме «Языки программирования» →
python-best-practices python-best-practices Скилл python-best-practices с 75 правилами по Python: подсказывает агенту, как писать датаклассы, интерфейсы сервисов, обработку ошибок и аннотации типов. CX Codex +1 871установок python-type-safety Seth Hobson Скилл python-type-safety помогает добавлять типы в Python-код, писать дженерики и протоколы, а также настраивать строгую проверку через mypy или pyright. CX Codex +1 12 643установок python-code-review existential-birds Скилл python-code-review проверяет файлы Python на ошибки в типах, блокирующие вызовы в async-функциях и нарушение PEP8. Пригодится при подготовке пуллреквестов и чистке кодовой базы. CX Codex +1 958установок scala-expert personamanagmentlayer Скилл scala-expert для Claude Code даёт агенту справочник по Scala перед написанием кода: от неизменяемых структур и pattern matching до монад, Akka и стримов с backpressure. CX Codex +1 226установок scala-spark официальный github Правило scala-spark для GitHub Copilot задаёт инструкции по разработке на Apache Spark в Scala. Оно помогает писать быстрые трансформации, настраивать партиционирование и избегать падений памяти. CX Codex +1 ★ 41 430звёзд репо scala-pro Seth Hobson Субагент scala-pro помогает проектировать распределённые системы на Scala 3, Pekko, Spark и настраивать функциональный код на Cats Effect или ZIO. CX Codex ★ 42 780звёзд репо

Из того же набора22

Весь набор →
text-to-speech Скилл text-to-speech помогает подготовить TTS-речь к видеомонтажу: убрать артефакты, выровнять громкость и свести сегменты по времени. CX Codex +1 4установок civ6lib Скилл civ6lib для Claude Code проверяет размещение районов в Civilization 6 и считает бонусы соседства. Анализирует карты и помогает планировать города. CX Codex +1 2установок meteorology-driver-classification Скилл meteorology-driver-classification раскладывает переменные климатического датасета по группам «тепло», «поток», «ветер» и «человек», чтобы считать вклад каждой в изменения системы. CX Codex +1 2установок scipy-curve-fit Скилл scipy-curve-fit обучает агента подбирать параметры нелинейных моделей по экспериментальным данным через scipy.optimize.curve_fit. CX Codex +1 2установок first-order-model-fitting Скилл first-order-model-fitting для Claude Code подбирает модель первого порядка по экспериментальному переходному отклику и оценивает K и tau. Анализирует тепловые, электрические и механические системы. CX Codex +1 1установок hex-grid-spatial Скилл hex-grid-spatial для Claude Code считает соседей, расстояние и клетки в радиусе на гексагональной карте с odd-r offset координатами. Используется в логике ходов и зон вокруг юнита. CX Codex +1 1установок python-scala-syntax-mapping Скилл python-scala-syntax-mapping для Claude Code сопоставляет синтаксис Python и Scala, помогая ИИ-агенту переносить функции, циклы и типы данных. CX Codex +1 1установок image-ocr Скилл image-ocr извлекает текст из изображений через Tesseract OCR и Python. Попросите агента обработать скан, скриншот или папку с картинками. CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой