screenshot-analyze

name	screenshot-analyze
description	Анализирует скриншоты мобильного приложения на L10N дефекты (переводы, CLDR форматы, RTL). Используй для проверки локализации UI, когда нужно найти ошибки в переводах, форматах дат/валют или проблемы RTL-верстки. Не используй для функционального тестирования UI или анализа кода.
allowed-tools	Read Write Edit Glob Grep Bash(open*)
agent	agents/auditor.md
context	fork

L10n & I18n UI Audit (Ride-Hailing)

Визуальный кросс-локализационный анализ UI для приложений вызова такси.

Фокус: Деньги, Время, Геолокация, RTL + СЕМАНТИКА ПЕРЕВОДОВ.

Парсинг аргументов (ОБЯЗАТЕЛЬНО — шаг 0)

Путь к скриншотам ищи по приоритету — остановись на первом успешном:

1. Args скилла — любой текст после имени команды. Примеры:

• /screenshot-analyze resources/screenshots/brazil_passenger_main_screen → resources/screenshots/brazil_passenger_main_screen
• /screenshot-analyze /abs/path/screens → /abs/path/screens

2. Glob-поиск (fallback) — если args не содержат путь, выполни Glob("**/*.{png,jpg,jpeg,gif,webp}"), сгруппируй по директориям, возьми директорию с наибольшим количеством изображений.

3. Спроси пользователя — только если пп.1-2 не дали результата.

СТРОГО ЗАПРЕЩЕНО задавать вопрос о пути, если в пп.1-2 найден путь или файлы.

---

Scope (Что проверяем)

1. СЕМАНТИКА (Translation Quality) ← ГЛАВНЫЙ ПРИОРИТЕТ
   - Смысловые ошибки (false friends, wrong context)
   - Оскорбительный/опасный контент
   - Буквальный перевод составных слов

2. ВЕРСТКА (Layout)
   - Truncation, Overflow, Overlap
   - RTL Mirroring

3. ФОРМАТЫ (CLDR Compliance)
   - Числа, Валюта, Дата, Время, Дистанция

4. КОНСИСТЕНТНОСТЬ
   - Единый язык, числовая система, терминология

---

Core Principles

1. Translation Verification FIRST

ГЛАВНАЯ ЗАДАЧА — ПРОВЕРКА ПЕРЕВОДОВ НА СМЫСЛОВЫЕ ОШИБКИ. Активно ищи:

• False Friends — похожие слова с разным значением
• Wrong Context — правильное слово, неправильный контекст
• Literal Translation — буквальный перевод идиом/терминов
• Offensive Content — оскорбительный/табуированный контент

2. Container vs Content

Помимо перевода проверяй: контейнеры (влезает ли текст) и форматы (CLDR). Не придирайся к стилистике, если нет смысловой ошибки.

3. RTL Mirroring

В RTL локалях (ar, he, fa, ur) весь UI зеркальный. Отзеркалить: отступы, стрелки навигации, прогресс-бары. НЕ зеркалить: автомобили, карты.

4. Валюта ≠ Локаль

Валюта определяется регионом, не языком. inDrive Brazil → R$ (BRL) на ЛЮБОМ языке UI. НЕ считать R$ в ru-RU интерфейсе багом.

---

Входные требования

Параметр	Обязательность	Описание
Путь к скриншотам	Обязательно	Файл или директория (JPEG, PNG, GIF, WebP)
Регион	Авто / Спросить	Из имени файла (_BR, _RU) или спросить
Целевая локаль	Авто	Из имени файла (ru_BR.png → locale=ru, region=BR)

Требования к изображениям

Параметр	Лимит
Размер файла	≤5 MB
Разрешение	≤8000×8000 px
Оптимальное	≤1568 px по длинной стороне
Минимальное	≥200 px

---

Определение региона

Формат имен файлов

{locale}_{REGION}.png

Примеры:
- en_BR.png → Locale: en, Region: BR (Бразилия)
- ru_BR.png → Locale: ru, Region: BR (Бразилия)
- ar_SA.png → Locale: ar, Region: SA (Саудовская Аравия)

Если регион определен из файлов — НЕ задавай вопросы.

Если регион НЕ определен — спроси:

"С какого региона собраны эти скриншоты?"

• Бразилия (BR) — R$, km
• Россия (RU) — ₽, km
• Саудовская Аравия (SA) — SAR, RTL, km
• США (US) — $, mi

---

Алгоритм анализа (4-Step)

Step 1: Reference Check

1. Найди EN скриншот — это Base Layout
2. Запомни структуру: количество элементов, позиции, размеры

Step 2: Layout Stress Test

1. Найди языки с максимальной длиной: DE, RU, ES, PT-BR
2. Проверь на каждом: Overflow, Truncation, Line Break Issues

Step 3: Bi-Directional Check (RTL)

