Маркери згенерованого коду (AI Code Smells)(AI Code Smells: як за 5 секунд розпізнати сирий код від нейромережі)

1. Огляд концепції та призначення

Будь-який досвідчений Senior-інженер під час співбесіди чи аудиту репозиторію може за 5 секунд сказати: «Цей код написала людина, яка розуміє, що робить, а цей — просто сліпо скопіювали з чат-бота без жодного рев'ю».

Штучний інтелект пише швидко, але він має специфічні манери та «шкідливі звички», які в індустрії називають AI Code Smells.

Знати ці маркери необхідно кожному новачку: це допоможе вам вчасно очищати проект від синтетичного сміття і виглядати професійним розробником в очах колег та замовників.

2. Головні маркери коду від нейромережі

┌─────────────────────────────────────────────────────────────┐
│                 ТОП-4 МАРКЕРИ «AI CODE SMELLS»              │
├─────────────────────────────────────────────────────────────┤
│ 1. 📢 Банальні коментарі-капітани:                          │
│    // Присвоюємо значення змінній a                         │
│    const a = 10; // Це число десять                         │
├─────────────────────────────────────────────────────────────┤
│ 2. 🖨️ Дублювання утиліт у кожному файлі:                   │
│    Замість імпорту спільної функції `formatDate()` ШІ копіює│
│    однакову функцію на 15 рядків у 7 різних компонентів     │
├─────────────────────────────────────────────────────────────┤
│ 3. 🙈 Порожні блоки поглинання помилок:                     │
│    try { doSomething(); } catch (e) { /* нічого не робимо */│
│    (Помилка стається, але ви ніколи про неї не дізнаєтеся)  │
├─────────────────────────────────────────────────────────────┤
│ 4. 🤹 Гіперускладнення простих речей:                       │
│    Створення 3 класів, фабрики та інтерфейсу заради однієї  │
│    математичної операції додавання двох чисел               │
└─────────────────────────────────────────────────────────────┘

3. Як перетворити синтетичний код на професійний

Порівняйте два фрагменти коду:

❌ До (Типовий сирий вивід ШІ):

// Функція, яка перевіряє користувача
function checkUser(user: any) {
  try {
    // Якщо користувач існує
    if (user != null) {
      // Повертаємо істину
      return true;
    }
  } catch (err) {
    console.log("Помилка");
  }
  return false;
}

✅ Після (Очищений інженерний код):

export function isUserActive(user: User | null): boolean {
  return Boolean(user?.isActive);
}

4. Чек-лист очищення проекту перед релізом

• Видаліть усі очевидні коментарі, які повторюють те, що й так написано в назві змінної.
• Перевірте типи: замініть усі недбалі any на конкретні типи TypeScript.
• Винесіть повторювані шматки коду в окрему папку src/lib чи src/utils.
• Переконайтеся, що всі повідомлення про помилки дійсно логуються, а не ховаються у порожніх блоках catch.