python-scala-idioms — скилл для Claude Code: суть и установка
Скилл python-scala-idioms помогает переводить код с Python на чистый и идиоматичный Scala. Фокусируется на неизменяемости, сопоставлении с образцом и безопасной работе с типами.
Apache-2.0 1 установок ★ 1 933 обновлён 2026-10-24
npx skills add benchflow-ai/skillsbench --skill python-scala-idioms -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/python-scala-idioms/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/python-scala-idioms/
1Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill python-scala-idioms -a codex2Вручную: положить файлы
.agents/skills/python-scala-idioms/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill python-scala-idioms -a cursor2Вручную: положить файлы
.cursor/skills/python-scala-idioms/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install benchflow-ai/skillsbench tasks/python-scala-translation/environment/skills/python-scala-idioms2Вручную: положить файлы
.github/skills/python-scala-idioms/SKILL.md1Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill python-scala-idioms -a gemini-cli2Командой платформы
gemini skills install https://github.com/benchflow-ai/skillsbench --path tasks/python-scala-translation/environment/skills/python-scala-idiomsВручную: положить файлы
.devin/skills/python-scala-idioms/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill python-scala-idioms -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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