matematicsolutions/awesome-matematic-skills-pl / fundament-weryfikacyjny/skills/citation-grounding-pl
citation-grounding-pl
VerifiedMechaniczny weryfikator cytatu dla tekstów prawnych po polsku z GRADIENTEM weryfikacji (ISTNIENIE / TREŚĆ / FRAGMENT) - sprawdza string-matchem, czy każdy cytat z orzeczenia, ustawy, umowy lub pisma faktycznie istnieje w dokumencie źródłowym, czy sygnatura jest realna i czy parafraza oddaje stanowisko sądu, zamiast wierzyć modelowi "na oko". Przeciwdziała halucynacjom modelu (w tym problemowi "prawdziwy-cytat-fałszywa-teza"), RODO-safe (działa lokalnie), spina się z saos-orzecznictwo i eu-sparql-search. Używaj gdy: weryfikacja cytatów w opinii prawnej / memo / piśmie procesowym, sprawdzenie czy AI nie zmyśliło fragmentu wyroku, przepisu lub sygnatury, czy parafraza nie przekręca holdingu, kontrola cytatu przed wysłaniem deliverable do klienta, audyt grounding outputu LLM, "sprawdź czy ten cytat jest prawdziwy", "zweryfikuj cytaty", "czy ten fragment wyroku istnieje", "grounding", "anti-halucynacja", "citation check", "czy AI to zmyśliło", "czy SN to naprawdę orzekł".
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 13.9 KB |
| LICENSE | other | 11.1 KB |
| SKILL.md | skill md | 25.2 KB |
| references/drabinka-zrodel-pl.md | markdown | 3.3 KB |
| references/gradient-weryfikacji.md | markdown | 4.6 KB |
| references/szkielet-weryfikatora-domenowego/README.md | markdown | 4.7 KB |
| references/szkielet-weryfikatora-domenowego/SKILL.template.md | markdown | 2.9 KB |
| scripts/ground-citations.mjs | script | 38.3 KB |
| scripts/porownanie-slow.mjs | script | 16.7 KB |
| scripts/test-grounding.mjs | script | 31.9 KB |
SKILL.md
View on GitHub---
name: citation-grounding-pl
description: >
Mechaniczny weryfikator cytatu dla tekstów prawnych po polsku z GRADIENTEM
weryfikacji (ISTNIENIE / TREŚĆ / FRAGMENT) - sprawdza string-matchem, czy każdy
cytat z orzeczenia, ustawy, umowy lub pisma faktycznie istnieje w dokumencie
źródłowym, czy sygnatura jest realna i czy parafraza oddaje stanowisko sądu,
zamiast wierzyć modelowi "na oko". Przeciwdziała halucynacjom modelu (w tym
problemowi "prawdziwy-cytat-fałszywa-teza"), RODO-safe (działa lokalnie), spina
się z saos-orzecznictwo i eu-sparql-search. Używaj gdy:
weryfikacja cytatów w opinii prawnej / memo / piśmie procesowym, sprawdzenie czy
AI nie zmyśliło fragmentu wyroku, przepisu lub sygnatury, czy parafraza nie
przekręca holdingu, kontrola cytatu przed wysłaniem deliverable do klienta,
audyt grounding outputu LLM, "sprawdź czy ten cytat jest prawdziwy", "zweryfikuj
cytaty", "czy ten fragment wyroku istnieje", "grounding", "anti-halucynacja",
"citation check", "czy AI to zmyśliło", "czy SN to naprawdę orzekł".
license: Apache-2.0
allowed-tools: [Bash, Read, Grep]
data-residency: local
requires-human-approval: false
pii-egress: none
attribution:
- source: AnttiHero/lavern
license: Apache-2.0
relationship: pattern-only
note: >
Wzorzec mechanicznego weryfikatora grounding (v1). Kod i prompty napisane od zera.
- source: jeannesulzer/international-criminal-tribunals-skills
license: CC-BY-4.0
relationship: adaptation
note: >
Gradient weryfikacji ISTNIENIE/TREŚĆ/FRAGMENT (v2) to adaptacja trójstopniowego
Existence/Content/Paragraph.
- source: john-walkoe/courtlistener_citations_mcp
license: MIT
relationship: pattern-only
note: >
Guard STRONY oparty na niezgodności nazw metodą Jaccarda (v2.1). Stop-listy własne.
metadata:
author: Wiesław Mazur / MateMatic
version: 3.0.0
companion_skills: saos-orzecznictwo, eu-sparql-search, legal-ai-audit-bundle, adversarial-legal-review-pl, deliverable-fidelity-pl, legal-request-router-pl
---
# Citation Grounding PL - mechaniczny weryfikator cytatu (gradient)
## Filozofia
**Cytat niezweryfikowany mechanicznie = cytat zmyślony, dopóki nie udowodnisz inaczej.**
Model językowy potrafi wygenerować fragment wyroku, który brzmi idealnie - sygnatura,
ton, słownictwo sądu - a którego w orzeczeniu nigdy nie było. Dla opinii prawnej cytującej
nieistniejący fragment SN to katastrofa zawodowa i ryzyko odpowiedzialności (art. 6 Prawa
o adwokaturze, należyta staranność).
**Zasada:** weryfikacja jest **mechaniczna**, nie semantyczna. Nie pytamy modelu „czy ten
cytat pasuje". Robimy string-match znormalizowanego cytatu wobec znormalizowanego źródła.
Match albo go nie ma. Odwrotny ciężar dowodu - to cytat musi się znaleźć w źródle.
## Co nowego w v2 - gradient weryfikacji
v1 sprawdzał tylko jedną rzecz: czy **dosłowny cytat** istnieje w źródle. To zostawiało dwie
ślepe plamy, które v2 zamyka:
1. **Zmyślona sygnatura.** v1 mówił „BRAK ŹRÓDŁA" = luka do uzupełnienia. v2 traktuje
nierozwiązaną lub rozbieżną kotwicę jako **sygnał możliwego fałszerstwa**. **v2.1 dokłada guard
STRONY:** sygnatura może być realna, ale doczepiona do INNEJ sprawy - gdy nazwy stron zadeklarowane
rozjeżdżają się ze stronami rozwiązanego źródła (Jaccard tokenów nośnych < 0.30), to 🔴 blokada
(„prawdziwy cytat, fałszywa teza" już na poziomie kotwicy, nie dopiero w treści).
2. **Prawdziwy cytat, fałszywa teza** (problem Stanford „false-under-true"). Cytat może być
dosłownie obecny (FRAGMENT zielony), a otaczające twierdzenie - „SN uznał, że…" - przekręca
to, co sąd faktycznie orzekł. v1 **wprost zwalniał parafrazy** z weryfikacji. To była
największa luka. v2 wciąga parafrazy w zakres na poziomie TREŚĆ.
**Trzy poziomy** (adaptacja Existence/Content/Paragraph z biblioteki Jeanne Sulzer, CC BY 4.0):
| Poziom | Co potwierdza | Stosuj do |
|---|---|---|
| **ISTNIENIE** | Kotwica - sygnatura/CELEX, data, organ - jest realna i zgadza się z deklaracją | „wyrok z 12.03.2019, II CSK…", „por. II CSK 123/19" |
| **TREŚĆ** | Źródło CO DO ISTOTY zawiera to, co twierdzi output | „SN przyjął, że…", parafraza holdingu |
| **FRAGMENT** | Cytowany akapit/zdanie istnieje dosłownie w źródle | każdy cytat w cudzysłowie, każdy pinpoint akapitu |
**Reguła kalibracji (rdzeń v2):** dopasuj siłę twierdzenia do **osiągniętego** poziomu. Jeśli
output twierdzi na poziomie FRAGMENT (dosłowny cytat), a weryfikacja dochodzi tylko do TREŚĆ
(źródło dotyczy tematu, ale cytatu dosłownie nie ma) → status **KALIBRACJA**: złagodź do
parafrazy ALBO oznacz pinpoint jako prowizoryczny. Pełna doktryna i macierz typów twierdzeń:
`references/gradient-weryfikacji.md`.
## Kontrakt generacyjny - znakuj przy pisaniu, nie tylko weryfikuj po
Grounding post-hoc łapie halucynację na końcu. Taniej jest nie wyprodukować jej wcale.
Gdy **generujesz** tekst prawny (a nie tylko weryfikujesz cudzy), obowiązują trzy klasy
z tagiem **przy linii, której dotyczy** - nie zbiorczo na końcu akapitu:
| Klasa | Kiedy | Jak znakować |
|---|---|---|
| **Zweryfikowane** | Źródło sprawdzone w tej sesji (SAOS/EUR-Lex/ISAP/dokument lokalny) | pełna kotwica przy tezie: `(wyrok SN II CSK NN/RR, SAOS)` |
| **Do sprawdzenia** | Prawdopodobne, ale z pamięci modelu: przepis, termin, wyliczenie | tag przy linii: `[z pamięci - sprawdź w SAOS/ISAP]`, `[wyliczenie modelu - sprawdź]` |
| **Nie używać** | Sygnatura/numer/cytat, którego nie da się rozwiązać | **fail-closed: nie produkuj wcale.** Napisz „zgodnie z utrwalonym orzecznictwem SN [uzupełnij sygnaturę]" zamiast zmyślać numer |
Reguły domknięcia pętli generacja→weryfikacja:
- Klasa **Zweryfikowane** ma pokrycie 1:1 w rekordach zadania dla skryptu - każda taka
kotwica trafia do `items[]` i musi wyjść 🟢/🟡. Zweryfikowane, które nie przechodzi
skryptu, to błąd klasyfikacji, nie pech.
- Klasa **Do sprawdzenia** nigdy nie jest cytatem w cudzysłowie ani pinpointem - najwyżej
parafrazą z tagiem. Cudzysłów zobowiązuje do poziomu FRAGMENT.
- W szablonach i przykładach używaj **jawnych placeholderów** (`II CSK NN/RR`,
`sygn. akt [uzupełnij]`) - realistyczne sygnatury z przykładów wyciekają do prawdziwych
outputów (audyt niemieckiego zbioru skilli prawnych: ~58% z 3228 sygnatur w outputach
było błędnych, w dużej części przeniesionych z materiałów przykładowych).
## Kiedy odpalać
**Zawsze przed wysłaniem do klienta / sądu:**
- Opinia prawna lub memo cytujące orzecznictwo, ustawy, umowę
- Pismo procesowe powołujące fragmenty wyroków
- Każdy output LLM zawierający cytaty, parafrazy holdingów lub powołania sygnatur
**Co teraz JEST w zakresie (zmiana wobec v1):** parafrazy i powołania samej sygnatury -
oznacz je `claim_type` i poddaj weryfikacji na właściwym poziomie. Bez cudzysłowu ≠ bez kontroli.
## Workflow
1. **Zbierz źródła i rozwiąż kotwice** - tekst dokumentu źródłowego dostępny lokalnie:
- Orzeczenia: `saos-orzecznictwo` (zwraca też datę i organ → kotwica)
- Akty EU: `eu-sparql-search` (CELEX → kotwica)
- Ustawy PL / umowy / pisma: dostarcza użytkownik (.txt/.md/.docx → markitdown)
- Gdy bezpośredni fetch zawiedzie, pracuj **drabinkę źródeł**: `references/drabinka-zrodel-pl.md`
- **Bez źródła nie ma weryfikacji TREŚĆ/FRAGMENT** - status `BRAK ŹRÓDŁA`, nie „prawdopodobnie ok".
2. **Sklasyfikuj każde twierdzenie** - dla każdego powołania ustal `claim_type` (patrz macierz
w `references/gradient-weryfikacji.md`). To ustawia WYMAGANY poziom weryfikacji:
- `cytat_doslowny`, `teza_pinpoint` → FRAGMENT
- `stanowisko_sadu`, `parafraza` → TREŚĆ
- `fakt_proceduralny`, `powolanie` → ISTNIENIE
3. **Zbuduj zadanie** - jeden rekord na twierdzenie (format niżej): `quote` dla FRAGMENT,
`claim_text` dla TREŚĆ, `anchor` + `anchor_resolved` dla ISTNIENIA.
4. **Weryfikacja mechaniczna** - uruchom skrypt:
```bash
node scripts/ground-citations.mjs <plik-zadania.json>
```
Skrypt liczy osiągnięty poziom, porównuje z wymaganym, kalibruje. Exit 1 = twarda blokada.
5. **Klasyfikuj wynik** (skrypt robi to automatycznie):
- 🟢 `ZWERYFIKOWANY` - osiągnięty poziom ≥ wymagany. Dla FRAGMENT podaje `zakres` {start, end}
w oryginalnym `source_text` (indeksy JS, koniec wyłączny), `offset` = `zakres.start`,
`segmenty` dla cytatu z luką i `fragment_zrodla` - dosłowny wycinek źródła do wglądu.
Przy cytacie z luką zawsze dochodzi pole `opuszczone` z wyciętym tekstem - pokaż je człowiekowi
- 🟡 `ZMODYFIKOWANY` - tylko dla `powod_kod: diakrytyki` i `powod_kod: znaki` (tabela kodów
niżej). Zmiana słowa nigdy tu nie trafia
- 🟡 `WYMAGA_OSADU` - poziom TREŚĆ: terminy nośne obecne, substancję potwierdza człowiek / paraphrase-judge
- 🟠 `KALIBRACJA` - osiągnięto niżej niż twierdzono (cytat dosłowny nieobecny, temat pokryty) - złagodź tezę
- 🔴 `NIEZWERYFIKOWANY` - brak trafienia / rozbieżna kotwica = potencjalna halucynacja, BLOKUJ.
Przy cytacie pole `powod_kod` mówi, co poszło nie tak - tabela kodów jest w sekcji
„Porównanie na słowach"
- ⛔ `BRAK ŹRÓDŁA` - nie dostarczono dokumentu / nierozwiązana sygnatura tam, gdzie wymagana
6. **Raport** - zwróć tabelę (niżej). 🔴 i ⛔ = **twarda blokada** (exit 1). 🟠 i 🟡 = **decyzja
człowieka** przed publikacją (miękka). Nigdy nie przepuszczaj 🔴 milcząco.
## Format zadania (input skryptu)
> Wszystkie sygnatury, strony i cytaty w przykładach tego pliku są **fikcyjne** - ilustrują
> format, nie realne sprawy. Nie przenoś ich do zadań ani deliverable.
```json
{
"items": [
{
"id": "C1",
"source_id": "II CSK 123/19",
"claim_type": "cytat_doslowny",
"quote": "sąd związany jest granicami zaskarżenia",
"source_text": "<pełny znormalizowany tekst orzeczenia>"
},
{
"id": "C2",
"source_id": "I CSK 50/18",
"claim_type": "stanowisko_sadu",
"claim_text": "SN przyjął, że klauzula waloryzacyjna w umowie kredytu jest dopuszczalna",
"source_text": "<pełny tekst orzeczenia>"
},
{
"id": "C3",
"source_id": "II CSK 123/19",
"claim_type": "fakt_proceduralny",
"anchor": { "sygnatura": "II CSK 123/19", "data": "12.03.2019", "organ": "SN Izba Cywilna", "strony": "Kowalski przeciwko Bank Millennium S.A." },
"anchor_resolved": { "sygnatura": "II CSK 123/19", "data": "2019-03-12", "organ": "Sąd Najwyższy Izba Cywilna", "strony": "Nowak przeciwko Skarb Państwa" }
}
]
}
```
`anchor` = co twierdzi output. `anchor_resolved` = co zwrócił resolver (SAOS/EUR-Lex). Skrypt
porównuje mechanicznie (rozwija skróty: `SN`→`sąd najwyższy`, `NSA`, `TK`, `TSUE`…, normalizuje
daty `DD.MM.YYYY`↔`YYYY-MM-DD`). Brak `claim_type` → domyślnie `cytat_doslowny` (zachowanie v1).
**Pole `strony`** (opcjonalne, string „X przeciwko Y" albo tablica nazw) uruchamia **guard STRONY**:
gdy sygnatura się zgadza, ale nazwy stron zadeklarowane vs rozwiązane rozjeżdżają się (Jaccard tokenów
nośnych `< 0.30` przy ≥2 tokenach) → 🔴 blokada („prawdziwy cytat, fałszywa teza" na poziomie kotwicy).
Częściowa zgodność (`0.30–0.50`) → 🟡 miękka uwaga. Stop-lista odsiewa formy prawne (`sp. z o.o.`,
`S.A.`, `przeciwko`, `v.`, `i inni`), więc `Bank Millennium S.A.` ≡ `Bank Millennium Spółka Akcyjna`.
`anchor_resolved.strony` dostarcza resolver (SAOS zwraca strony postępowania).
## Reguły normalizacji (co robi skrypt)
Aby uniknąć fałszywych 🔴 z powodu kosmetyki, przed porównaniem skrypt:
- składa wejście do NFC (źródło zapisane w NFD porównuje się jak zapisane w NFC)
- sprowadza do lowercase (`ß`/`ẞ` → `ss`, odpowiednik `casefold` Pythona), zwija białe znaki
- ujednolica **wszystkie** cudzysłowy (`„` `"` `»` `‹` `‚` `'` `´` → `"`) i **całą rodzinę kresek**
(`‐` `‑` `‒` `–` `—` `―` `−` `⁃` `-` → `-`), rozwija wielokropek `…` → `...`
- usuwa znaki niewidzialne w PDF, a obecne w warstwie tekstowej: miękki dywiz `U+00AD`,
zerowa szerokość `U+200B`/`U+200C`/`U+200D`, BOM, word joiner
- usuwa myślniki przenoszenia (`praw-\nnik` → `prawnik`), **miękki dywiz na łamaniu też**
(renderuje się wyłącznie tam, więc tam znaczy przeniesienie)
- traktuje `(...)`, `[...]` i `...` w cytacie jako lukę - sprawdzaną według reguł z sekcji niżej
- przy kotwicy: rozwija skróty organów, normalizuje formaty dat, porównuje sygnatury bez kropek
- przy TREŚCI: wyciąga terminy nośne (≥4 znaki, bez stopwords), liczy pokrycie w źródle (próg 0.7)
Normalizacja NIE zmienia treści merytorycznej - jeśli słowo jest inne, to nadal 🔴.
## Porównanie na słowach (od v3.0)
Po normalizacji skrypt porównuje cytat ze źródłem słowo po słowie. Cudzysłów wokół cytatu i
„14 dni" zamienione na „15 dni" to dla niego dwie różne sprawy: pierwsza nie jest różnicą, druga
blokuje. Reguły:
- **Każde inne słowo to zmieniona treść i blokada.** Nie ma progu „prawie pasuje". Wynik podaje
parę: słowo z cytatu i słowo ze źródła. Pole `twarda` mówi, czy różnica dotyczy liczby,
liczebnika, miesiąca, przeczenia albo spójnika.
- **Przecinki, nawiasy i cudzysłowy nie są treścią.** Kropka, średnik, dwukropek, `§`, `%`, liczby
z przecinkiem (`2,5`) i cyfry w indeksie górnym są porównywane jak słowa.
- **Luka w cytacie jest sprawdzana, nie przepuszczana.** Segmenty muszą stać w źródle po kolei.
Wycięty tekst zawsze wraca w polu `opuszczone`. Jeśli luka wycina liczbę, spójnik, przeczenie,
wyjątek, słowo kierunku („przed", „po", „mniej", „więcej") albo słowo z przedrostkiem
„nie-"/„bez-", wynik to blokada.
- **Odnośnik redakcyjny tekstu jednolitego** przyklejony do słowa (`zdrowia.4)`) nie liczy się
jako różnica, gdy cytat go pomija. Inny numer odnośnika w cytacie jest różnicą.
- **Wyraz inaczej połamany to ten sam wyraz.** „napra- wienia" i „naprawienia" są zgodne. Przy
cyfrach podział jest treścią: „1 25 zł" to nie „125 zł". Wyjątek: poprawny zapis tysięcy
(„10 000" i „10000").
- **Wtrącenie cytującego w nawiasie kwadratowym** („jeżeli [spółka] została zawarta") jest pomijane
przy porównaniu i wraca w polu `wtracenia`. Wtrącenie ze słowem zmieniającym sens („[nie]",
„[bez]", „[lub ...]") blokuje. `[...]` to luka, a `[1]` przy numerze jednostki to indeks.
Kody powodu (`powod_kod`) i to, co niosą:
| Kod | Status | Co się stało | Co pokazać człowiekowi |
|---|---|---|---|
| `zmieniona_tresc` | 🔴 | co najmniej jedno słowo cytatu jest inne niż w źródle | pary z `roznice`: słowo z cytatu i słowo ze źródła |
| `opuszczenie_istotne` | 🔴 | luka wycina słowo, które może zmienić sens | `opuszczone` i `opuszczone_istotne` |
| `opuszczenie_za_szerokie` | 🔴 | segmenty cytatu stoją w źródle ponad 40 słów od siebie | `fragment_zrodla` |
| `opuszczenie_niesprawdzalne` | 🔴 | segment cytatu z luką ma mniej niż 3 słowa | sam cytat |
| `wtracenie_istotne` | 🔴 | cytat dopisuje w nawiasie kwadratowym słowo zmieniające sens („Sąd [nie] może") | `wtracenia` i `wtracenia_istotne` |
| `krotki_cytat_niezgodny` | 🔴 | cytat krótszy niż 3 słowa z liczbą, przeczeniem albo spójnikiem nie stoi w źródle dosłownie | `fragmenty_zrodla` |
| `diakrytyki` | 🟡 | słowa różnią się wyłącznie znakami diakrytycznymi (ślad OCR) | pary z `roznice` |
| `znaki` | 🟡 | cytat krótszy niż 3 słowa, bez liczby, przeczenia i spójnika, różni się pojedynczymi znakami | `fragmenty_zrodla` |
Zweryfikowany cytat z luką nie ma kodu powodu, ale ma pole `opuszczone` - też je pokaż.
Czego to porównanie nie ocenia: kompletności myśli. Wierny fragment urwany przed wyjątkiem
(„kara wynosi 5 lat" przy źródłowym „..., chyba że sąd orzeknie inaczej") przechodzi, bo
sprawdzane są słowa, które cytujący podał. Lista słów istotnych w luce jest listą form, a nie
analizą składni. Dlatego przy każdej luce pokaż człowiekowi pole `opuszczone`, a nie sam status.
### Reguła normalizacji ma JEDEN DOM (od 2026-08-30)
Tablica prawdy: `contract/normalizacja.cases.json` w skillu `doc-intel-contract-pl`
(w tym repo: `dokumenty/skills/doc-intel-contract-pl/`).
Czytają ją **oba** runtime'y - ten skrypt (Node) i `evidence.py` (Python) po stronie
`doc-intel-contract-pl`. Zgodność jest bramkowana w obu zestawach testów; zmiana samej
tablicy zapala oba naraz (sprawdzone mutacją).
Dlaczego to powstało: do 08-30 każda strona miała własną implementację tej samej reguły.
Tutejsza gubiła **sześć z ośmiu** mierzonych znaków, które polski PDF wstawia naprawdę -
`U+2011` w sygnaturach akt, `U+00AD` w justowanych akapitach, `U+2212`, `U+200B`, `U+2026`
oraz wejście w NFD. Skutek był groźniejszy niż przeoczenie: na poziomie **FRAGMENT** skrypt
orzekał „cytatu nie ma w źródle" o cytacie, który tam był - czyli stawiał zarzut halucynacji,
którego przyczyną był błąd normalizacji. Ten sam fakt w dwóch domach rozjeżdża się po cichu.
## Raport (dla użytkownika)
```
## Raport grounding (gradient) - <nazwa deliverable>
| ID | Źródło | Typ | Wym.→Osiąg. | Status | Uwaga |
|----|---------------|------------------|--------------------|-------------------|-----------------------------------------|
| C1 | II CSK 123/19 | cytat_doslowny | FRAGMENT→FRAGMENT | 🟢 ZWERYFIKOWANY | znak 4821 |
| C2 | I CSK 50/18 | stanowisko_sadu | TREŚĆ→TREŚĆ | 🟡 WYMAGA_OSADU | terminy 86% - potwierdź substancję |
| C3 | III CZP 5/21 | cytat_doslowny | FRAGMENT→ISTNIENIE | 🔴 NIEZWERYFIKOWANY| brak w źródle - BLOKADA |
| C4 | I CSK 50/18 | cytat_doslowny | FRAGMENT→TREŚĆ | 🟠 KALIBRACJA | złagodź do parafrazy lub oznacz prowizor.|
| C5 | II CSK 999/19 | fakt_proceduralny| ISTNIENIE→BRAK | 🔴 NIEZWERYFIKOWANY| rozbieżna sygnatura - możliwe falszerstwo|
| C6 | I CSK 50/18 | cytat_doslowny | FRAGMENT→BRAK | 🔴 NIEZWERYFIKOWANY| zmieniona treść: „15" zamiast „14" |
| C7 | II CSK 123/19 | cytat_doslowny | FRAGMENT→BRAK | 🔴 NIEZWERYFIKOWANY| luka wycina: „nie może" |
| C8 | III CZP 5/21 | cytat_doslowny | FRAGMENT→FRAGMENT | 🟢 ZWERYFIKOWANY | luka pomija: „w szczególności" |
Wynik: 2/8 zweryfikowane. 4 blokady (C3, C5, C6, C7), 1 kalibracja (C4), 1 do osądu (C2).
NIE publikuj dopóki C3, C5, C6 i C7 nie zostaną poprawione lub usunięte. C4 wymaga złagodzenia tezy.
Przy C8 sprawdź, czy pominięte słowa nie zmieniają sensu.
```
## Ochrona danych (RODO)
- Skill działa **w całości lokalnie** - normalizacja i string-match w Node, bez wywołań sieciowych.
(Rozwiązywanie kotwic przez SAOS/EUR-Lex robi agent osobnym krokiem - skrypt dostaje gotowy `anchor_resolved`.)
- Dla materiałów objętych tajemnicą zawodową: pseudonimizuj wcześniej przez `let-it-be`.
- Skrypt nie zapisuje logów poza katalogiem zadania.
## Integracja z AI Act
Mechaniczny grounding to dowód należytej staranności i element dokumentacji z art. 12 (rejestrowanie
zdarzeń) oraz nadzoru człowieka z art. 14. Gradient dodaje wymiar **kalibracji ryzyka**: poziom
weryfikacji per twierdzenie to ślad, jak mocno każda teza jest osadzona. Raport grounding wkładaj
do `legal-ai-audit-bundle` obok deliverable.
## Integracja z innymi skillami
- **`legal-request-router-pl`** routuje TU, gdy zapytanie zawiera powołania. Wysoka stawka →
rozwiąż wszystkie kotwice (ISTNIENIE) + paraphrase-judge na 🟡.
- **`saos-orzecznictwo` / `eu-sparql-search`** = resolver kotwic (dają `anchor_resolved`) i źródło tekstu.
- **`deliverable-fidelity-pl`** pyta „czy nic nie wypadło z podsumowania"; ten skill pyta „czy to,
co zostało, jest prawdziwe". Komplementarne - oba przed wysłaniem high-stakes.
- 🟡 `WYMAGA_OSADU` to dokładnie wejście dla warstwy paraphrase-judge (kaskada PATRON) -
mechanika robi tani pre-filtr, osąd substancji robi człowiek lub model.
## Atrybucja
- Pattern mechanicznego groundingu (v1) zainspirowany AnttiHero/lavern (Apache 2.0, ADR-011).
- Guard STRONY (v2.1): wzorzec porównania nazw stron (Jaccard name-mismatch) zainspirowany funkcją
`_is_name_mismatch` z `john-walkoe/courtlistener_citations_mcp` (MIT, 2026). Zaadaptowano **ideę**
(parse → porównaj nazwy stron zadeklarowane vs rozwiązane → flaguj rozbieżność); kod, stop-lista
form prawnych PL/EU i progi napisane od zera. Logika walidacji reporterów US z tamtego repo NIE jest
przenoszona - żyje po stronie serwera CourtListener (wywołanie sieciowe + token), co łamie kontrakt
zero-cloud; z repo bierzemy tylko lokalną, jurysdykcyjnie-neutralną heurystykę nazw stron.
- Kontrakt generacyjny (v2.2): trójklasa znakowania przy generacji (Zweryfikowane / Do sprawdzenia /
Nie używać, tag przy linii, fail-closed dla klasy 3) - adaptacja „kolmiportainen varmuusmerkintä"
z `akunikkola/claude-for-legal-finland` (MIT, [references/viittaustyyli.md](https://github.com/akunikkola/claude-for-legal-finland/blob/main/references/viittaustyyli.md)). Stamtąd też lekcja
dyscypliny placeholderów w przykładach (audyt siostrzanego projektu DE: ~58% złych sygnatur).
- Dyskonto języka szablonowego (v2.3): wzorzec `COMMON_LEGAL_PHRASES` z `AnttiHero/lavern`
(Apache 2.0, `src/mcp/tools/grounding-verifier.ts`) - trafiona fraza-wytrych liczy się 0.5 zamiast
1.0, żeby boilerplate nie zawyżał dowodu. Lista polskich fraz („z zastrzeżeniem", „w szczególności",
„chyba że umowa stanowi inaczej"...) i kod napisane od zera.
- Zbieżność fragmentu (v2.3): wzorzec `citation-content-matcher` z `chrisryugj/korean-law-mcp`
(MIT) - n-gram-Jaccard twierdzenia z najlepszym oknem źródła łapie „prawdziwe słowa, fałszywa
teza" (terminy obecne, ale rozproszone; żaden zwarty fragment nie odpowiada tezie). Tam bigramy
znakowe (koreański: 1 znak = sylaba); tu TRIGRAMY dla polskiego alfabetu łacińskiego (zmierzone
na fixture: bigram dawał szum 0.33 na rozproszeniu, trigram 0.15 przy parafrazie 0.45-0.78).
Wyłącznie sygnał (uwaga dla człowieka), nigdy samodzielna blokada. Kod i progi od zera.
- Porównanie na słowach (v3.0): pomysł, żeby różnice dzielić na twarde (liczba, przeczenie) i
pozostałe oraz żeby cytat rozbijać na segmenty w miejscach opuszczeń, pochodzi z
`altanziya/eu-ai-act-mcp` (Apache 2.0). Tam jest próg dopuszczalnych różnic; tu go nie ma -
każde inne słowo blokuje. Kod, polskie słowniki i reguły luki napisane od zera.
- Gradient weryfikacji (v2): ISTNIENIE/TREŚĆ/FRAGMENT to adaptacja Existence/Content/Paragraph
z `jeannesulzer/international-criminal-tribunals-skills` (CC BY 4.0, Jeanne Sulzer / Impact
Litigation Lab, 2026). Zaadaptowano **ideę gradientu i regułę kalibracji**, nie kod ani treść -
ich biblioteka to dyscyplina promptowa pod web_fetch publicznych archiwów; tutaj to mechaniczny
silnik string-match pod lokalne źródła PL (RODO, zero-egress). Kod, prompty i reguły normalizacji
napisane od zera pod polskie realia (cudzysłowy „…", sygnatury SN/NSA/TSUE, CELEX).
<!-- shared-rules:begin (wygenerowane z ../../SHARED-RULES.md przez scripts/shared-rules-sync.py - nie edytuj tutaj) -->
## Wspólne reguły wtyczki fundament-weryfikacyjny (Fundament weryfikacyjny)
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. Pełniejszy standard: https://github.com/matematicsolutions/awesome-matematic-skills-pl/tree/main/references
### Pięć warstw ochrony (przed każdym disclaimerem)
1. **Weryfikacja źródła** - przepisy i orzecznictwo z baz, nie z pamięci modelu.
2. **Klasa pewności** - każda teza prawna oznaczona: zweryfikowane / do sprawdzenia / nie używać.
3. **Kontrola przesłanek** - fakty od użytkownika sprawdza się przed analizą.
4. **Jawny zakres ujemny** - każdy skill mówi, czego NIE robi.
5. **Bramka człowieka** - uprawniona osoba sprawdza i zatwierdza wynik.
Jeśli błąd przeszedłby bez zatrzymania przez warstwy 1-5, wina jest w skillu. Naprawiamy narzędzie, nie dopisujemy noty. Nota "to nie porada prawna" nie zatrzymuje błędu i nie przenosi odpowiedzialności.
### Tagi pewności
- **Zweryfikowane** - źródło sprawdzone w sesji, z pełną sygnaturą: `(kodeks cywilny art. 415)`, `(wyrok SN II CSK NN/RR, SAOS)`.
- **Do sprawdzenia** - prawdopodobne, niezweryfikowane: `[sprawdź w SAOS]`.
- **Nie używać** - zmyślona sygnatura lub przepis. Pomiń, nigdy nie wymyślaj numeru.
Tag stoi przy linii, której dotyczy. Samo istnienie sygnatury nie wystarcza - treść trzeba sprawdzić.
### Bramka człowieka
Nic nie zostaje wysłane, złożone, podpisane ani opublikowane, zanim sprawdzi i zatwierdzi to uprawniony człowiek. Wynik skilla to projekt, nie gotowy dokument.
### Zakres pluginu
Fundament weryfikacyjny jest neutralny jurysdykcyjnie - to rdzeń metody, nie substancja prawa. Nie łączy się z żadnym źródłem zewnętrznym (brak konektorów MCP) i nie wysyła danych na zewnątrz. Substancję dostarczają osobne pluginy (orzecznictwo, dokumenty).
<!-- shared-rules:end -->
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |