harvester-query
Specter's Harvester ist ein FastAPI-Dienst, der zwei Chroma-Sammlungen bedient:
| Sammlung | Inhalt | Wann die API sie verwendet |
|---|---|---|
specter_statutes | 384 US-Kraftfahrzeug-Gesetze (CA, TX, FL, PA, IL, OH) | Standard – bei Anfragen mit US-Gerichtsbarkeit oder allgemeinen Anfragen |
canada_pi_cases | 340 echte kanadische PI-Fälle (CanLII, mit Schadensersatz, Verletzungsart, plaintiff_won, deciding_factor) | Wird automatisch verwendet, wenn die Anfrage Kanada / Ontario / Quebec / Toronto / ONSC / ONCA / canlii / etc. erwähnt, oder wenn ?jurisdiction=Canada bzw. ?state=CA-CAN übergeben wird |
Jeder Verweis, den der Nutzer sieht, muss aus dem Harvester stammen (oder bei Fehlschlag aus einer verifizierten Webquelle). Erfinden Sie niemals etwas.
Wann dieses Skill verwendet werden soll
- Immer bei Sachverhalten, die Kanada oder eine kanadische Provinz / Stadt erwähnen. Die Kanada-Sammlung ist auf Sachverhalte entschiedener Fälle indexiert, daher sind unübersichtliche Sachverhalte ("Kind hat sich vor Target in Ontario verletzt", "Sturz auf vereistem Bürgersteig in Toronto") GENAU das, wofür sie geeignet ist. Führen Sie zuerst
searchaus; stellen Sie Folgefragen erst, nachdem Sie die Treffer gezeigt haben. - Der Nutzer fragt nach einem bestimmten Gesetz: "Was ist Cal. Veh. Code § 23152(a)?" →
lookup_citation - Der Nutzer stellt eine semantische / thematische Frage: "DUI-Gesetze in Kalifornien", "Gesetze zum Texten während der Fahrt" →
search - Der Nutzer stellt eine offene Frage und Sie möchten die besten Kandidaten: "Gibt es einen Bundesstaat mit einer Fahrerflucht-Regelung analog zu CVC 20001?" →
ask - Der Nutzer verwendet ein Synonym ("Rasen", "Alkohol am Steuer", "Texten") – ordnen Sie es einer der 17 kanonischen Unfallfaktorkategorien zu, bevor Sie es als
factor-Filter übergeben (siehe Kategorien unten).
Wann es NICHT verwendet werden soll
- Reine Verfahrens- oder Strategiefragen ("Wie reiche ich Klage ein?") – der Harvester enthält nur US-Gesetze und kanadische Rechtsprechung.
- Begrüßungen, Fragen zur Identität, Persönlichkeitschecks – beantworten Sie sie in Ihrer Stimme, ohne die API aufzurufen.
- Fragen, die keinen Verweis erfordern (Specter kann allgemeine PI-Rechtsfragen kurz ohne Verweis beantworten, darf aber keinen Verweis erfinden, um sie zu untermauern).
Wichtig: Nicht hinter Nachfragen verstecken
Insbesondere bei kanadischen Sachverhaltsanfragen: Rufen Sie search zuerst mit dem auf, was der Nutzer gesagt hat, auch wenn es vage ist. Zeigen Sie die Top-Treffer, DANN stellen Sie Folgefragen. Der Kanada-Korpus ist sachverhaltsindexiert – dünne Anfragen liefern trotzdem relevante Fälle. Mehr Fakten einzufordern, bevor Sie suchen, verschwendet den Korpus.
Wie man es aufruft
Das Hilfsmodul befindet sich neben dieser SKILL.md:
import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).parent)) # falls ad hoc ausgeführt
from client import lookup_citation, search, ask, healthz, list_factors
In OpenClaw empfiehlt es sich, es mit exec auszuführen:
cd ~/Specter && python3 -m openclaw.skills.harvester_query.client lookup "Cal. Veh. Code § 23152(a)"
cd ~/Specter && python3 -m openclaw.skills.harvester_query.client search "Alkohol am Steuer" --state CA --factor "DUI/DWI"
cd ~/Specter && python3 -m openclaw.skills.harvester_query.client ask "Welche Gesetze decken Fahrerflucht in CA ab?"
Oder aus Python:
from openclaw.skills.harvester_query.client import lookup_citation, search, ask
lookup_citation(citation: str) -> dict | None
Exakte Übereinstimmung nach der Zeichenkette citation. Gibt den vollständigen Eintrag oder None zurück, wenn nicht im Harvester enthalten.
search(q: str, *, state=None, factor=None, pi_only=False, k=10) -> list[dict]
Semantische Suche. state ist ein zweistelliger Code ("CA", "TX"). factor muss eine der 17 kanonischen Kategorien sein.
ask(question: str, *, state=None, factor=None, k=8) -> list[dict]
Wie search, aber als Frage formuliert. Verwenden Sie dies, wenn der Nutzer Ihnen eine natürlichsprachliche Anfrage gibt.
healthz() -> dict
Günstiger Lebendigkeitstest. Verwenden Sie dies, um zu bestätigen, dass die API läuft, bevor Sie einen Fehlschlag melden.
list_factors() -> list[str]
Die 17 Kategorien. Nützlich für die Synonymzuordnung in der Sprache.
So formatieren Sie Ergebnisse für WhatsApp
Specter's Sprachregeln (siehe SOUL.md): Standardmäßig maximal 2–3 Zeilen. Zitieren, nicht rezitieren.
Gut:
Cal. Veh. Code § 22350. Grundlegende Geschwindigkeitsregel – fahren Sie nicht schneller als unter den gegebenen Umständen angemessen. leginfo.legislature.ca.gov
Schlecht:
Selbstverständlich! Gemäß California Vehicle Code Section 22350 darf "niemand ein Fahrzeug führen" … (Textwand)
Fügen Sie immer die source_url aus dem Eintrag hinzu. Fügen Sie niemals einen Verweis ohne eine solche hinzu – gemäß den Hackathon-Spielregeln zählen Einträge ohne echte Quell-URL nicht.
Fehlerbehandlung
Wenn lookup_citation None zurückgibt oder search/ask [] zurückgeben:
- Überprüfen Sie
healthz()– wenn die API nicht läuft, sagen Sie das klar. - Wenn die API läuft, der Eintrag aber nicht vorhanden ist, sagen Sie: "Noch nicht im Harvester." Bieten Sie dann entweder an:
- Aus einer autoritativen Quelle (nur Parlamente, Gerichte, Anwaltskammern) aus dem Web zu holen.
- Oder schlagen Sie vor, dass das Team diese Gerichtsbarkeit aufnimmt.
Überdecken Sie einen Fehlschlag niemals mit einer Schätzung.
Die 17 Kategorien der Unfallfaktoren (kanonisch, nicht erfinden)
DUI/DWI
Driving Too Fast For Conditions
Failure to Maintain Lane
Failure to Obey Traffic Control Device
Failure to Use/Activate Horn
Failure to Yield at a Yield Sign
Failure to Yield the Right-of-Way
Fleeing a Police Officer
Fleeing the Scene of a Collision
Following Too Closely
Improper Lane of Travel
Improper Passing
Improper Starting
Improper Stopping
Improper Turning
Reckless Driving
Using a Wireless Telephone/Texting While Driving
Wenn der Nutzer ein Synonym verwendet, ordnen Sie es intern zu und antworten Sie in seinen Worten.