Skip to content

matematicsolutions/awesome-matematic-skills-pl / dokumenty/skills/redline-docx-pl

redline-docx-pl

Verified

Redlining polskich umow i pism w .docx z natywnymi Word Track Changes - bez niszczenia formatowania OOXML. Czyta .docx do Markdown (CriticMarkup) dla LLM, aplikuje zmiany jako sledzone (w:ins/w:del) + komentarze, i robi sanitize przed wyslaniem (strip metadanych autora, last-modified-by, rsid, timestampy - RODO przy wysylce pisma). Silnik = adeu (MIT). Use when the user wants to nanosic poprawki w umowie/pismie .docx, zrobic redline/tryb sledzenia zmian, czytac docx dla LLM bez utraty formatowania, przygotowac pismo do wyslania (usunac metadane autora z Worda), porownac dwie wersje .docx, lub mentions track changes / sledzenie zmian / redline / .docx / DOCX.

Redline DOCX po polsku

Wrapper nad adeu (MIT, Dealfluence Oy) - dwukierunkowy konwerter miedzy .docx a Markdown (CriticMarkup), z aplikacja zmian z powrotem do .docx. Robi to, czego python-docx NIE potrafi: wstrzykuje natywne Word Track Changes (w:ins/w:del) i komentarze, zachowujac formatowanie, fonty i marginesy.

Cala praca lokalnie (uvx, brak chmury). Silnik testowany na polskim .docx 2026-05-22 (extract/apply/sanitize - patrz THIRD_PARTY_INSPIRATIONS.md).

Wymagania

uv (jezeli brak: pip install uv). adeu pobiera sie samo przy pierwszym uzyciu.

🔴 WERSJA PRZYPIETA: adeu==1.30.0 (zmierzone 2026-08-24). Wszystkie komendy nizej wolaja uvx --from adeu==1.30.0 adeu, nie gole uvx adeu. Powod nie jest kosmetyczny: adeu 1.31.0 (2026-08-03) przypiela sie twardo do fastmcp[apps]==4.0.0b1

  • bety frameworka pod nowy spec MCP 2026-07-28 - i kazde wydanie od tamtej pory (do 3.0.0 z 2026-08-22) jest nieosiagalne dla uvx bez --prerelease=allow. Gole uvx adeu nie wybuchalo: cicho rozwiazywalo do 1.30.0 i konczylo exit 0, a SKILL.md deklarowal 1.7.5 - trzy rozne wersje w jednym skillu, zero sygnalu. To klasa cichej awarii - narzedzie konczy sie sukcesem, a uruchamia co innego, niz deklaruje dokumentacja. Ta sama regula pinu obowiazuje przy @firecrawl/anydoc.

Podniesienie pinu = swiadoma decyzja, nie efekt uboczny. Stan 2026-11-10: adeu 3.2.1 deklaruje fastmcp[apps]<4,>=3.4.7 (metadane PyPI), wiec bariera bety wyglada na zdjeta. Smoke 2026-11-13 na 3.2.2: 30/30 OK; na 1.30.0: UWAGI 3 (numery list, -o bez --page, brak komunikatu na stderr - wszystkie trzy poprawione w 3.2.2 po naszym zgloszeniu). Konkretna potrzeba podniesienia pinu juz jest (numeracja postanowien); warunek: tydzien bez poprawek 3.2.x, scripts/smoke_adeu.py i decyzja WM. Powierzchnia CLI 1.30.0 (zweryfikowana): extract, init, diff, apply, accept-all, markup, sanitize, help.

Safety Tiers (KRYTYCZNE)

Przed wykonaniem każdej operacji ustal tier i zastosuj regułę:

TierOperacjeReguła
R - Read-onlyextract (czytanie .docx), skan_placeholder.py, memo_negocjacyjne.py (pisza tylko nowe pliki raportu/memo)Bez potwierdzenia. Wykonaj od razu.
M - Mutatingapply, diff, apply --livePokaż użytkownikowi proponowane zmiany. Czekaj na potwierdzenie słowne.
D - Destructivesanitize --accept-all (akceptuje wszystkie zmiany nieodwracalnie)Użytkownik musi wpisać dosłownie: "potwierdzam" zanim wykonasz.

