Цель и границы задачи
Сравните два артефакта, выберите подходящую ветку diff для формата, проверьте структурные или семантические изменения и завершите проверкой целостности, когда для принятия нужна точность на уровне байтов.
Это руководство превращает заявленную задачу в проверяемый результат. Сохраняйте исходник, промежуточные результаты и решения, чтобы следующий участник понимал, что было проверено и почему.
Подготовьте данные и примите решения
Подготовьте два реальных входа для состояний до и после, а не только скриншоты или сводки.
Определите, что именно проверяется: точность текста, изменения структурированных данных, совместимость схемы, регрессия медиа или точная целостность.
Удалите секреты и персональные данные перед загрузкой конфигураций, API-полей или зашифрованных пакетов.
Решение: Какой тип артефакта вы на самом деле сравниваете?. Используйте ветку текста или таблиц для документов, логов, markdown, CSV или таблиц; структурированную ветку для JSON, массивов или конфигураций окружения; ветку контрактов для схем базы данных, OpenAPI или парных API-ответов; ветку медиа для PDF, изображений, аудио или адаптивных макетов; и ветку целостности, когда главный вопрос в том, совпадают ли байты, хэши или AGEX-пакеты с ожидаемым изменением.
Решение: Нужно читабельное объяснение или доказательство точного равенства?. Используйте formatter, schema, semantic или media, когда ревьюер должен понять изменение. Используйте checksum, hash или diff AGEX, когда критерий принятия зависит от бинарной точности или состояния пакета.
Выполните рабочий процесс
1. Классифицируйте пару и запустите основной diff
Начните со сравнения, наиболее близкого к реальному содержимому формата, чтобы ревьюер увидел значимые правки, а не общий бинарный конфликт. Используйте text-diff, csv-excel-diff-tool, json-diff-visualizer, pdf-diff, image-difference, audio-diff.
2. Превратите вывод в удобные для ревью изменения
Если сырой diff слишком шумный, переформатируйте или сузьте сравнение, чтобы строчные изменения, поля JSON, различия массивов и значения конфигурации стали читабельными. Используйте diff-formatter, pretty-json-diff, difference-arrays, environment-config-diff-visualizer.
3. При необходимости переходите к проверке схемы или поведения
Если главный вопрос в совместимости, а не в сыром содержимом, сравнивайте схемы базы данных, контракты OpenAPI или API-ответы, чтобы найти ломающие изменения и семантический дрейф. Используйте database-schema-diff, openapi-diff-breach-detector, api-response-diff-semantic-analyzer.
4. Перед одобрением подтвердите макет или целостность
Zavershite responsive-revyu ili proverkami na urovne baitov, esli reshение o vypuske zavisit ot vizual'nykh regressiy, tochnykh kheshey ili nablyudaemykh izmeneniy AGEX-paketa. Используйте responsive-breakpoint-diff, checksum-comparator, hash-algorithm-comparator, agex-bundle-diff.
Проверьте результат перед передачей
- Сравниваемая пара сначала отнесена к ясной ветке артефактов, чтобы не смешивать несвязанные методы diff.
- Итог указывает конкретные добавления, удаления, изменения полей, нарушения контракта, воспринимаемые различия или результаты целостности, а не просто «файлы отличаются».
- Если случай включает конфигурации, схемы, API или зашифрованные пакеты, процесс явно обозначает, является ли результат семантическим ревью, проверкой совместимости или валидацией на уровне байтов.
Частые вопросы
- Когда стоит использовать checksum вместо text diff или JSON diff? Когда нужно только доказать точное совпадение байтов или подтвердить, что упакованный артефакт изменился. Checksum не объясняет, какой абзац, поле или пиксель изменился.
- Почему инструменты схемы и API находятся в том же процессе, что и file diff? Потому что многие ревью начинаются с «сравни эти два файла», а заканчиваются вопросом «это ломает совместимость?». Ветки схемы и API — это эскалация для структурированного анализа, а не замена базовому diff.
- Может ли один процесс честно охватить текст, медиа и зашифрованные пакеты? Да, если ветки явно описаны. Честное обещание здесь не в том, что один инструмент подойдёт для всего, а в том, что один путь ревью поможет классифицировать пару, выбрать правильный сравнитель и получить результат, готовый к одобрению.