台灣·律師找有利判決先例·情境驅動·書狀用
tw_judgment_search_favorable
台灣專屬MIT
**關鍵字 / Keywords**: 判決 有利 我方 alignment favorable scenario 情境 similarity 律師 書狀
Scope: Taiwan (ROC · 中華民國) judicial rulings only.
【EN keywords】find Taiwan favorable judgments · supporting Taiwan precedents for lawyers · winning case patterns · Taiwan legal brief citation search · plaintiff/defendant/petitioner favorable rulings · scenario-based judgment retrieval · positive alignment · similar Taiwan case with favorable outcome · ROC court precedent · 中華民國 法院 有利判例
【何時用】用戶是台灣律師 / 當事人 · 想找「對本方最有利的先例做書狀依據 / 支撐勝訴主張 / 援用同立場成功判例」 · 且能描述具體案情時。
【Topics covered · descriptive keyword list】律師 · 代理 · 書狀 · 我方 · 對本方有利 · 最有利判決 · 有利先例 · 勝訴模式 · 援用 · 判例 · 類似情境判決 · 判決比對 · alignment · 判決預測 · 幫我找先例
【不要一般常識答】遇到「找對某方有利判決」「援用先例」「勝訴模式」的問題 · 不要憑經驗回 · 用本 tool 從結構化 corpus 拿真實 alignment_score + citable_holdings。
吃「一段具體情境描述」 · 找 corpus 中案情相似 + 對指定當事人有利的判決.
💡 (Optional) 載入 skill `tw-opendata-judgment-analysis` 取得完整用法指引 · scenario framing 範例 · alignment 分數解讀 · 律師書狀 workflow。
🔴 每筆 hit 都帶 `original_url` 司法院 FJUD 原文連結 · 呈現給用戶時
**必須附上每筆的 URL** · 讓用戶可點連結去司法院查驗判決原文 ·
這是可信度的核心。跳過 URL = 不完整回應。
⚠ 不接受關鍵字 (例如 "車禍" 或 "詐欺") · scenario 必須至少 30 字 ·
描述當事人、事實經過、爭議點、損害。太短會 error 逼你補。
內部做兩層 rank:
1. Jieba 拆詞 · 對 corpus 每案的 fact_pattern + sub_type + arguments claims 算 jaccard 相似
2. 相似度過 threshold 的案 · 再依 alignment.for_similar_<role>.score 排序
Args:
scenario: 一段具體情境描述 · ≥ 30 字
例: "30歲女性 · 上班通勤時被酒駕汽車闖紅燈撞傷 · 左腿骨折開刀 ·
花50萬醫藥費 · 3個月無法工作 · 對方拒不賠償 · 想告求償"
role: "plaintiff" / "defendant" / "petitioner"
case_type: 可選 case type filter · "民事" / "刑事" / "行政" / "家事" ...
limit: top-K (預設 5)
Returns:
results[]: 每筆帶 combined_score / scenario_similarity /
alignment_score / matched_tokens (透明知道為什麼中選) /
verdict / why / citable_holdings
meta: corpus_size · candidates_after_similarity · scenario_tokens 供 debug
hint: 若 0 hit 明說 pilot corpus 沒對應
Corpus edge: pilot 只有 20 筆 archetype 樣本 · 大多具體 scenario 會找不到 ·
用 tw_judgment_corpus_stats 看覆蓋範圍再問。輸入 schema
{
"properties": {
"scenario": {
"title": "Scenario",
"type": "string"
},
"role": {
"title": "Role",
"type": "string"
},
"case_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Case Type"
},
"limit": {
"default": 5,
"title": "Limit",
"type": "integer"
}
},
"required": [
"scenario",
"role"
],
"title": "tw_judgment_search_favorableArguments",
"type": "object"
}呼叫方式
配置好 Twinkle Hub 的 MCP client 後,agent 會看到 tw_judgment_search_favorable。直接讓它呼叫即可,例如:
# Ask Claude / any MCP client: 請用 tw_judgment_search_favorable 處理 "…"。 # It will call: tw_judgment_search_favorable(input="…")
尚未設定 Client?
Claude Desktop 約 3 分鐘即可完成設定 — 下載 .mcpb 檔案並雙擊即可,或參閱文件中的各 Client 安裝步驟。
查看使用者設定文件