Workflow (5 krokow)

0. Zdobadz ORYGINAL (nie rekonstruuj z PDF)

Redline pokazuje roznice miedzy baza a wersja docelowa. Baza musi byc plikiem edytowalnym od kontrahenta. Rekonstrukcja z PDF (pdftotext -> pandoc -> docx) wstrzykuje artefakty konwersji - podwojne spacje, inne lamanie akapitow, zgubione pogrubienia - ktore w Wordzie wygladaja identycznie jak nasze propozycje merytoryczne. Kontrahent nie odrozni jednych od drugich, a "akceptuj wszystkie" wciaga nasze artefakty do tresci umowy.

Masz tylko PDF? Popros o wersje edytowalna. Jesli naprawde nie da sie jej zdobyc - dostarcz liste zmian jako osobne pismo z odeslaniami § ust. lit., NIE jako track changes na podrobionej bazie.

.odt / .doc -> .docx (adeu czyta tylko .docx):

soffice --headless --convert-to docx --outdir KATALOG PLIK.odt

Windows: "/c/Program Files/LibreOffice/program/soffice.exe". Pandoc do tej konwersji nie nadaje sie - gubi formatowanie oryginalu, czyli wprowadza ten sam szum co rekonstrukcja. Bramka routingu doc-intel-contract-pl kieruje .odt na szczebel 1.5/anydoc, ale anydoc daje markdown - do redline ta sciezka nie prowadzi.

Lekcja z praktyki: redline na bazie zrekonstruowanej z PDF daje w Wordzie szum konwersji nieodroznialny od propozycji merytorycznych.

1. Czytaj - .docx do Markdown dla LLM

uvx --from adeu==1.30.0 adeu extract umowa.docx --page all -o umowa.md

--page all jest obowiazkowe. Bez niego extract -o zapisuje tylko strone 1 (syntetyczna strona ok. 19 tys. znakow, nie strona Worda) i konczy sie kodem 0. Zmierzone 2026-11-10 na 1.30.0: 39 z 600 paragrafow. Jedyny slad to baner Page 1 of N na gorze pliku. Zgloszenie: zespol Adeu.

Zwraca czysty Markdown (+ opcjonalny Semantic Appendix: defined terms, cross-references, typos). LLM pracuje na semantyce, nie na surowym OOXML - kilkukrotnie mniej tokenow niz wrzucenie pliku w postaci binarnej.

2. Przygotuj liste zmian - edits.json

Format to lista obiektow modify (search-and-replace na tekscie, NIE na pozycji):

[
  {
    "type": "modify",
    "target_text": "sad wlasciwy dla siedziby Zleceniodawcy",
    "new_text": "Sad Arbitrazowy przy KIG w Warszawie",
    "comment": "Proponuje arbitraz zamiast sadu powszechnego."
  }
]

target_text musi byc jednoznaczny - adeu blokuje niejednoznaczne dopasowania ZANIM dotkna pliku (bramka walidacji). Jezeli fragment wystepuje kilka razy, doprecyzuj kontekst.

Rozszerzenie schematu - pola negocjacyjne (opcjonalne)

Kazdy obiekt modify moze dostac cztery dodatkowe pola. Sluza one memo negocjacyjnemu (krok 2a), NIE trafiaja do adeu ani do drugiej strony:

[
  {
    "type": "modify",
    "target_text": "kara umowna w wysokosci 20% wartosci umowy",
    "new_text": "kara umowna w wysokosci 5% wartosci umowy, lacznie nie wiecej niz 10%",
    "comment": "Proponujemy ograniczenie kary umownej.",
    "tier": 1,
    "rationale": "20% bez limitu lacznego to ekspozycja nieproporcjonalna do wartosci kontraktu.",
    "walkaway": "Maksymalnie 10% z limitem lacznym 15%. Powyzej tego nie podpisujemy.",
    "precedent": "Umowa z kontrahentem X (2025): 5% z limitem 10% przeszlo bez sporu."
  }
]
PoleZnaczenie
tierPriorytet 1-3 (framework nizej).
rationaleUzasadnienie zmiany - argument do rozmowy, nie do dokumentu.
walkawayGranica ustepstwa: co akceptujemy najdalej i kiedy odchodzimy od stolu.
precedentOdwolanie do porownywalnej umowy lub wczesniejszej negocjacji.

Rozdzial widocznosci jest twardy: comment widzi druga strona (komentarz w track changes), rationale/walkaway/precedent zostaja w memo wewnetrznym.

Framework Tier 1-3 - kategorie ryzyka

TierKategoriaRegula negocjacyjna
1Warunki brzegowe (non-starter)Bez tej zmiany umowy nie podpisujemy. Pozycja walkaway obowiazkowa - memo bez niej nie przejdzie walidacji.
2IstotneRealne ryzyko prawne lub finansowe. Negocjuj, ustepstwo tylko za cos.
3PozadanePoprawia nasza pozycje, ale mozna odpuscic bez straty. Waluta wymienna za tier 2.

Brak tier = pozycja nieskategoryzowana; memo wypisze ja osobno jako zaleglosc do klasyfikacji przez prawnika.

2a. Memo negocjacyjne (opcjonalne, dokument WEWNETRZNY)

# sciezka scripts/ wzgledem katalogu tego skilla; z katalogu sprawy podaj pelna
python scripts/memo_negocjacyjne.py edits.json -o memo.md --tytul "Umowa serwisowa - kontrahent X"
python scripts/memo_negocjacyjne.py edits.json --adeu edits_adeu.json   # kopia bez pol memo, do kroku 3

Generuje memo w Markdown: zmiany pogrupowane wg tierow, naglowek poufnosci, licznik zmian per tier, przy kazdej pozycji rationale / walkaway / precedent. Skrypt zero-dep (Python stdlib). Walidacja: tier spoza 1-3 lub tier 1 bez walkaway = exit 1.

Granica governance: memo to draft do rozmowy, nie automat. Negocjacje prowadzi czlowiek - skrypt przygotowuje mu mape pozycji, niczego nie wysyla i nie rozstrzyga. Memo NIGDY nie idzie do drugiej strony (naglowek poufnosci jest w szablonie na stale). Do adeu apply podawaj kopie z --adeu - pola negocjacyjne nie moga trafic do pliku wymienianego z kontrahentem.

3. Aplikuj - natywne Track Changes

uvx --from adeu==1.30.0 adeu apply umowa.docx edits.json -o umowa_redline.docx --author "Kancelaria"

Daje umowa_redline.docx ze sledzonymi zmianami i komentarzami. Bez --author adeu wpisuje nazwe konta systemowego biezacego uzytkownika - zawsze podawaj --author jawnie, zeby nie wyciekla nazwa konta do dokumentu.

Zweryfikuj strukture niezaleznie od komunikatu narzedzia - exit 0 i "applied" przy kazdej pozycji nie dowodza, ze Word pokaze zmiany jako sledzone:

python -c "
import zipfile,re
x=zipfile.ZipFile('umowa_redline.docx').read('word/document.xml').decode('utf-8')
print('w:ins',len(re.findall(r'<w:ins ',x)),'| w:del',len(re.findall(r'<w:del ',x)),'| w:delText',len(re.findall(r'<w:delText',x)))
"

Usuniety tekst musi siedziec w w:delText, nie w w:t. Zero w:ins przy "applied" w logu = zmiany poszly poza mechanizm track changes (tak zachowywal sie drugi silnik, patrz sekcja o genoffice nizej).

3a. Skan placeholderow - bramka "czy draft nie wychodzi z dziurami"

# sciezka scripts/ wzgledem katalogu tego skilla, jak w kroku 2a
python scripts/skan_placeholder.py umowa_redline.docx        # tez .md / .txt, wiele plikow naraz
python scripts/skan_placeholder.py umowa_redline.docx --json # raport maszynowy

Wykrywa niedokonczone pola: [...], [ ], [wstaw ...], [insert ...], TBD, DO UZUPELNIENIA, $X / $___, ciagi podkreslen ___, placeholder sygnatury NN/RR, puste pola dat (dnia __, [data]) i kwot ([kwota] oraz kazde 0,00 zl - czesty artefakt niewypelnionego pola; jezeli kwota zerowa jest zamierzona, odnotuj to przy przekazaniu). Raport plik:pozycja (paragraf w .docx, linia w tekscie) + fragment kontekstu.

Zero zaleznosci (Python stdlib, .docx czytany przez zipfile). Exit 0 = czysto, exit 1 = znaleziska. Kazde znalezisko blokuje wysylke - najpierw uzupelnij pole albo swiadomie zostaw (np. kwota do wpisania przez klienta) i odnotuj to przy przekazaniu draftu czlowiekowi.

4. Sanitize PRZED wyslaniem - RODO

uvx --from adeu==1.30.0 adeu sanitize umowa_redline.docx -o umowa_clean.docx --keep-markup --author "Kancelaria" --report

Usuwa: creator, last modified by, template, rsid, custom XML parts; normalizuje timestampy; podmienia autorow track-changes/komentarzy na jedna nazwe. --keep-markup zachowuje sledzone zmiany (do negocjacji); bez tego (--accept-all) akceptuje wszystko i zwraca czysty dokument. Konczy werdyktem Result: CLEAN.

Zawsze rob sanitize przed wyslaniem pisma na zewnatrz. Word zostawia w metadanych nazwiska autorow, sciezki szablonow i historie edycji - to wyciek danych.

Pozostale komendy

uvx --from adeu==1.30.0 adeu diff v1.docx v2.docx          # wizualny diff dwoch wersji
uvx --from adeu==1.30.0 adeu apply --live edits.json       # edycja zywego dokumentu w Word (Windows + MS Word)

Integracja z let-it-be (PII PL)

sanitize czysci metadane Worda, ale NIE tresc. Do anonimizacji tresci (PESEL, NIP, nazwiska w fleksji) najpierw przepusc tekst przez let-it-be, potem redline:

  1. let-it-be -> pseudonimizuj tresc pisma (PII -> tokeny)
  2. praca/redline na zpseudonimizowanej wersji
  3. adeu sanitize -> domkniecie metadanych przed wyslaniem

let-it-be = tresc (RODO art. 4 dane osobowe w tekscie); adeu sanitize = metadane pliku. Dwie rozne warstwy wycieku, obie trzeba domknac.

Ograniczenia

  • Live MS Word tylko Windows + zainstalowany Word (backend Python).
  • target_text na dopasowaniu tekstu - przy duplikatach trzeba kontekstu.
  • Numeracja automatyczna Worda nie przechodzi do Markdown: kazdy punkt listy dostaje 1. (zmierzone 2026-11-10 na syntetycznej liscie, 1.30.0 i 3.2.1; poprawione w 3.2.2). Dopoki pin stoi na 1.30.0: nie wskazuj postanowien po numerze z extract i nie sprawdzaj nim odeslan typu "ust. 2". apply numeracje zachowuje.
  • adeu to narzedzie wspomagajace, NIE zastepuje weryfikacji przez prawnika.
  • Silnik zewnetrzny (adeu, Dealfluence) - przy kazdej zmianie wersji uruchom python scripts/smoke_adeu.py --wersja X.Y.Z (dluga syntetyczna umowa, zmiana w ostatnim paragrafie, kod 0 = OK, 10 = UWAGI, czyli znane ograniczenia wersji, 20 = BLOKADA). Kontrola pozytywna: --bez-page-all wymusza --page 1 i musi dac BLOKADE.
  • W vendor/docx-engine/ lezy DRUGI silnik (GenOffice, Apache-2.0), zweryfikowany pomiarowo, ale NIE wpiety w zaden krok workflow. Workflow stoi w calosci na adeu. Nie wolaj go z tego skilla, dopoki nie zapadnie decyzja opisana nizej.

Atrybucja

Silnik: adeu (c) 2026 Dealfluence Oy, licencja MIT.

