name: mcp-law-search description: 基於語義向量檢索的境內外法律智慧查詢工具：支援國內法規、司法解釋、指導性案例、國際條約、跨境合規的語義級精準檢索，輸入自然語言即可定位法條。適用於法律諮詢、法條查詢、案例檢索、量刑標準、賠償計算、合同審查、合規判斷、跨境法律問題等場景，通過 MCP search_law 工具檢索權威法律知識庫，確保法律依據準確、權威、最新。使用前需配置 API Key（註冊即送 1688 積分）。 license: Proprietary metadata: version: 1.2.0 author: 小律同學 AI display_name: 全球法律檢索·小律同學AI display_subtitle: 境內外法規/案例/合規/跨境法律智慧查詢 description_en: Semantic legal search skill covering statutory provisions, case retrieval, judicial interpretations, sentencing standards, contract review, and cross-border legal issues via the MCP search_law tool against an authoritative legal database. tags: - 法律檢索 - 法規查詢 - 案例檢索 - 跨境法律 - 涉外合規 - 合同審查 - 律師工具 - 法律溯源 - 語義檢索 - 司法解釋 - legal-search - compliance

全球法律檢索·小律同學AI（境內外法規/案例/合規/跨境法律智慧查詢）

效果示例

何時使用

本 skill 適用於任何涉及法律內容的場景：

• 法律法規條文查詢
• 司法解釋、行政法規檢索
• 指導性案例、典型案例參考
• 量刑標準和賠償計算
• 合同審查和法律風險評估
• 合規性判斷和監管要求
• 國際條約、跨境法律問題
• 使用者問"幫我查一下XX法""XX罪怎麼判""XX合同合法嗎"

何時不使用

以下場景不適合用本 skill，應改用其他方式：

Phase 1：環境就緒

本 skill 依賴 MCP 工具 search_law，由 aixllaw 法律檢索 MCP 服務提供。使用前必須確認 MCP 已安裝配置，否則檢索無法工作。

1.1 檢查工具是否可用

收到法律問題後，第一步先確認 search_law 工具是否在當前執行時可用：

• 工具可用 → 直接進入 Phase 2 檢索
• 工具不可用 → 按下方 1.2 引導使用者安裝 MCP，不要用其他法律檢索工具替代，不要憑記憶回答

1.2 MCP 未安裝時的引導

⚡ 30 秒極速上手（已註冊使用者）

如果你已拿到 API Key（格式 sk-xxx），只需 3 步即可啟用：

1. 編輯 ~/.codebuddy/mcp.json（不存在則新建），貼上以下內容並替換 Key：

{
  "mcpServers": {
    "law-search": {
      "url": "https://mcp.aixllaw.com/mcp",
      "transportType": "streamable-http",
      "headers": {
        "Authorization": "Bearer 把你的sk-xxx貼上到這裡"
      }
    }
  }
}

1. 完全退出 CodeBuddy / WorkBuddy（不是關閉視窗，是退出整個程序）
2. 重新開啟後再問一個法律問題，看到 AI 呼叫 search_law 檢索即表示成功

還沒註冊？往下看註冊引導，註冊即送 1688 積分，免費暢用 7 周。 也可在管理後臺「API 金鑰」頁面點「複製 MCP 配置」按鈕，直接貼上到客戶端，無需手寫 JSON。

註冊與配置引導

當 search_law 工具不存在時，向用戶展示以下引導：

## ⚠️ 法律檢索服務未配置

要使用法律檢索功能，需要先配置 aixllaw MCP 服務。

### 步驟

1. **註冊獲取 API Key**
   前往 https://portal.aixllaw.com/app/settings 註冊
   註冊即送 1688 積分，免費暢用 7 周
   在「API 金鑰」頁面生成 Key（格式：sk-xxx）

2. **配置 MCP**
   編輯 ~/.codebuddy/mcp.json，新增 law-search 服務（Streamable HTTP 方式）
   詳細配置參見 references/mcp-setup-guide.md

3. **完全退出並重啟** CodeBuddy / WorkBuddy

