prawo-pl-saos

Polskie orzecznictwo z publicznego API SAOS

Skill do orzecznictwa (judykatury) polskiego: wyroków, postanowień i uchwał. Sięga do publicznego API SAOS (System Analizy Orzeczeń Sądowych, https://www.saos.org.pl/api) — agregatu orzeczeń jawnych: SN, TK, sądy powszechne (SA/SO/SR), KIO. Używaj go zawsze, gdy pytanie dotyczy tego, jak sądy stosują/interpretują przepis, gdy trzeba znaleźć konkretny wyrok po sygnaturze, ustalić linię orzeczniczą albo poprzeć argument w piśmie procesowym judykaturą.

Podział ról (przepis ≠ orzeczenie)

1. Treść przepisu — z ELI, nie z SAOS. Brzmienie polskiej ustawy/kodeksu cytuj przez skill prawo-pl-eli (scripts/eli.py). SAOS daje orzeczenia, nie autorytatywny tekst przepisu.
2. JAK sądy stosują przepis — z SAOS. „Co mówi orzecznictwo o art. 299 k.s.h.", „czy SN dopuszcza…", „linia orzecznicza w sprawie…", „znajdź wyrok sygn. III CSK 203/09" — to zadania dla tego skilla.
3. Most ELI → SAOS: najpierw ustal przepis w ELI, potem szukaj --przepis "..." w SAOS, by znaleźć orzeczenia powołujące ten przepis.
4. Delegując research subagentowi, wpisz: „orzecznictwo polskie pobieraj przez scripts/saos.py (skill prawo-pl-saos); treść przepisów przez scripts/eli.py (prawo-pl-eli)".

Narzędzie

Wszystko robi helper scripts/saos.py (tylko biblioteka standardowa Pythona — bez instalacji). Skrypt leży obok tego pliku SKILL.md (<katalog skilla>/scripts/saos.py) — NIE zakładaj, że to ~/.claude/skills/prawo-pl-saos (skill zainstalowany jako plugin leży w katalogu pluginów; w Claude Code: ${CLAUDE_PLUGIN_ROOT}/skills/prawo-pl-saos). Uruchamiaj wyłącznie helper z bieżącego pakietu:

# 1) Claude Code: przy ładowaniu skilla podstawia ${CLAUDE_PLUGIN_ROOT} (pełna ścieżka poniżej).
SAOS="${CLAUDE_PLUGIN_ROOT}/skills/prawo-pl-saos/scripts/saos.py"
# 2) Codex / Claude Desktop / instalacja ręczna: katalog TEGO pliku SKILL.md (Claude Code podaje go
#    jako „Base directory for this skill”, Codex w liście skilli) — podstaw go zamiast <katalog skilla>.
[ -f "$SAOS" ] || SAOS="<katalog skilla>/scripts/saos.py"
# 3) Piaskownica (Cowork, czat z code execution): katalog pluginu bywa NIEWIDOCZNY dla powłoki — wtedy
#    pobierz DOKŁADNIE tę wersję helpera (tag = wersja z nagłówka tego pliku). Suma SHA-256 jest
#    sprawdzana w kodzie przed zapisem i przed każdym uruchomieniem; niezgodna = helper nie startuje.
[ -f "$SAOS" ] || SAOS=$(python3 - <<'EOF'
import hashlib, os, sys, urllib.request
WERSJA, SHA256 = "2.0.1", "71f87c1eda5e2d8a6084ac8226d3a9513a74564062a937248816040850d7d655"
URL = f"https://raw.githubusercontent.com/jamarpl21/prawo-pl-eli/v{WERSJA}/plugins/prawo-pl-saos/skills/prawo-pl-saos/scripts/saos.py"
p = os.path.join(os.environ.get("TMPDIR", "/tmp"), f"prawo-pl-saos-{WERSJA}", "saos.py")
try:
    dane = open(p, "rb").read() if os.path.exists(p) else urllib.request.urlopen(URL, timeout=30).read()
except Exception as e:
    sys.exit(f"BŁĄD: nie udało się pobrać helpera ({e}). Bez helpera NIE cytuj prawa z pamięci ani z portali — poinformuj użytkownika.")
if hashlib.sha256(dane).hexdigest() != SHA256:
    os.path.exists(p) and os.remove(p)
    sys.exit("BŁĄD: suma SHA-256 helpera nie zgadza się z SKILL.md — helper NIE zostanie uruchomiony. Nie cytuj prawa z pamięci ani z portali — poinformuj użytkownika.")
os.makedirs(os.path.dirname(p), exist_ok=True); open(p, "wb").write(dane); print(p)
EOF
) && [ -f "$SAOS" ] || exit 1
python3 "$SAOS" <komenda> [...]