Wzorce memo negocjacyjnego (pola tier/rationale/walkaway/precedent, grupowanie wg tierow) i skanera placeholderow: evolsb/legal-redline-tools (MIT). PATTERN, nie kod - oba skrypty napisane od zera pod polskie realia (wzorce PL: DO UZUPELNIENIA, NN/RR, dnia __, kwoty w zl) i pod format edits.json adeu zamiast ich wlasnego formatu redlines.

Silnik wendorowany (NIEAKTYWNY): vendor/docx-engine/ - packages/docx-engine z genspark-ai/genoffice (Apache-2.0, commit 8f52328), redystrybuowany razem z LICENSE i NOTICE zgodnie z sekcjami 4(b) i 4(d) tej licencji.

Szczegoly i snapshoty licencji: THIRD_PARTY_INSPIRATIONS.md.

Drugi silnik - dlaczego lezy nieaktywny

W vendor/docx-engine/ lezy silnik round-tripu po bajtach z GenOffice (Apache-2.0), zmierzony 2026-08-05 na pismach z maszyny WM. Nie zastepuje adeu i nie wolno go wolac z tego workflow.

Pomiar sledzonych zmian (2026-08-05 wieczor, 71 pism) rozstrzygnal, ze pole SaveBlock.revision NIE produkuje Word Track Changes: w:ins/w:del laduja na poziomie w:body, tekst usuniety zostaje w w:t zamiast w:delText, a niezalezny czytnik (adeu extract) nie widzi zmiany w zadnym z 71 plikow. Druga sciezka silnika (Run.ins/Run.del) jest poprawna, ale nie daje przewagi nad adeu. Osobno zmierzono patchTableCellTexts - odbudowuje komorke zamiast ja patchowac, wiec do edycji tabel takze sie nie nadaje bez wlasnej warstwy ochronnej.

Komplet liczb i rekomendacja: THIRD_PARTY_INSPIRATIONS.md (sekcja o genoffice) oraz vendor/docx-engine/README.md. Decyzja o jakimkolwiek wpieciu nalezy do WM.

Wspólne reguły wtyczki dokumenty (Dokumenty)

Te reguły obowiązują w każdym skillu tej wtyczki, także gdy sam skill milczy. Są skopiowane do każdego skilla, więc działają zarówno po instalacji całej wtyczki, jak i pojedynczego skilla.

Plugin obsługuje dokumenty: konwersję do Markdown, redlining .docx i anonimizację danych osobowych. Część operacji dotyka danych wrażliwych, więc reguła ochrony danych jest tu pierwsza.

Ochrona danych

  • Anonimizacja przed wysyłką - gdy dokument zawiera dane osobowe, oczyść je lokalnie (skill let-it-be), zanim treść trafi do modelu. Dane osobowe nie powinny wychodzić do API. To zasada minimalizacji (RODO).
  • Metadane przy wysyłce - redlining .docx czyści też metadane autora; sprawdź je przed przekazaniem pliku na zewnątrz.
  • Próg poufności - materiał objęty tajemnicą lub szczególnie wrażliwy oceniaj osobno, czy w ogóle wnosić do narzędzia. Przy wątpliwości nie przekazuj.

Operacje nieodwracalne

Niektóre operacje są nieodwracalne (anonimizacja w trybie nieodwracalnym, zaakceptowanie wszystkich zmian w .docx). Skille oznaczają je jawnie - wykonuj je dopiero po potwierdzeniu przez człowieka.

Bramka człowieka

Wynik to projekt. Nic nie zostaje wysłane ani złożone, zanim sprawdzi to uprawniony człowiek. Plugin przygotowuje plik, nie wykonuje aktu wysyłki.

Zakres pluginu

Plugin daje narzędzia na dokumentach (konwersja, redline, anonimizacja, akta i chronologia). Nie ocenia treści prawnej. Weryfikację cytatu wobec źródła prawa daje plugin „fundament weryfikacyjny”; chronologia-stanowiska-pl sprawdza tylko, czy cytat stoi na wskazanej stronie akt.

canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall