legal-hybrid-skill

name	legal-hybrid-skill
description	合法合规类案与法条查询，优先API，失败自动降级本地库

技能名称

智能法律助手

技能版本

v2.1

技能描述

优先调用国家法律法规数据库官方API（无密钥、稳定可用）查询法律条文，当API请求失败、超时或无查询结果时，自动切换至本地法条库和案例库进行兜底查询，可快速响应各类常见法律问题，提供精准的法条参考和案例支撑，适配QClaw技能平台，无需复杂配置即可使用。

核心功能

• API优先查询：调用国家法律法规数据库官方接口（https://flk.npc.gov.cn/api/），获取权威、最新的法律条文，支持关键词模糊匹配。

• 本地兜底保障：API不可用时，自动启用本地预置的法条库（law_db.json）和案例库（case_db.json），确保技能始终可正常响应。

• 多维度案例匹配：适配自定义案例库结构，支持通过标题、关键词、案情、判决结果多维度匹配参考案例，提升查询精准度。

• 格式化输出：查询结果按“法律条文+参考案例”分类展示，结构清晰、可读性强，便于快速获取关键信息。

依赖文件

技能运行需确保同一目录下包含以下4个文件，缺一不可：

1. main.py：技能主程序，实现API调用、本地数据加载、查询匹配及结果输出核心逻辑。

2. law_db.json：本地法条兜底库，包含常用法律条文（如民法典、劳动合同法、消保法等），支持离线查询。

3. case_db.json：本地案例兜底库，包含各类常见法律纠纷案例（劳动争议、借贷纠纷、侵权纠纷等），适配关键词多维度匹配。

4. info.json：QClaw技能配置文件，用于技能识别、显示及启动配置。

使用方法

1. 技能导入

2. 将上述4个文件放入同一文件夹，压缩为ZIP压缩包。

3. 打开QClaw平台，进入“技能管理”页面，点击“导入技能”，选择压缩包完成导入。

4. 导入成功后，技能将自动生效，无需额外配置。

5. 查询操作

在QClaw技能调用界面，输入法律问题关键词即可查询，示例关键词：

• 劳动类：试用期辞退、未签劳动合同、拖欠工资、工伤

• 借贷类：借钱不还、高利贷、砍头息、无借条借款

• 侵权类：高空抛物、肖像权侵权、噪音扰民、宠物伤人

• 合同类：定金不退、违约金过高、格式条款无效

• 其他：租房押金、食品过期索赔、快递丢失、未成年人充值退款

3. 结果说明

查询结果分为两部分，优先展示API查询到的官方法条，无API结果时展示本地法条；案例部分始终展示本地匹配到的参考案例：

• 📜 法律条文：展示法条名称及完整内容，优先显示官方API查询结果，其次显示本地兜底法条。

• ⚖️ 参考案例：展示案例标题、案情描述、判决结果及依据法条，按匹配度排序。

API配置说明

技能默认使用国家法律法规数据库官方API，无需密钥，配置信息如下：

• API地址：https://flk.npc.gov.cn/api/

• 请求方式：GET

• 核心参数：

  • type: flfg（固定值，代表法律法规查询）

  • searchType: title;vague（模糊匹配标题）

  • keyword: 用户输入的查询关键词

  • page: 1（默认查询第一页）

  • size: 5（默认返回5条结果）

• 响应说明：API返回状态码200且包含有效数据时，解析并展示法条；否则自动切换本地兜底。

本地数据维护

1. 法条库（law_db.json）

格式为JSON键值对，key为法条名称（如“民法典183”），value为法条完整内容，可手动添加、修改或删除条目，示例：

{ "民法典183": "因保护他人民事权益使自己受到损害的，由侵权人承担民事责任，受益人可以给予适当补偿。没有侵权人、侵权人逃逸或者无力承担民事责任，受害人请求补偿的，受益人应当给予适当补偿。", "劳动合同法82": "用人单位自用工之日起超过一个月不满一年未与劳动者订立书面劳动合同的，应当向劳动者每月支付二倍的工资。" }

2. 案例库（case_db.json）

格式为JSON数组，每个数组元素为一个案例对象，包含title（案例标题）、keywords（关键词数组）、fact（案情）、judgement（判决结果）、laws（依据法条数组），示例：

[ { "title": "试用期无故辞退", "keywords": ["试用期","辞退","补偿","解除","无故"], "fact": "员工试用期6个月，入职3个月被无理由辞退，公司未提供考核不合格证据", "judgement": "公司违法解除劳动合同，应支付赔偿金", "laws": ["劳动合同法19","劳动合同法39","劳动合同法87"] } ]

可根据需求添加新案例，确保字段完整，关键词准确，提升匹配精度。

常见问题

1. Q：API查询无结果？ A：可能是关键词过于模糊或无对应官方法条，技能会自动切换本地兜底库查询，建议更换更具体的关键词（如“未签劳动合同”而非“劳动合同”）。

2. Q：技能无法启动？ A：检查是否缺少依赖文件（4个核心文件缺一不可），或压缩包格式错误，重新打包所有文件后再次导入。

3. Q：案例匹配不准确？ A：可修改case_db.json中的keywords字段，添加更贴合实际查询场景的关键词，提升匹配度。

4. Q：API请求超时？ A：技能默认超时时间为8秒，若网络环境较差，可修改main.py中self.timeout参数（单位：秒）。