Для AR/HE/FA/UR:

1. Зеркалирование Margins/Paddings
2. Направление стрелок навигации
3. Позиция Back/Close кнопок
4. Автомобили НЕ отзеркалены

Step 4: Data Format Validation (CLDR)

1. Числа: разделители тысяч и дробей
2. Валюта: символ, позиция, отбивка
3. Время: 12h vs 24h

Справочные таблицы: references/cldr-tables.md

Verbosity Protocol

Structured Output Priority: Весь analysis идёт в артефакт (MD/HTML), не в чат.

Chat output (ограничения):

• Brief Summary: max 5 строк (что нашли, сколько, итог)
• Findings table: max 15 строк (топ по severity)
• Полный отчёт: 📊 Полный отчёт: {path} + открыть файл

Iterative steps: Не выводить прогресс по каждому файлу. Checkpoint только при:

• Phase transition (Фаза N → Фаза N+1)
• Blocker обнаружен
• Завершение (SKILL COMPLETE)

Tools first:

• Grep → table → report, без "Now I will grep..."
• Read → analyze → report, без "The file shows..."

Post-Check: Inline перед SKILL COMPLETE (5-7 строк checklist), не отдельный файл.

Steps 1-4: Silent. Output: Master Issues Table (max 10) + HTML report opened.

---

LQA & Domain-Specific Checks

Полные таблицы проверок (типы семантических ошибок, валюты, время, RTL) — в references/lqa-rules.md.

Ключевые приоритеты:

• CRITICAL: False Friends, Wrong Context, Offensive Content, RTL Price Concatenation
• ERROR: Literal Translation, CLDR нарушения, неправильные форматы времени
• WARNING: Стилистика, minor format issues

---

Ограничения (Safety Limits)

Max Issues: 10

Ограничивай отчёт ТОП-10 самых критичных ошибок. Приоритет: CRITICAL → ERROR → WARNING.

Grouping

Одинаковая ошибка на нескольких скриншотах = 1 запись с перечислением файлов.

Перевод на русский

Для не-русских текстов добавляй перевод:

✅ "إيجاد الضحايا" (Найти жертв) — опасный перевод

Акцент на валютах

ОБЯЗАТЕЛЬНО сравнивай формат валюты:

• Символ (R$ vs BRL)
• Позиция (R$13 vs 13R$)
• Формат числа (R$13 vs R$13.00)

---

Severity Guidelines

Severity	Критерий
CRITICAL	Оскорбительный контент, полная поломка функционала
ERROR	Неправильный перевод с изменением смысла, обрезанный CTA
WARNING	Стилистика, minor format issues
INFO	Рекомендации по улучшению

---

Anti-Patterns (BANNED)

1. Vague Descriptions → указывай элемент + конкретику: "Button text truncated at 'Регистрац...'"
2. Currency Region False Positive → валюта региона (R$ в BR) корректна на любом языке UI
3. Translating Non-Translateables → адреса, POI, бренды с карт не переводятся
4. Missing Location → каждый баг с указанием элемента: "CTA button (bottom of screen)"

---

Формат вывода

В чат вывести только:

📊 L10n: {N} issues (CRITICAL: X, ERROR: Y) → analysis-report.html

Ограничения:

• 0 ошибок → "✅ Ошибок не обнаружено"

HTML Report

Генерируется в директории со скриншотами.

Заголовок: L10n Report — {COUNTRY_NAME} Структура: Summary Cards → Context Banner → Per-Screenshot Sections

Шаблон: references/html-template.md

ОБЯЗАТЕЛЬНО: Открой отчёт командой open {path}/analysis-report.html

---

Cross-Screenshot Comparison

При нескольких локалях — сравнительная таблица:

| Элемент | EN (ref) | RU | AR | Проблема |
|---------|----------|----|----|----------|
| CTA Button | Find offers | Найти ✅ | ❌ | AR: Буквальный перевод |
| Price | R$13 | R$13 ✅ | R$13 ✅ | — |
| Back Button | < | < ✅ | ❌ < | AR: Должен быть > |

---

Self-Check Protocol

Перед завершением проверь:

• Locale указан для всех проблем
• Location указан для всех проблем
• Severity присвоен
• No false positives (валюта региона)
• Не-русские тексты с переводом

Полный чек-лист: references/checklists.md

---

Что НЕ переводится

Элемент	Правило
Имена пользователей	Как введены
Марки/модели авто	Глобальные бренды
Адреса с карт	Локальный язык места
POI	Язык места
Госномера	Формат региона

---

Связанные файлы

Файл	Содержание
references/cldr-tables.md	CLDR таблицы: валюты, числа, время, plurals
references/checklists.md	Полные чек-листы: RTL, Layout, CLDR, Semantics
references/html-template.md	HTML шаблон отчёта