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

concurrency — правило для Claude Code: что проверяет и как установить

Правило concurrency для Claude Code задаёт требования к многопоточности в Java-коде. Оно охватывает пулы потоков, блокировки, общие данные и другие источники ошибок конкурентного доступа.

MIT ★ 517 обновлён 2026-11-16

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/concurrency.md
Открыть на GitHub

Что делает concurrency

Правило помогает агенту находить ошибки многопоточности в Java-коде и предлагать безопасные варианты. Оно запрещает создавать пулы через Executors и запускать потоки напрямую, требует согласованного порядка блокировок и потокобезопасных singleton-объектов.

Также правило охватывает изменение одной записи из нескольких потоков, атомарность операций «проверка — действие» и условия выхода из циклов при высокой конкуренции. Для форматирования дат оно рекомендует DateTimeFormatter, а в JDK 7 и новее — ThreadLocalRandom вместо общего Random. Установить файл можно по пути .claude/rules/concurrency.md.

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

  • задать параметры пула потоков явно
  • предотвратить взаимную блокировку ресурсов
  • защитить запись от одновременного изменения
  • сделать операцию проверки и изменения атомарной
  • избежать небезопасного общего Random

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

  • Проверь многопоточность в этом Java-классе.
  • Найди в коде небезопасное создание потоков и пулов.
  • Проверь блокировки и конкурентное изменение записей.

Как установить concurrency

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

.claude/rules/concurrency.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о concurrency

Как установить concurrency в Claude Code?

Добавь файл правила по пути .claude/rules/concurrency.md.

Что делает правило concurrency?

Описывает требования к потокам, блокировкам и конкурентному доступу в Java. Среди прочего, оно запрещает создавать потоки напрямую и требует безопасного порядка захвата нескольких блокировок.

Какие правила concurrency задаёт для работы с датами и случайными числами?

Для дат рекомендуется DateTimeFormatter вместо общего SimpleDateFormat. В JDK 7 и новее следует использовать ThreadLocalRandom, а не разделять один Random между потоками.

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

concurrency.md · MIT
# Concurrency guidelines

## Thread pool creation
**Detection mode**: semantic

**Do not create thread pools with Executors (MULT-CONC-001):**

```java
// Wrong: may cause OOM
ExecutorService executor = Executors.newFixedThreadPool(10);

// Correct: set all parameters explicitly
ThreadPoolExecutor executor = new ThreadPoolExecutor(
    10,  // corePoolSize
    20,  // maximumPoolSize
    60L, // keepAliveTime
    TimeUnit.SECONDS,
    new LinkedBlockingQueue<>(1000),
    new ThreadFactoryBuilder().setNameFormat("worker-%d").build(),
    new ThreadPoolExecutor.CallerRunsPolicy()
);
```

## SimpleDateFormat thread safety
**Detection mode**: semantic

```java
// Wrong: not thread-safe
private static final SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");

// Correct option 1: ThreadLocal
private static final ThreadLocal<SimpleDateFormat> sdf = 
    ThreadLocal.withInitial(() -> new SimpleDateFormat("yyyy-MM-dd"));

// Correct option 2: use Java 8 DateTimeFormatter (recommended)
private static final DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
```

## Lock ordering
**Detection mode**: semantic

**Locking multiple resources must follow a consistent order to prevent deadlocks (MULT-CONC-002):**

```java
// Wrong: may deadlock
public void transfer(Account from, Account to, int amount) {
    synchronized (from) {
        synchronized (to) {
            from.debit(amount);
            to.credit(amount);
        }
    }
}

// Correct: lock in a fixed order
public void transfer(Account from, Account to, int amount) {
    Account first = from.getId() < to.getId() ? from : to;
    Account second = from.getId() < to.getId() ? to : from;
    synchronized (first) {
        synchronized (second) {
            from.debit(amount);
            to.credit(amount);
        }
    }
}
```

## Concurrent modification
**Detection mode**: semantic

**Concurrent modification of the same record must use a lock or optimistic locking (MULT-CONC-003):**

```java
// Optimistic locking approach
@Update("UPDATE account SET balance = #{balance}, version = version + 1 WHERE id = #{id} AND version = #{version}")
int updateWithVersion(Account account);

// Retry logic (at least 3 times)
int retry = 0;
while (retry < 3) {
    Account account = accountDao.getById(id);
    int updated = accountDao.updateWithVersion(account);
    if (updated > 0) {
        break;
    }
    retry++;
}
```

## TOCTOU protection
**Detection mode**: semantic

**Check-Then-Act operations must be atomic (MULT-CONC-012):**

```java
// Wrong: non-atomic operation
if (account.getBalance() >= amount) {  // Check
    account.debit(amount);  // Act - the balance may have changed!
}

// Correct: use a database optimistic lock or distributed lock
@Update("UPDATE account SET balance = balance - #{amount} WHERE id = #{id} AND balance >= #{amount}")
int debitWithCheck(@Param("id") Long id, @Param("amount") Long amount);
```

## High-concurrency optimization
**Detection mode**: semantic

**In high-concurrency code, do not use equality checks as interruption/exit conditions (MULT-CONC-004):**

```java
// Wrong: may loop forever
while (count == 0) {
    // may never exit
}

// Correct: use a range check
while (count > 0) {
    // explicit exit condition
}
```

## Singleton thread safety
**Detection mode**: semantic

**Singleton objects must be thread-safe (MULT-CONC-005):**

```java
// Double-checked locking (requires volatile)
public class Singleton {
    private static volatile Singleton instance;
    
    private Singleton() { }
    
    public static Singleton getInstance() {
        if (instance == null) {
            synchronized (Singleton.class) {
                if (instance == null) {
                    instance = new Singleton();
                }
            }
        }
        return instance;
    }
}
```

## Thread resources
**Detection mode**: semantic

**Thread resources must be provided through thread pools; do not create threads explicitly (MULT-CONC-007):**

```java
// Wrong
new Thread(new Runnable() {
    @Override
    public void run() { }
}).start();

// Correct
executor.execute(() -> {
    // ...
});
```

## Random in multithreaded code
**Detection mode**: semantic

**Avoid sharing Random across threads; on JDK 7+ use ThreadLocalRandom (MULT-CONC-011):**

```java
// Wrong
Random random = new Random();
int value = random.nextInt(100);

// Correct
int value = ThreadLocalRandom.current().nextInt(100);
```

© kyy-logs · MIT · kyy-logs/code-review-gate-skill

Похожие правила IDE

Все правила IDE по теме «Код-ревью и рефакторинг» →
125-java-concurrency Juan Antonio Breña Moral Скилл 125-java-concurrency для ИИ-агента, который разбирает Java-код на гонки, блокировки и утечки потоков и предлагает правки по современным средствам java.util.concurrent. CX Codex +1 432установок concurrency-review decebals Скилл concurrency-review находит гонки данных, блокировки и скрытые дефекты многопоточности в коде на Java. Проверяет как классические примитивы синхронизации, так и Virtual Threads. CX Codex +1 404установок java-concurrency pluginagentmarketplace Скилл java-concurrency для Claude Code: работа с многопоточностью Java от базовых потоков до виртуальных потоков Java 21, пулов потоков, синхронизации и CompletableFuture. CX Codex +1 468установок csharp-concurrency-patterns Aaronontheweb Скилл csharp-concurrency-patterns помогает агенту выбирать подходящие абстракции многопоточности в .NET: от async/await до Channels и Akka.NET. Пригодится при проектировании очередей и избавлении от блокировок. CX Codex +1 1 600установок golang-concurrency samber Скилл golang-concurrency задаёт правила для конкурентного кода на Go: жизненный цикл горутин, каналы и select, мьютексы, errgroup, singleflight, воркер-пулы и fan-out/fan-in пайплайны. CX Codex +1 44 500установок swift-concurrency AvdLee Скилл swift-concurrency для Claude Code разбирает ошибки Swift Concurrency и предлагает безопасные исправления. Он включается при миграции на Swift 6 и работе с задачами, акторами и Sendable. CX Codex +1 17 700установок

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

Весь набор →
index Правило index для Claude Code описывает состав набора правил проверки кода и порядок их поиска. Проектный набор заменяет встроенный целиком, а не дополняет его. CX Codex +1 ★ 517звёзд репо baseline-java Правило baseline-java для Claude Code добавляет проверки безопасности, многопоточности и обработки исключений в Java. Агент применяет его при разборе Java-кода. CX Codex +1 ★ 517звёзд репо spring-performance Правило spring-performance для Claude Code задаёт практики Spring/JPA и оптимизации производительности. Агент применяет их при работе с Java-кодом и запросами к базе данных. CX Codex +1 ★ 517звёзд репо spring-performance Правило spring-performance для Claude Code задаёт проверки Spring/JPA и производительности. Оно помогает находить ошибки валидации, транзакциях, запросах и пакетной обработке. CX Codex +1 ★ 517звёзд репо exception-logging Правило exception-logging для Claude Code проверяет обработку исключений и логирование в коде на Java. Контролирует пустые блоки catch, вызовы SLF4J, маскирование данных и откат транзакций. CX Codex +1 ★ 517звёзд репо naming-format Правило naming-format для Claude Code задаёт соглашения об именах и форматировании Java-кода. Оно охватывает классы, методы, константы и управляющие конструкции. CX Codex +1 ★ 517звёзд репо testing-engineering Правило testing-engineering для Claude Code задаёт требования к юнит-тестам, архитектуре проекта и зависимостям. Оно охватывает проектирование слоёв, обработку исключений и соглашения для моделей данных. CX Codex +1 ★ 517звёзд репо code-review-gate Скилл code-review-gate для Claude Code проверяет изменения в коде перед коммитом или слиянием PR. Агент собирает diff, запускает проверки и фиксирует найденные проблемы. CX Codex +1 ★ 517звёзд репо

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

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