Find favorable Taiwan precedents by scenario · for lawyer briefs

tw_judgment_search_favorable

TW-specificMIT

**關鍵字 / 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 看覆蓋範圍再問。

Input 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"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see tw_judgment_search_favorable. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 tw_judgment_search_favorable 處理 "…"。

# It will call:
tw_judgment_search_favorable(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs