matematicsolutions/awesome-matematic-skills-pl / dokumenty/skills/redline-docx-pl
redline-docx-pl
VerifiedRedlining 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 wolajauvx --from adeu==1.30.0 adeu, nie goleuvx adeu. Powod nie jest kosmetyczny: adeu 1.31.0 (2026-08-03) przypiela sie twardo dofastmcp[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
uvxbez--prerelease=allow. Goleuvx adeunie 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,-obez--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.pyi 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łę:
| Tier | Operacje | Reguła |
|---|---|---|
| R - Read-only | extract (czytanie .docx), skan_placeholder.py, memo_negocjacyjne.py (pisza tylko nowe pliki raportu/memo) | Bez potwierdzenia. Wykonaj od razu. |
| M - Mutating | apply, diff, apply --live | Pokaż użytkownikowi proponowane zmiany. Czekaj na potwierdzenie słowne. |
| D - Destructive | sanitize --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 alljest obowiazkowe. Bez niegoextract -ozapisuje 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 banerPage 1 of Nna 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."
}
]
| Pole | Znaczenie |
|---|---|
tier | Priorytet 1-3 (framework nizej). |
rationale | Uzasadnienie zmiany - argument do rozmowy, nie do dokumentu. |
walkaway | Granica ustepstwa: co akceptujemy najdalej i kiedy odchodzimy od stolu. |
precedent | Odwolanie 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
| Tier | Kategoria | Regula negocjacyjna |
|---|---|---|
| 1 | Warunki brzegowe (non-starter) | Bez tej zmiany umowy nie podpisujemy. Pozycja walkaway obowiazkowa - memo bez niej nie przejdzie walidacji. |
| 2 | Istotne | Realne ryzyko prawne lub finansowe. Negocjuj, ustepstwo tylko za cos. |
| 3 | Pozadane | Poprawia 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:
let-it-be-> pseudonimizuj tresc pisma (PII -> tokeny)- praca/redline na zpseudonimizowanej wersji
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_textna 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 zextracti nie sprawdzaj nim odeslan typu "ust. 2".applynumeracje 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-allwymusza--page 1i 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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |