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

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

Правило benchmarking для Claude Code учит агента писать корректные тесты производительности .NET через BenchmarkDotNet. Тесты измеряют скорость кода и отслеживают регрессии.

Apache-2.0 ★ 138 обновлён 2025-03-29

Установить в Cursor · Вручную: положить файлы Все способы и платформы ↓
.cursor/rules/benchmarking.mdc
Открыть на GitHub

Что делает benchmarking

Правило объясняет, как настроить проект для бенчмарков, добавить атрибуты [MemoryDiagnoser] и [Params], написать методы с [Benchmark] и отследить аллокации. Агент узнаёт, что для измерения памяти нужен MemoryDiagnoser, для сравнения версий .NET — [SimpleJob(RuntimeMoniker.Net80)], а для SIMD — RyuJitX64Job. Описаны примеры бенчмарков строк, векторных операций и async-методов.

Правило требует методы [IterationSetup] и [IterationCleanup] объявлять с возвращаемым типом void — это условие библиотеки BenchmarkDotNet версий до 14.0. Без соблюдения сигнатуры бенчмарк не запустится. Показано, как интегрировать запуск в CI/CD и выгружать результаты артефактами.

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

  • написать бенчмарк с параметрами и замером памяти
  • сравнить производительность нескольких реализаций
  • настроить проект для BenchmarkDotNet
  • отследить регрессии производительности в CI
  • измерить влияние SIMD-оптимизаций

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

  • Напиши бенчмарк для сравнения конкатенации строк и StringBuilder с параметром от 10 до 1000 итераций
  • Добавь MemoryDiagnoser и RankColumn в класс бенчмарка
  • Создай .cursor/rules/benchmarking.mdc с правилами для тестов производительности .NET

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

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

.cursor/rules/benchmarking.mdc

Во frontmatter: description, globs, alwaysApply

По шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules

Вопросы о benchmarking

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

Сохрани правило в .claude/rules/benchmarking.md в корне проекта.

Что делает benchmarking?

Правило учит агента писать бенчмарки .NET через BenchmarkDotNet: настраивать проект, добавлять атрибуты [MemoryDiagnoser], [Benchmark], параметры [Params], отслеживать аллокации и интегрировать запуск в CI.

Зачем требование void для методов [IterationSetup]?

BenchmarkDotNet версий до 14.0 требует, чтобы методы с [IterationSetup] и [IterationCleanup] возвращали void. Другая сигнатура приведёт к ошибке запуска бенчмарка.

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

benchmarking.mdc · Apache-2.0
---
description: Designing benchmarks for measuring .NET performance
globs: 
alwaysApply: false
---
# Cursor Rules File: .NET Benchmarking Best Practices
# This file provides guidelines for writing effective benchmarks using BenchmarkDotNet
# and other performance testing tools.

Role Definition:
 - Performance Engineer
 - .NET Runtime Specialist
 - Optimization Expert

General:
  Description: >
    Performance testing and benchmarking should be systematic, reproducible,
    and provide meaningful insights. Use BenchmarkDotNet as the primary tool
    for micro-benchmarking and performance regression testing.
  Requirements:
    - Use BenchmarkDotNet for micro-benchmarks
    - Ensure consistent test environments
    - Follow scientific method
    - Track performance metrics over time
    - Consider memory and allocation patterns

Project Setup:
  - Configure benchmark projects:
      ```xml
      <Project Sdk="Microsoft.NET.Sdk">
        <PropertyGroup>
          <OutputType>Exe</OutputType>
          <TargetFramework>net8.0</TargetFramework>
          <Configuration>Release</Configuration>
          <Optimize>true</Optimize>
          <DebugSymbols>false</DebugSymbols>
        </PropertyGroup>
        
        <ItemGroup>
          <PackageReference Include="BenchmarkDotNet" Version="0.13.10" />
          <PackageReference Include="BenchmarkDotNet.Diagnostics.Windows" Version="0.13.10" 
              Condition="'$(OS)' == 'Windows_NT'" />
        </ItemGroup>
      </Project>
      ```

