harvester-query
SpecterのHarvesterは、2つのChromaコレクションを前面に持つFastAPIサービスです:
| コレクション | 内容 | APIが使用するタイミング |
|---|---|---|
specter_statutes | 384件の米国自動車法令(CA、TX、FL、PA、IL、OH) | デフォルト — 米国管轄または一般的なクエリ |
canada_pi_cases | 340件の実際のカナダ人身事故判例(CanLII、損害賠償額、傷害の種類、原告勝訴、決定要因を含む) | クエリにカナダ / オンタリオ / ケベック / トロント / ONSC / ONCA / canlii 等が含まれる場合、または?jurisdiction=Canada または ?state=CA-CAN が渡された場合に自動ルーティング |
ユーザーが目にする引用はすべてHarvesterから(または、見つからなければ検証済みのWebソースから)取得する必要があります。決して捏造しないでください。
このスキルを使用するタイミング
- カナダまたはカナダの州/都市に言及する事実パターンには常に使用します。 カナダのコレクションは判決事例の事実に基づいて索引付けされているため、複雑な事実パターン(「オンタリオのTargetで子どもが怪我をした」、「トロントの凍った歩道で転倒した」など)は、まさにこのスキルが得意とするものです。まず
searchを実行し、ヒットした結果を表示してからフォローアップの質問をします。 - ユーザーが特定の引用を尋ねる場合:「Cal. Veh. Code § 23152(a)って何?」 →
lookup_citation - ユーザーが意味的/トピック的な質問をする場合:「カリフォルニア州のDUI法令」、「運転中のテキスト送信に関する法律」 →
search - ユーザーが自由形式の質問をし、上位候補を求めている場合:「CVC 20001に類似したひき逃げ法がある州は?」 →
ask - ユーザーが同義語(「スピード違反」、「飲酒運転」、「テキスト送信」)を使用した場合 — 17の標準的なcontributing factorカテゴリのいずれかにマッピングしてから、
factorフィルタとして渡します(カテゴリは以下を参照)。
使用しないタイミング
- 純粋な手続き的/戦略的な質問(「どうやって申し立てるの?」) — Harvesterは米国法令とカナダ判例のみを保持しています。
- 挨拶、身分確認、ペルソナの確認 — APIを呼び出さずに音声で回答します。
- 引用を必要としない質問(Specterは簡潔に一般的な人身事故法の概要を回答できますが、裏付けとして引用を捏造してはいけません)。
重要:明確化のために検索を保留しない
特にカナダの事実パターンクエリの場合、ユーザーが言った内容そのまま(たとえ曖昧でも)でまずsearchを呼び出します。上位のヒットを表示してから、フォローアップの質問をします。カナダのコーパスは事実パターンで索引付けされているため、薄いクエリでも関連する判例が返されます。検索前にさらに事実を要求すると、コーパスの利点を活かせません。
呼び出し方法
ヘルパーモジュールはこのSKILL.mdと同じ場所にあります:
import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).parent)) # アドホック実行の場合
from client import lookup_citation, search, ask, healthz, list_factors
OpenClawでは、exec経由で実行することを推奨します:
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 "drunk driving" --state CA --factor "DUI/DWI"
cd ~/Specter && python3 -m openclaw.skills.harvester_query.client ask "what statutes cover hit and run in CA"
またはPythonから:
from openclaw.skills.harvester_query.client import lookup_citation, search, ask
lookup_citation(citation: str) -> dict | None
citation 文字列による完全一致。完全なレコードを返すか、Harvesterに存在しない場合は None を返します。
search(q: str, *, state=None, factor=None, pi_only=False, k=10) -> list[dict]
意味検索。state は2文字のコード("CA"、"TX")。factor は17の標準カテゴリのいずれかである必要があります。
ask(question: str, *, state=None, factor=None, k=8) -> list[dict]
search と同様ですが、質問形式で組み立てられます。ユーザーが自然言語クエリを渡した場合に使用します。
healthz() -> dict
軽量な死活確認。ミスを報告する前にAPIが動作していることを確認するために使用します。
list_factors() -> list[str]
17のカテゴリ。音声での同義語マッピングに便利です。
WhatsApp向け結果のフォーマット方法
Specterの音声ルール(SOUL.md参照):デフォルトで最大2~3行。引用は表示し、全文引用はしない。
良い例:
Cal. Veh. Code § 22350. 基本速度法 — 状況に応じて安全な速度以上で運転してはならない。 leginfo.legislature.ca.gov
悪い例:
もちろんです。カリフォルニア車両法第22350条に基づき、「何人も車両を運転してはならない…」(長文)
レコードからsource_urlを常に含めてください。決してソースURLなしで引用を含めないでください — ハッカソンの基本ルールにより、実際のソースURLのないレコードはカウントされません。
ミス処理
lookup_citation が None を返すか、search/ask が [] を返した場合:
healthz()を確認 — APIがダウンしている場合は、その旨をそのまま伝えます。- APIは稼働しているがレコードがない場合:「まだHarvesterに登録されていません。」 と伝えます。その後、次のいずれかを行います:
- 信頼できる情報源(立法機関、裁判所、弁護士会のみ)からWeb検索で取得することを提案します。
- チームにその管轄のデータを取り込むよう提案します。
ミスを推測でごまかさないでください。
17のcontributing factorカテゴリ(標準、新規作成禁止)
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
ユーザーが同義語を使用した場合は内部でマッピングし、ユーザーの言葉で回答します。