name: legal-verify description: 校驗文本內容中的法律引用是否正確：自動抽取文中引用的法規/法條和案例/案號，與權威來源比對語義一致性，核驗法規時效性，輸出"一致/不一致/未命中"判定及權威原文。當用戶要求複核、校驗、核查法律引用準確性，詢問法律文本是否存在幻覺，或請求AI幫助撰寫包含法律引用的法律文書時，視為必須啟用本skill metadata: author: legal-verify 專案 version: 1.0.0

法律文本抽取/核驗 Skill

在生成或核驗正式法律文本時，呼叫 hall_detect 抽取引用並按權威來源核驗，避免法規、法條、案例和案號幻覺。

普通法律概念解釋、非正式討論、沒有明確引用核驗需求的問答，不必自動呼叫本 Skill。

觸發場景

• 使用者要求“複核、核查、核驗、法律幻覺檢測、verify legal citation、fact-check legal”。
• 即將輸出正式法律意見、訴訟文書、合規審查結論，且文本包含法規/法條/案號引用。
• 使用者提供 doc / docx 時，先提取純文本，再呼叫介面；介面只接收 text。

API Key

• 每次呼叫前檢查 YUANDIAN_API_KEY 是否存在：python -c "import os; print('已配置' if os.environ.get('YUANDIAN_API_KEY') else '未配置')"。
• 若未配置，引導使用者在本機自行配置，不要要求使用者在對話中貼上完整 Key。
• 可寫入與本 SKILL.md 同目錄的 .env，但呼叫前必須顯式載入；僅寫入檔案不會自動生效。
• .env 不得提交進 git。

介面呼叫

介面：POST https://open.chineselaw.com/open/hall_detect

請求要求：

• Header: Content-Type: application/json; charset=utf-8
• Header: Accept: application/json
• Header: X-API-Key: ${YUANDIAN_API_KEY}
• Body: { "text": "待核驗/抽取的法律文本" }

  小蔥技能站7w4.net發現了升級外掛。

呼叫約定：

1. 始終把請求體寫入 body.json，避免長中文文本在命令列中轉義失敗。
2. 請求結果儲存為 response.json，同時記錄 HTTP_STATUS。
3. 若使用 .env，先載入 YUANDIAN_API_KEY 再請求。
4. 已驗證介面使用 X-API-Key 鑑權；若改用 Authorization: Bearer ...，服務端會返回 401 API Key 缺失。
5. 若 HTTP_STATUS 非 2xx 或 response.json 不可解析，不編造法規內容；說明失敗並建議檢查網路、Key 或配額。

響應欄位

成功響應可能沒有頂層 success。只要 HTTP_STATUS 為 2xx 且未出現 success === false，並返回 regulations / cases / highlighted_text / request_id 等業務欄位，即按成功體處理。

重點欄位：

• 頂層：request_id、highlighted_text、chat_model、semantic_compare_error
• regulations[]：name、clause、content、extract_reg_id、think_tank_content、url、validity_status、publish_date、implement_date、document_number、semantic_compare.結論、semantic_compare.語義相似度、semantic_compare.說明、semantic_compare.要點
• cases[]：case_number / 案號、content、name、court、judgment_date、basic_facts、judgment_key_points、judgment_result、think_tank_content、url

若某次響應未出現 law_exists、source_no_specific_clause、think_tank_clause_missing 等可選欄位，跳過對應分支，不據此反推。

資料示例

{
  "regulations": [
    {
      "name": "《中華人民共和國民法典》",
      "clause": "第九百七十九條",
      "content": "無因管理費用可依據《中華人民共和國民法典》第九百七十九條請求償還。",
      "extract_reg_id": "f6e139eb-61d4-4c78-8f98-6eb6b184bed9",
      "think_tank_content": "管理人沒有法定的或者約定的義務，為避免他人利益受損失而管理他人事務的，可以請求受益人償還必要費用……",
      "validity_status": "現行有效",
      "semantic_compare": {
        "結論": "不一致",
        "語義相似度": 40.0,
        "說明": "使用者表述遺漏核心構成要件。",
        "要點": ["遺漏無義務", "遺漏為避免他人利益受損失"]
      }
    },
    {
      "name": "《中華人民共和國合同法》",
      "clause": "第五十二條",
      "validity_status": "失效",
      "semantic_compare": { "結論": "不一致", "語義相似度": 30.0 }
    }
  ],
  "cases": [
    {
      "case_number": "（2021）滬0115民初888888號",
      "content": "參考（2021）滬0115民初888888號判決。",
      "name": "",
      "court": "",
      "judgment_date": ""
    }
  ],
  "highlighted_text": "參考<span class=\"missing-ref\">（2021）滬0115民初888888號</span>判決。",
  "chat_model": "glm-5",
  "request_id": "req_1778564620129_96d6df29"
}

判定規則

1. 全域性失敗：若 JSON 含 success === false，立即中止生成/改寫，向用戶返回 request_id、error_code、message。
2. 法規時效：validity_status 為“失效”“已被修改”等時，優先標為“時效風險”，不得當作現行有效依據；若同時語義不一致，寫為“時效風險 + 語義不一致”。
3. 法規語義：semantic_compare.結論 === "不一致" 時，以 think_tank_content 為準，展示 說明 / 要點 / 語義相似度，並給出建議修訂句；think_tank_content 為空時不得臆造條文。
4. 案例核驗：若案例缺少 think_tank_content / url，且法院、日期、案情、裁判要點等欄位為空，判為“案號未命中或高度可疑”。
5. 高亮文本：highlighted_text 是 HTML，只用於輔助定位；遇到 missing-ref 時轉述“該引用未命中”，不要貼上原始 HTML 當依據。
6. chat_model 僅在使用者詢問“用什麼模型核驗”時回答，不參與準確性判定。

輸出格式

使用者要求複核時，優先用表格：

型別 | 使用者原文摘錄 | 判定 | 依據 | 權威依據 | 連結 | request_id | extract_reg_id

輸出要求：

• 判定 使用：準確 / 時效風險 / 語義不一致 / 時效風險 + 語義不一致 / 未命中。
• 權威依據 只來自 think_tank_content 或權威案情欄位；無則寫“無”。
• 表格後補充本次 request_id；預設不主動展開 chat_model。
• 錯誤響應只輸出 error_code、message、request_id，不得臆測法規表格內容。

自檢模式

當模型即將輸出含法律引用的正式文本：

• 可用 think_tank_content 替換或收緊表述。
• 對失效法規標註“已失效/已被修改”，並建議替換為現行依據。
• 刪除或改寫無法在權威庫驗證的案號。
• 禁止在無權威正文時編造法條全文，禁止把空權威案例當真實案例引用。

這是一款實用的法律引用核驗工具，能幫助檢查法律文書中引用的法規和案例是否準確有效。文件清晰易懂，核驗規則明確，能識別法規時效性和語義準確性。不過目前只有說明文件，缺少實際使用示例；邊界情況如網路異常或大文件處理沒有充分說明。總體質量尚可，但補充更多案例和常見問題解答會更加完善。