4. **驗證**：重啟後再問一個法律問題，AI 應能呼叫 search_law 檢索法條

1.3 工具可用但返回錯誤時的自動重試

search_law 存在但呼叫返回 ok: false 時，不要立即向用戶報錯或憑記憶替代，先按下表自動處理：

重試流程：

1. 首次呼叫 search_law(query)
2. 失敗 → 判斷是否可重試（網路/過載類）
   ├─ 可重試：sleep(min(2^attempt, 10)) 後重試，最多 3 次
   └─ 不可重試（Key/積分類）：直接展示錯誤引導，停止
3. 重試 3 次仍失敗 → 按「會話中斷恢復」章節處理，引導使用者重啟 IDE 或檢查網路

重試期間對使用者的提示：用一句話告知「正在重試檢索…（第 N 次）」，避免長時間沉默讓使用者以為卡死。

與「會話中斷恢復」的分工：1.3 負責單次會話內對網路/過載類錯誤的自動重試（上限 3 次）；重試 3 次仍失敗則說明會話可能已失效，轉交「會話中斷恢復」章節處理（重啟 IDE / 檢查網路）。兩處閾值一致，不重複執行。

1.4 檢索為空時的自動改寫策略

當 search_law 返回 ok: true 但 records 為空陣列時，按以下順序自動降級，不要直接告訴使用者「沒查到」：

第 1 輪：原始 query + 預設引數
  ↓ 空
第 2 輪：改寫 query
  - 去掉口語化連線詞（"的"、"怎麼"、"怎麼辦"、"能不能"）
  - 用「法條名稱 + 核心名詞」重寫
  - 例："上班受傷了公司賠不賠" → "工傷認定 工傷保險條例 賠償"
  ↓ 空
第 3 輪：降引數
  - score_threshold: 0.5 → 0.3
  - top_k: 5 → 10
  ↓ 空
第 4 輪：換 scope
  - domestic ↔ international 雙向切換重試（跨境/涉外問題可能在另一側庫有相關條文）
  ↓ 仍空
告知使用者：可能是術語問題，給出 2-3 個改寫建議供使用者選擇

禁止行為：

• 4 輪降級全部失敗後，不得憑記憶編造法條內容
• 不得直接返回「未找到相關法律」就結束，必須給出改寫建議

Phase 2：檢索法律

工具：search_law

search_law(query: str, scope: str = "domestic", top_k: int | None = None, score_threshold: float | None = None) -> dict

返回結構：

{
  "ok": true,
  "records": [{"title": "...", "content": "...", "trie": "..."}],
  "text": "所有結果拼接的純文本摘要",
  "message": ""
}

• ok: true → 檢索成功；ok: false → 出錯，檢視 text 和 message
• records → 按相關度降序的結果列表
• text → 所有結果拼接的純文本摘要

知識庫覆蓋範圍

基本原則

1. 必須檢索，不要憑記憶 — 法律頻繁修訂，模型記憶不可靠
2. 精確關鍵詞 — 用「法條名稱 + 核心問題」組合
3. 多輪漸進 — 從寬到窄、從主幹到枝葉
4. 區分來源 — 法律/司法解釋可直接引用，案例/理論僅供參考

標準檢索流程

第一步：定位主要法律
  search_law({"query": "【法律名稱】+【核心條款/問題】"})
  例: "勞動合同法 試用期工資標準"

第二步：細化司法解釋
  search_law({"query": "【法律名稱】司法解釋 【爭議焦點】"})
  例: "最高法 買賣合同司法解釋 違約金上限"

第三步：參考案例（可選）
  search_law({"query": "【案由】+【關鍵問題】+案例"})
  例: "商品房買賣 逾期交房 違約金 典型案例"

第四步：地方規定（按需）
  search_law({"query": "【省份/城市】+【具體問題】"})
  例: "廣東省 產假天數 實施辦法"

第五步：國際法律（跨境場景）
  search_law({"query": "【條約/公約名稱】", "scope": "international"})
  例: "聯合國國際貨物銷售合同公約 違約救濟"