Benchmark Structure:
  - Basic benchmark setup:
      ```csharp
      [MemoryDiagnoser]
      [RankColumn, MinColumn, MaxColumn, MeanColumn, MedianColumn]
      public class StringOperationsBenchmarks
      {
          private const string TestString = "Hello, World!";
          private readonly StringBuilder _builder = new();
          
          [Params(10, 100, 1000)]
          public int Iterations { get; set; }
          
          [GlobalSetup]
          public void Setup()
          {
              // Setup code that runs once before all benchmarks
          }
          
          [Benchmark(Baseline = true)]
          public string StringConcat()
          {
              var result = string.Empty;
              for (int i = 0; i < Iterations; i++)
                  result += TestString;
              return result;
          }
          
          [Benchmark]
          public string StringBuilder()
          {
              _builder.Clear();
              for (int i = 0; i < Iterations; i++)
                  _builder.Append(TestString);
              return _builder.ToString();
          }
      }
      ```

Memory Analysis:
  - Track allocations and GC:
      ```csharp
      [MemoryDiagnoser]
      [GcServer(true)]
      public class MemoryBenchmarks
      {
          [Benchmark]
          public IEnumerable<string> AllocatingMethod()
          {
              return Enumerable.Range(0, 1000)
                  .Select(i => i.ToString());
          }
          
          [Benchmark]
          public IEnumerable<string> NonAllocatingMethod()
          {
              return Enumerable.Range(0, 1000)
                  .Select(i => i.ToString())
                  .ToArray();
          }
      }
      ```

Hardware Intrinsics:
  - Measure SIMD performance:
      ```csharp
      [SimpleJob(RuntimeMoniker.Net80)]
      [RyuJitX64Job]
      public class VectorBenchmarks
      {
          private float[] _data;
          
          [GlobalSetup]
          public void Setup()
          {
              _data = new float[1024];
              // Initialize data
          }
          
          [Benchmark(Baseline = true)]
          public float ScalarSum()
          {
              float sum = 0;
              for (int i = 0; i < _data.Length; i++)
                  sum += _data[i];
              return sum;
          }
          
          [Benchmark]
          public float VectorSum()
          {
              return Vector.Sum(_data);
          }
      }
      ```

Async Performance:
  - Benchmark async operations:
      ```csharp
      public class AsyncBenchmarks
      {
          private HttpClient _client;
          
          [GlobalSetup]
          public void Setup()
          {
              _client = new HttpClient();
          }
          
          [Benchmark]
          public async Task<string> SingleRequest()
          {
              return await _client.GetStringAsync("http://example.com");
          }
          
          [Benchmark]
          public async Task<string[]> ParallelRequests()
          {
              var tasks = Enumerable.Range(0, 10)
                  .Select(_ => _client.GetStringAsync("http://example.com"))
                  .ToArray();
              
              return await Task.WhenAll(tasks);
          }
      }
      ```

CI/CD Integration:
  - Configure benchmark runs:
      ```yaml
      - name: Run Benchmarks
        run: |
          dotnet run -c Release --filter '*'
      
      - name: Store Results
        uses: actions/upload-artifact@v3
        with:
          name: benchmark-results
          path: BenchmarkDotNet.Artifacts/**
      ```
  - Track performance over time:
      ```csharp
      [Config(typeof(RegressionConfig))]
      public class RegressionBenchmarks
      {
          private class RegressionConfig : ManualConfig
          {
              public RegressionConfig()
              {
                  AddExporter(MarkdownExporter.GitHub);
                  AddDiagnoser(MemoryDiagnoser.Default);
                  AddColumn(StatisticColumn.Median);
                  AddColumn(RankColumn.Arabic);
              }
          }
      }
      ```

Best Practices:
  - Avoid common pitfalls:
      ```csharp
      // Good: Proper benchmark isolation
      [IterationSetup]
      public void IterationSetup()
      {
          _data = new byte[1024];  // Fresh data for each iteration
      }
      
      // Avoid: Shared state between iterations
      private byte[] _sharedData = new byte[1024];  // Can lead to false results
      ```
  - Use appropriate job configurations:
      ```csharp
      [SimpleJob(RuntimeMoniker.Net80, baseline: true)]
      [SimpleJob(RuntimeMoniker.Net70)]
      [SimpleJob(RuntimeMoniker.Net60)]
      public class CrossVersionBenchmarks
      {
          [Benchmark]
          public void BenchmarkMethod() { }
      }
      ```
  - Document environment requirements:
      ```csharp
      /*
      ## Required Environment
      - Windows 10+ or Linux with perf_event_paranoid <= 2
      - CPU: Modern x64 processor with AVX2 support
      - RAM: 16GB minimum
      - Minimal background processes
      */
      ```

### IterationSetup and IterationCleanup Method Signatures

**Library Name**: BenchmarkDotNet
**Programming Language**: C#
**Library Version**: (,14.0]
**Severity**: Error (must be followed)

#### Rule Description
Always make sure to use `void` methods when defining `IterationSetup` or `IterationCleanup` activities for BenchmarkDotNet classes.

#### Good Examples
```csharp
// Good
[IterationSetup]
public void DoSetup()
{
}

[IterationCleanup]
public void DoCleanup()
{
}
```

#### Bad Examples
```csharp
// Bad - will throw runtime exception
[IterationSetup]
public async Task DoSetup()
{
}

[IterationCleanup]
public async Task DoCleanup()
{
}
```

#### Rationale
While async Task methods will compile, BenchmarkDotNet will throw a runtime exception when these methods are used. The framework requires these methods to be void methods to function properly. 


# End of Cursor Rules File 

© Aaronontheweb · Apache-2.0 · Aaronontheweb/dotnet-cursor-rules

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

Все правила IDE по теме «Тесты и QA» →
microbenchmarking dotnet Скилл microbenchmarking для Claude Code создаёт, настраивает и проверяет микробенчмарки .NET с BenchmarkDotNet. Сравнивает реализации и измеряет производительность. CX Codex +1 4 500установок migrate-vstest-to-mtp dotnet Скилл migrate-vstest-to-mtp помогает перевести тестовые проекты .NET с VSTest на Microsoft.Testing.Platform: правит Directory.Build.props, global.json и аргументы dotnet test. CX Codex +1 4 300установок build-fix codewithmukesh Скилл build-fix запускает автономный цикл починки сборки и тестов в проектах на .NET. Скилл разбирает ошибки компилятора, исправляет код и останавливается при регрессиях. CX Codex +1 4 000установок dotnet-slopwatch Aaronontheweb Скилл dotnet-slopwatch отслеживает уловки нейросетей при правке кода C#: пропуск упавших тестов, скрытие предупреждений и пустые блоки catch. Он запускает утилиту slopwatch для защиты проекта от фиктивных правок. CX Codex +1 593установок hyperfine-benchmarking akillness Скилл hyperfine-benchmarking для Claude Code запускает команды с прогревом и собирает статистику времени выполнения. Помогает сравнить варианты инструментов или валидировать изменения производительности перед PR с доказательствами. CX Codex +1 251установок modern-csharp-coding-standards Aaronontheweb Скилл modern-csharp-coding-standards задаёт правила современного C# 12+: неизменяемые рекорды, pattern matching, структуры Span<T> и асинхронный код без лишних аллокаций памяти. CX Codex +1 2 300установок

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

Весь набор →
code-signing Правило code-signing задаёт стандарты подписи сборок и пакетов NuGet через SignClient в проектах на .NET. Применяется при настройке CI/CD. CX Codex +1 ★ 138звёзд репо consuming-dotnettool Правило consuming-dotnettool для Claude Code организует локальные .NET-инструменты через manifest-файл, фиксирует версии и добавляет их восстановление в CI/CD. CX Codex +1 ★ 138звёзд репо dependency-management Правило dependency-management для безопасного управления NuGet-зависимостями: проверка уязвимостей, совместимость лицензий, версионирование через dotnet CLI. Применяется к файлам проекта автоматически. CX Codex +1 ★ 138звёзд репо solution-management Правило solution-management задаёт стандарты организации решений .NET: фиксирует версии SDK, общие свойства сборки и централизованное управление NuGet-пакетами. CX Codex +1 ★ 138звёзд репо nuget-package-publishing Правило nuget-package-publishing, которое учит агента упаковывать .NET-библиотеки в NuGet по стандартам: с SPDX-лицензией, README и символами для отладки. CX Codex +1 ★ 138звёзд репо testing Правило testing задаёт стандарты написания тестов на C# с xUnit: настройку .NET 8 проектов, фикстуры, проверку покрытия кода и запуск интеграционных тестов. CX Codex +1 ★ 138звёзд репо coding-style Правило coding-style задаёт рекомендации по структуре и стилю C#-кода: от типов данных до обработки ошибок. Оно пригодится, если вы хотите, чтобы агент придерживался функциональных паттернов и простых абстракций. CX Codex +1 ★ 138звёзд репо dotnet-build Правило dotnet-build задаёт, как в .NET-репозитории устроена сборка: голый dotnet CLI, версии из RELEASE_NOTES.md, отдельные скрипты под тесты и релиз. CX Codex +1 ★ 138звёзд репо

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

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