doc/AI/dev/metrics.md
2026-02-01 15:13:20 +03:00

2.5 KiB
Raw Blame History

metrics

LOC

  • не более 1 000 (1500) строк на модуль с учетом коментариев. Это с учётом всего, ограничение на размер файла. Это ограничение связяно с ограничением на Read tool в 25000 токенов, и в целом у нейросетей контекст ограничен, поэтому чем меньше файлы, тем больше шансов что ему потребуется читать из не все. А значит лучше иметь много маленьких файлов. Ну и в целом если он не сможет целиком прочитать файл, то не получится ему сделать согласованные правки в нём.

MR

  • MR Количество строк кода (Lines of Code, LOC) в одном MR (Merge Request) — это метрика, показывающая объем добавленных, измененных или удаленных строк в рамках одного запроса на слияние. Это индикатор сложности, качества и времени, необходимого для код-ревью. Небольшие MR (до 200300 строк) считаются лучшей практикой, так как их легче проверять, они содержат меньше ошибок и конфликтов.

показатель означает:

  • Размер изменений: Чем больше строк, тем масштабнее изменения.
  • Сложность код-ревью: Огромные MR (тысячи строк) часто проверяются поверхностно, что повышает риск пропуска багов.
  • Качество и читаемость: Большой объем кода часто свидетельствует о необходимости его декомпозиции (разбиения на более мелкие части).
  • Трудозатраты: Часто используется для предварительной оценки объема работы.

Рекомендации по количеству строк:

  • Идеально: 50100 строк (легко проверить за 15-20 минут).
  • Приемлемо: До 200300 строк.
  • Плохо: Более 5001000 строк (требует разбиения на несколько самостоятельных MR).