Основной агент проверки

Общий Ревьюер

Обнаруживает то, что не подходит больше ничему

Не все проблемы — это баги безопасности или проблемы производительности. Общий Ревьюер обнаруживает сквозные проблемы — соглашения проекта, чистоту git и клей, который держит кодовые базы вместе.

Что обнаруживает Общий Ревьюер

"Всё остальное", которое держит проекты организованными

Соглашения проекта

Структура файлов, шаблоны именования и стандарты, специфичные для проекта, чтобы держать код в порядке

Правила именованияСтруктура папокПорядок импортовШаблоны конфигурации

Практики Git и Workflow

Чистота коммитов, именование веток и лучшие практики для PR

Формат сообщенийИменование ветокРазмер PRСтратегия слияния

Сквозные проблемы

Проблемы, которые охватывают несколько областей — ни безопасность, ни производительность, но все же важные

Консистентность конфигурацииУправление окружениемFeature flagsШаблоны логирования

Сквозные проблемы

Проблемы, которые охватывают несколько областей, но не подходят специализированным агентам

Логирование

Согласованные уровни и форматы логов по всему приложению

Обработка ошибок

Унифицированные типы ошибок и шаблоны报告

Feature Flags

Согласованная проверка флагов и очистка

Интернационализация

Надлежащее использование и организация ключей i18n

События Analytics

Согласованное именование событий и свойств

Конфигурация окружения

Централизованная и type-safe конфигурация

Держать проекты организованными

Реальные примеры улучшений на уровне проекта

Формат сообщений коммитов

Непоследовательно
git commit -m "fix"
git commit -m "updates"
git commit -m "WIP"
git commit -m "asdfasdf"

Расплывчатые сообщения делают историю бесполезной

Организовано
git commit -m "fix(auth): handle expired token refresh"
git commit -m "feat(api): add pagination to users endpoint"
git commit -m "docs: update README with new env vars"
git commit -m "refactor(db): extract query builders"

Следуйте conventional commits для четкой истории

Организация файлов

Непоследовательно
src/
  UserComponent.tsx
  userUtils.ts
  USER_CONSTANTS.ts
  user-types.ts
  userApi.tsx      # Почему .tsx для API?
  UserHelpers.ts

Непоследовательное именование и плоская структура

Организовано
src/features/users/
  components/
    UserCard.tsx
    UserList.tsx
  hooks/
    useUser.ts
  api/
    users.api.ts
  types/
    user.types.ts
  constants/
    user.constants.ts

Следуйте организации по функциям с согласованным именованием

Конфигурация окружения

Непоследовательно
// Разбросано по всей кодовой базе
const API_URL = process.env.API_URL || 'http://localhost:3000'

// В другом файле
const apiBase = process.env.NEXT_PUBLIC_API_URL

// Еще в другом файле
if (process.env.NODE_ENV === 'production') {
  baseUrl = 'https://api.example.com'
}

Переменные окружения разбросаны, управление непоследовательно

Организовано
// src/config/env.ts
export const config = {
  api: {
    baseUrl: requiredEnv('API_URL'),
    timeout: optionalEnv('API_TIMEOUT', 5000),
  },
  features: {
    analytics: boolEnv('ENABLE_ANALYTICS', false),
  },
} as const

// Использование везде
import { config } from '@/config/env'
fetch(config.api.baseUrl + '/users')

Централизованная конфигурация с type-safe доступом

Анализ на уровне проекта

Как работает Общий Ревьюер

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

Знание структуры

Понимает организационные шаблоны вашего проекта

Проверка workflow

Валидирует практики git и чистоту PR

Применение соглашений

Применяет специфичные для проекта правила последовательно

Pipeline анализа

1

Загрузить правила

Понимает соглашения и стандарты, специфичные для вашего проекта

2

Анализировать изменения

Проверяет код согласно шаблонам проекта

3

Проверить сквозные аспекты

Обнаруживает проблемы, которые охватывают несколько областей

4

Предложить выравнивание

Помогает коду вписаться в общую структуру проекта

Клей, который держит всё вместе

Специализированные агенты обнаруживают специализированные проблемы. Общий Ревьюер обнаруживает всё остальное.

Согласованный стиль

Каждый файл следует одним и тем же соглашениям, делая навигацию интуитивной

Чистая история

История Git, которая рассказывает историю, а не беспорядок из коммитов "fix"

Унифицированная конфигурация

Окружение и конфигурация управляются последовательно везде

Специалисты управляют глубокими проблемами.
Общий Ревьюер управляет всем остальным между ними.

Полное покрытие
Каждого PR

Общий Ревьюер заполняет пробелы, оставленные специализированными агентами. Бесплатно в течение 14 дней, кредитная карта не требуется.

Проверка соглашений
Чистота Git
Сквозные проблемы