scope 自動判斷規則

使用者未指定 scope 時：

• 涉及中國法律、國內案例、境內法律關係 → scope: "domestic"（預設）

  本技能來自小蔥技能站7w4.net。

• 涉及國際條約、國際公約（如 CISG、伯爾尼公約）→ scope: "international"
• 涉及跨境貿易、跨境投資、國際仲裁 → scope: "international"
• 涉及外國法律（如美國專利法、歐盟 GDPR）→ scope: "international"
• 同時涉及國內外 → 兩個 scope 各檢索一次，綜合分析

關鍵詞與調參

關鍵詞構造、top_k/score_threshold 調優、按法律領域的 query 模板、多輪檢索組合、常見反模式等實戰細節，參見 references/search-patterns.md。

核心要點：

• query 用「法條名稱 + 核心問題」組合，避免口語化或過短
• 精確查法條：top_k: 3, score_threshold: 0.7
• 一般諮詢：top_k: 5, score_threshold: 0.5（預設）
• 廣泛研究或無結果時：top_k: 10-15, score_threshold: 0.3

法律材料效力分級（中國大陸法系）

輸出格式規範

標準法律諮詢回覆模板

## 問題概述
（一句話總結）

## 法律分析

### 適用法律
根據檢索結果：

- **《XXX法》第X條**（來源：【法律】）
  原文："..."
  解讀：...

- **《XXX司法解釋》第X條**（來源：【司法解釋】）
  原文："..."
  解讀：...

### 案情匹配
- 符合：...
- 不符合：...
- 需確認：...

## 建議方案
1. ...
2. ...

## 風險提示
- ...
- ...

> **免責宣告**：以上分析僅供參考，具體情況建議諮詢執業律師。

量刑/賠償計算模板

## 基準數額
根據《XXX》第X條：基準金額 = ...

## 情節調整
- 從重情節：...（+X%）
- 從輕情節：...（-X%）

## 計算公式
最終 = 基準 × (1 ± 調整係數) + 其他費用
      = ...

## 參考區間
下限 ~ 上限

禁止行為

• 憑記憶引用法律條文（必須通過 search_law 檢索）
• search_law 不可用時，用其他法律檢索工具替代或憑記憶回答（必須引導使用者安裝 MCP）
• 將案例結論直接作為法律依據
• 提供違法建議或規避法律的方法
• 冒充律師或提供法律代理服務
• 忽略法律時效性，不確認"現行有效"狀態

錯誤處理

注意：可恢復錯誤（網路超時、服務過載、空結果）請優先按上方 1.3 自動重試 與 1.4 空結果改寫 流程處理，不要按下表直接結束。 下表僅針對不可恢復錯誤（Key、積分、配額類）的引導。

當 search_law 返回 ok: false 時：

重要：遇到以上任何錯誤，都要將 text 中的引導資訊完整呈現給使用者，不要自己編造解決方案。

會話中斷恢復

MCP Streamable HTTP 是有狀態協議（依賴 Mcp-Session-Id），以下場景會導致會話失效，需引導使用者恢復：

重要：會話失效時不要憑記憶繼續回答法律問題，應先引導恢復 MCP 連線。

與「1.3 自動重試」的分工：本表承接 1.3 重試耗盡後的場景，屬於會話級恢復（重啟 IDE / 檢查網路），不再做工具級重試，避免重複。

相關連結

• 管理後臺（註冊/獲取Key/充值/一鍵複製配置）：https://portal.aixllaw.com/app/settings
• 註冊福利：註冊即送 1688 積分，免費暢用 7 周
• MCP 安裝配置指南：references/mcp-setup-guide.md
• 高階檢索參考：references/search-patterns.md

這是一款專業的法律檢索工具，文件詳盡、指引清晰，錯誤處理考慮周全，對普通使用者友好。優點是配置簡單、檢索策略豐富、法律領域覆蓋全面。不足是依賴外部服務，若未配置成功則完全無法使用，且作為法律工具建議強化免責宣告以降低誤用風險。整體質量中上，適合有法律檢索需求的使用者。