npx claudepluginhub cat-xierluo/legal-skills --plugin minimax-image-understandThis skill uses the workspace's default tool permissions.
通过元典开放平台 API 检索中国法律法规条文和案例。**每次 API 调用消耗 10 积分**。所有检索结果会自动归档到本地,方便后续回溯。
CHANGELOG.mdLICENSE.txtREADME.mdreferences/01-law-vector-search.mdreferences/02-law-keyword-search.mdreferences/03-law-detail.mdreferences/04-case-semantic-search.mdreferences/05-case-keyword-search.mdreferences/06-case-keyword-search-authority.mdreferences/07-case-detail.mdreferences/08-regulation-search.mdreferences/09-regulation-detail.mdreferences/10-enterprise-search.mdreferences/11-enterprise-detail.mdscripts/MANIFEST.jsonscripts/updater.pyscripts/yd_search.py连接智合AI法律大模型平台进行法律研究。本技能应在用户需要进行法律问题研究、查找法律法规、检索类似案例、或获取法律研究报告时使用。需要智合AI平台会员账号。
Conducts legal research, risk analysis, and case law review using GoodLegal MCP tools for French/EU law, contracts, and regulations. Performs adversarial searches, doctrinal reviews, and temporal checks.
Conducts UK legal research via Lex API: searches Acts, sections, amendments, explanatory notes for legislation and statutory queries.
Share bugs, ideas, or general feedback.
通过元典开放平台 API 检索中国法律法规条文和案例。每次 API 调用消耗 10 积分。所有检索结果会自动归档到本地,方便后续回溯。
每次使用本技能前,必须先执行以下检测流程,确认 API Key 已就绪:
.env 文件:检查 scripts/.env 是否存在YD_API_KEY 的值,确认非空且不是占位符 your-api-key-here⚠️ 元典 API Key 未配置。请按以下步骤获取并配置:
1. 注册/登录:访问 https://open.chineselaw.com ,使用手机号注册
2. 创建 API Key:登录后在个人中心创建 Key
3. 配置密钥:将 Key 填入以下文件
scripts/.env
─────────────
YD_API_KEY=sk-你的密钥
─────────────
每次调用消耗 10 积分,需在平台充值。
配置完成后重新发起检索即可。
# 检测 .env 文件和 API Key
if [ -f "scripts/.env" ]; then
KEY=$(grep '^YD_API_KEY=' scripts/.env | cut -d'=' -f2)
if [ -n "$KEY" ] && [ "$KEY" != "your-api-key-here" ]; then
echo "API Key 已就绪"
else
echo "API Key 未配置"
fi
else
echo ".env 文件不存在"
fi
本技能共 11 个接口,分为三层。选择规则:
search 语义检索keyword 关键词检索detail 精确获取case 关键词检索(默认普通案例)case-semantic 语义检索case-detail核心接口(默认使用): search · keyword · detail · case · case-semantic
扩展接口(需确认): regulation · regulation-detail · case-detail · case --authority-only
附属接口(仅限明确要求): enterprise · enterprise-detail
每次 API 调用消耗 10 积分,应避免浪费。但正确性始终优先于积分节约——AI 的记忆可能存在幻觉或过时,涉及法律条文的精确引用时宁可多查一次。
每个接口每次调用均为 10 积分,但不同场景的实际消耗差异很大:
法条检索通常一次调用即可满足需求(语义检索结果已含法条全文,无需再调 detail)。
案例检索是两阶段消耗,需特别注意:
case / case-semantic 返回案例摘要列表 → 10 积分case-detail → 再消耗 10 积分因此,如果检索到 5 个案例并逐一查看详情,总消耗为 10 + 5×10 = 60 积分。AI 代理在调用 case-detail 前应告知用户将额外消耗积分并确认。
search 返回结果最全面,一次通常即可覆盖需求search 再逐条 detail——语义检索已含法条全文case-detail,不要对全部结果逐一查看--sxx 现行有效、--effect1 法律、--province 等缩小范围archive/,用户提到"之前查过什么"时可直接从归档中提取,无需重新消耗积分AI 在完成检索后,应主动告知用户检索结果摘要和积分消耗,并根据场景推荐后续操作。
用户问:"正当防卫在什么情况下会超过必要限度?"
用户问:"有没有防卫过当的实际案例?"
用户问:"帮我找广西的买卖合同纠纷判决书"
每个领域有语义检索和关键词检索两种模式。
| 语义检索 | 关键词检索 | |
|---|---|---|
| 子命令 | search(法条)/ case-semantic(案例) | keyword(法条)/ case(案例) |
| 输入 | 自然语言问题或描述 | 精确关键词组合 |
| 匹配 | 语义相似度,概念关联 | 字面匹配,AND/OR 逻辑 |
| 返回量 | 默认 45 条 | 默认 10 条 |
用语义检索:用户提出法律问题 / 描述场景 / 不确定关键词 / 需要广覆盖 → 不确定时默认用 用关键词检索:用户给出明确关键词 / 需要 AND/OR 逻辑 / 需按日期、效力级别、法院等精确筛选 / 语义检索结果不够聚焦
此外需区分检索法条还是案例:"XX的法律依据" → 法条检索;"有没有相关案例" → 案例检索;兼要法条和案例 → 先法条后案例,两次调用。
python3 scripts/yd_search.py search "正当防卫的限度" --sxx 现行有效
python3 scripts/yd_search.py keyword "人工智能 监管" \
--effect1 法律 --sxx 现行有效 \
--fbrq-start 2022-01-01 --fbrq-end 2026-03-01
python3 scripts/yd_search.py detail "民法典" --ft-name "第十五条"
# 普通案例(默认)
python3 scripts/yd_search.py case "买卖合同纠纷" --province 广西
# 权威案例(扩展,需确认)
python3 scripts/yd_search.py case "买卖合同纠纷" --province 广西 --authority-only
python3 scripts/yd_search.py case-semantic "正当防卫的限度" --jarq-start 2020-01-01
python3 scripts/yd_search.py regulation "数据安全" --effect1 法律 --sxx 现行有效
python3 scripts/yd_search.py regulation-detail --name "中华人民共和国数据安全法"
python3 scripts/yd_search.py case-detail --type ptal --ah "(2025)桂09民终192号"
python3 scripts/yd_search.py enterprise "华为" --num 5
python3 scripts/yd_search.py enterprise-detail --credit-code "9144030071526726XG"
| 参数 | 说明 | 可选值 |
|---|---|---|
--effect1 | 效力级别(可多次指定) | 宪法、法律、司法解释、行政法规、部门规章、地方性法规 等 |
--sxx | 时效性(可多次指定) | 现行有效、失效、已被修改、部分失效、尚未生效 |
| 参数 | 说明 |
|---|---|
--province / --xzqh-p | 省份筛选 |
--jarq-start / --jarq-end | 结案日期范围 |
--cj | 法院层级:最高/高级/中级/基层 |
--wenshu-type | 案件类型:刑事案件/民事案件/行政案件 |
| # | 文件 | 接口 |
|---|---|---|
| 01 | law-vector-search.md | 法条语义检索 |
| 02 | law-keyword-search.md | 法条关键词检索 |
| 03 | law-detail.md | 法条详情 |
| 04 | case-semantic-search.md | 案例语义检索 |
| 05 | case-keyword-search.md | 普通案例关键词检索 |
| 06 | case-keyword-search-authority.md | 权威案例关键词检索 |
| 07 | case-detail.md | 案例详情 |
| 08 | regulation-search.md | 法规关键词检索 |
| 09 | regulation-detail.md | 法规详情 |
| 10 | enterprise-search.md | 企业名称检索 |
| 11 | enterprise-detail.md | 企业详情 |
每次 API 调用的完整结果会自动归档到 archive/ 目录。当用户提到"之前查过什么"时,AI 可以直接从归档中提取历史结果,无需重新调用 API。
浏览历史记录:
python3 scripts/yd_search.py archive-list
python3 scripts/yd_search.py archive-list --keyword "正当防卫"
如果用户说"之前查正当防卫的时候看到一个案例",AI 应先用 archive-list --keyword "正当防卫" 找到对应的归档文件,然后直接读取其中的 response 字段返回给用户。这不需要消耗积分。
python3 scripts/yd_search.py raw /open/law_vector_search "正当防卫" --extra '{"fatiao_filter":{"sxx":["现行有效"]}}'
脚本每 7 天自动检测远程版本。也可手动检查:
# 检查是否有新版本(会显示最近提交记录)
python3 scripts/yd_search.py check-update
# 执行更新(仅下载本 skill 目录下的文件,不影响其他目录)
python3 scripts/yd_search.py do-update
do-update 仅更新 yuandian-law-search/ 目录下的文件,不会修改 .env(API Key)和 archive/(历史检索记录)。