doc-compare

# Doc Compare > Визуальное сравнение markdown-документов с подсветкой правок: две колонки (слева/справа) в одном окне браузера, вкладки на каждую пару, изменённые места подсвечены, кнопка «Только изменения». ## 🎯 When to use - Нужно визуально сравнить локальный драфт с опубликованной версией (оферты `lovii_docs` vs `axiiom-ru/lovii`). - Сразу видеть, ГДЕ были правки: изменённые блоки подсвечены, внутри — пословно. - Свернуть всё лишнее кнопкой «Только изменения» и смотреть только затронутые места. ## 📦 Files - `SKILL.md` — этот файл - `scripts/compare_docs.py` — сборщик side-by-side с подсветкой правок ## 🧰 Usage ```bash # Локальный драфт vs опубликованное в публичном репо (gh: подтягивает через gh api) python3 ~/.config/opencode/skills/doc-compare/scripts/compare_docs.py \ --pair "Опубликовано|gh:axiiom-ru/lovii@main:docs/Публичная_оферта.md|Драфт|./docs/Публичная_оферта.md" \ --pair "Опубликовано|gh:axiiom-ru/lovii@main:docs/Оферта_присоединения.md|Драфт|./docs/Оферта_присоединения.md" # Построчная таблица difflib (альтернатива бок-о-бок) python3 ~/.config/opencode/skills/doc-compare/scripts/compare_docs.py \ --diff --pair "Старая|a.md|Новая|b.md" # Не открывать браузер, только сгенерировать файл python3 ~/.config/opencode/skills/doc-compare/scripts/compare_docs.py --no-open --pair "L|l.md|R|r.md" --out /tmp/cmp.html ``` Формат `--pair`: `"ЛеваяМетка|левый_файл|ПраваяМетка|правый_файл"`. Префикс `gh:owner/repo@ref:path` у любого из файлов = подтянуть из G...