cslawyer1985 法律文本抽取/核验 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": "待核验/抽取的法律文本" }
调用约定：
- 始终把请求体写入
body.json，避免长中文文本在命令行中转义失败。 - 请求结果保存为
response.json，同时记录HTTP_STATUS。 - 若使用
.env，先加载YUANDIAN_API_KEY再请求。 - 已验证接口使用
X-API-Key鉴权；若改用Authorization: Bearer ...，服务端会返回401 API Key 缺失。 - 若
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"
}
判定规则
- 全局失败：若 JSON 含
success === false，立即中止生成/改写，向用户返回request_id、error_code、message。 - 法规时效：
validity_status为“失效”“已被修改”等时，优先标为“时效风险”，不得当作现行有效依据；若同时语义不一致，写为“时效风险 + 语义不一致”。 - 法规语义：
semantic_compare.结论 === "不一致"时，以think_tank_content为准，展示说明/要点/语义相似度，并给出建议修订句；think_tank_content为空时不得臆造条文。 - 案例核验：若案例缺少
think_tank_content/url，且法院、日期、案情、裁判要点等字段为空，判为“案号未命中或高度可疑”。 - 高亮文本：
highlighted_text是 HTML，只用于辅助定位；遇到missing-ref时转述“该引用未命中”，不要粘贴原始 HTML 当依据。 chat_model仅在用户询问“用什么模型核验”时回答，不参与准确性判定。
输出格式
用户要求复核时，优先用表格：
类型 | 用户原文摘录 | 判定 | 依据 | 权威依据 | 链接 | request_id | extract_reg_id
输出要求：
判定使用：准确 / 时效风险 / 语义不一致 / 时效风险 + 语义不一致 / 未命中。权威依据只来自think_tank_content或权威案情字段；无则写“无”。- 表格后补充本次
request_id；默认不主动展开chat_model。 - 错误响应只输出
error_code、message、request_id，不得臆测法规表格内容。
自检模式
当模型即将输出含法律引用的正式文本：
- 可用
think_tank_content替换或收紧表述。 - 对失效法规标注“已失效/已被修改”，并建议替换为现行依据。
- 删除或改写无法在权威库验证的案号。
- 禁止在无权威正文时编造法条全文，禁止把空权威案例当真实案例引用。