用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt;运行前请先检查来源。
npx skills add https://github.com/ThomasMoreAI/legal-skills-open --skill yuandian-law-search命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地?可下载 SkillsMP 当前能够提供的文件。
Use when retrieving arbitration institutional rules (ICC, LCIA, SCC, SIAC, HKIAC, VIAC, МКАС/МАК при ТПП України, UNCITRAL) — fetching current version, verifying redaction applicable to the date of arbitration agreement, constructing URLs for official rule texts
Use when choosing the Polish legal regime for letters, requests, applications, complaints, petitions, public-information requests, KPA filings, PPSA complaints, RODO access requests, registry extracts, court-file access, tax/ZUS/cudzoziemcy/USC procedures, or professional lawyer letters. Prevents mixing UDIP, KPA, PPSA, RODO, registry, special-procedure, and advocate/radca letter regimes.
Use when preparing applications for recognition and enforcement of foreign arbitral awards in Poland, applications for setting aside arbitral awards under KPC art. 1205–1211, or opposing such applications — mapping Article V of the 1958 New York Convention to art. 1214–1215 of the Polish KPC, identifying grounds for refusal, structuring public policy arguments
基于 SOC 职业分类
正在显示 SKILL.md
| name | yuandian-law-search |
| title | 元典法条与案例检索 |
| description | 元典法条与案例检索。本技能应在需要查询中国法律法规条文、检索相关案例、为法律分析提供数据支撑时使用。 |
| author | cat-xierluo |
| author_url | https://github.com/cat-xierluo/legal-skills/tree/main/skills/yuandian-law-search |
| license | MIT |
| version | 0.1.0 |
| execution_mode | open |
| jurisdiction | cn |
| practice | general |
| language | zh |
通过元典开放平台 API 检索中国法律法规条文和案例。每次 API 调用消耗 1-50 积分(视接口而定)。所有检索结果会自动归档到本地,方便后续回溯。
每次使用本技能前,必须先执行以下检测流程,确认 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-你的密钥
# YD_STRATEGY=balanced
─────────────
每次调用消耗 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
# 读取检索策略
STRATEGY=$(grep '^YD_STRATEGY=' scripts/.env 2>/dev/null | cut -d'=' -f2)
echo "当前策略:${STRATEGY:-balanced}"
默认使用 scripts/yd-run 执行检索,而不是直接调用底层 yd_search.py。 会以干净环境启动 Python:清除 Codex/代理相关环境变量,保留 、、语言环境、、,并继续读取 和 缓存。
yd-runHOMEPATHYD_API_KEYYD_STRATEGYscripts/.envarchive/scripts/yd-run search "正当防卫的限度" --sxx 现行有效
若遇到 nodename nor servname provided, or not known 或其他网络错误,先执行无积分消耗的网络检查:
scripts/yd-run --network-check
注意:yd-run 只能避免 Codex 进程环境变量、代理变量和 PATH 漂移造成的影响;如果 Codex 本身以网络沙箱启动,或系统代理/VPN 接管 DNS,子进程仍会受到系统级网络策略影响。终端 Codex 应使用 --sandbox danger-full-access --ask-for-approval never 启动。
本技能共 35 个接口,分为四层。选择规则:
search 语义检索keyword 关键词检索detail 精确获取case 关键词检索(默认普通案例)case-semantic 语义检索case-detailenterprise-search 定位,再用 enterprise-base/enterprise-summary 获取详情enterprise-list --type TYPEhall-detect核心接口(默认使用): search · keyword · detail · case · case-semantic
扩展接口(需确认): regulation · regulation-detail · case-detail · case --authority-only
附属接口(仅限明确要求): enterprise · enterprise-detail · enterprise-search · enterprise-base · enterprise-summary · enterprise-list
专项接口(仅限明确要求): hall-detect
读取 scripts/.env 中的 YD_STRATEGY 配置(默认 balanced)。三种策略决定了 AI 的接口使用、确认流程和补充检索行为。
用户的明确指令始终优先于策略默认行为。
每次 API 调用消耗 1-50 积分(视接口而定)。以下规则不受策略影响:
即当前"正确性优先"策略,不改变现有行为。
在 balanced 基础上进一步收紧,最大限度减少积分消耗。
不考虑积分消耗,最大化检索精度和覆盖面。
旧接口
enterprise和enterprise-detail的策略行为不变,沿用上方"附属接口"的通用规则。
新增接口(hall-detect、enterprise-search、enterprise-base、enterprise-summary、enterprise-list)在三种策略下的具体行为:
| 接口 | 积分 | balanced | economical | aggressive |
|---|---|---|---|---|
| hall-detect | 50 | 用户明确要求时才使用,需确认"检测需要 50 积分" | 二次确认(第一次仅展示积分提醒,等用户再次确认才调用) | 可主动对用户引用的法条/案例做幻觉核验 |
| enterprise-search | 1 | 直接使用,无需确认 | 优先检查缓存,未命中时直接使用(仅 1 积分) | 直接使用 |
| enterprise-base / enterprise-summary | 10 | 用户明确要求时使用,告知积分消耗 | 需二次确认 | 直接使用 |
| enterprise-list | 5-10/次 | 用户指定类型时调用,提醒多种类型会累积积分 | 每次只查一种类型,展示全部可用类型让用户选择 | 企业尽调场景可一次性查询多个相关类型(如涉诉+行政处罚+失信) |
关键词检索默认是精确匹配,用户搜索"刑事案件管辖权"不会自动命中"知识产权管辖权"等相关概念。本节说明 AI 应如何主动扩展检索范围、分阶段提炼精准结果。
AI 在执行关键词检索前,应先分析用户查询是否涉及可扩展的法律概念:
当 AI 判断用户查询涉及可扩展概念时,按以下流程操作:
--search-mode or 扩大命中范围)关键词检索、案例检索和法规检索新增 --expand 参数,用于一次性传入多个扩展关键词:
# 法条关键词扩展检索
scripts/yd-run keyword "刑事案件 管辖权" --expand "知识产权管辖,级别管辖,专门管辖" --search-mode or
# 案例关键词扩展检索
scripts/yd-run case "买卖合同 瑕疵担保" --expand "质量纠纷,违约责任" --search-mode or
# 法规关键词扩展检索
scripts/yd-run regulation "民法典 合同" --expand "买卖合同,租赁合同" --search-mode or
--expand 参数的行为:
--search-mode or 模式进行检索--expand 时保持原有的精确匹配行为用户问:"关于刑事案件管辖权有哪些规定?"
第一阶段(广撒网):
scripts/yd-run keyword "刑事案件 管辖权 级别管辖 地域管辖 专门管辖" --search-mode or --sxx 现行有效
分析第一阶段结果:发现大量结果涉及"级别管辖"和"地域管辖"两个核心分支
第二阶段(精提炼):
scripts/yd-run keyword "级别管辖 中级法院" --search-mode and --sxx 现行有效
scripts/yd-run keyword "地域管辖 犯罪地" --search-mode and --sxx 现行有效
检索完成后,AI 应根据检索结果向用户建议相关的扩展方向。提示格式:
本次检索完成了对"刑事案件管辖权"的查询,消耗 XX 积分。
💡 相关的扩展检索方向:
1. 级别管辖 —— 中级/高级/最高法院的管辖分工
2. 地域管辖 —— 犯罪地、被告人居住地的管辖规则
3. 专门管辖 —— 军事法院、知识产权法院等专门管辖
如需深入了解某个方向,请告诉我。
关键词扩展行为与三种检索策略的关系:
| 策略 | 扩展行为 | 分阶段检索 | 积分控制 |
|---|---|---|---|
| balanced | AI 判断是否需要扩展,主动执行 | 可执行两阶段检索 | 第二阶段前告知用户将额外消耗积分 |
| economical | 不主动扩展,仅用户要求时执行 | 不执行,一次检索完成 | 仅扩展时提示积分消耗 |
| aggressive | 自动扩展所有相关概念,不等待确认 | 自动执行多阶段检索 | 不限制,追求最大覆盖面 |
AI 在完成检索后,应主动告知用户检索结果摘要和积分消耗,并根据场景推荐后续操作。
用户问:"正当防卫在什么情况下会超过必要限度?"
用户问:"有没有防卫过当的实际案例?"
用户问:"帮我找广西的买卖合同纠纷判决书"
策略提示:aggressive 模式下,AI 会自动对结果中最相关的 2-3 个案例调用 case-detail,无需等待用户指令。
用户问:"帮我查一下XX公司的背景信息"
策略差异:economical 下 enterprise-base/enterprise-summary 需二次确认;enterprise-list 每次只查一种类型。aggressive 下可一次性查询多个相关类型(如涉诉+行政处罚+失信)。
用户在对话中引用了某法条或案例,AI 希望核验准确性
用户问:"这家公司有没有什么风险?"
每个领域有语义检索和关键词检索两种模式。
| 语义检索 | 关键词检索 | |
|---|---|---|
| 子命令 | search(法条)/ case-semantic(案例) | keyword(法条)/ case(案例) |
| 输入 | 自然语言问题或描述 | 精确关键词组合 |
| 匹配 | 语义相似度,概念关联 | 字面匹配,AND/OR 逻辑 |
| 返回量 | 默认 45 条 | 默认 10 条 |
用语义检索:用户提出法律问题 / 描述场景 / 不确定关键词 / 需要广覆盖 → 不确定时默认用 用关键词检索:用户给出明确关键词 / 需要 AND/OR 逻辑 / 需按日期、效力级别、法院等精确筛选 / 语义检索结果不够聚焦
此外需区分检索法条还是案例:"XX的法律依据" → 法条检索;"有没有相关案例" → 案例检索;兼要法条和案例 → 先法条后案例,两次调用。
scripts/yd-run search "正当防卫的限度" --sxx 现行有效
scripts/yd-run keyword "人工智能 监管" \
--effect1 法律 --sxx 现行有效 \
--fbrq-start 2022-01-01 --fbrq-end 2026-03-01
scripts/yd-run detail "民法典" --ft-name "第十五条"
# 普通案例(默认)
scripts/yd-run case "买卖合同纠纷" --province 广西
# 权威案例(扩展,需确认)
scripts/yd-run case "买卖合同纠纷" --province 广西 --authority-only
scripts/yd-run case-semantic "正当防卫的限度" --jarq-start 2020-01-01
scripts/yd-run regulation "数据安全" --effect1 法律 --sxx 现行有效
scripts/yd-run regulation-detail --name "中华人民共和国数据安全法"
scripts/yd-run case-detail --type ptal --ah "(2025)桂09民终192号"
scripts/yd-run enterprise "华为" --num 5
scripts/yd-run enterprise-detail --credit-code "9144030071526726XG"
检测文本中引用的法规、法条、案例是否存在幻觉(是否真实存在、内容是否准确)。每次调用消耗 50 积分。
scripts/yd-run hall-detect "根据《中华人民共和国数据保护法》第35条规定,数据处理者应当..."
返回结果包含:
每次调用消耗 1 积分。按名称检索企业,返回候选列表(仅含 ID、名称、信用代码),用于定位目标企业后调用其他企业接口。
scripts/yd-run enterprise-search "华为" --top-k 5
根据企业 ID 或统一社会信用代码获取企业完整信息(含股东、核心成员、分支机构等)。
scripts/yd-run enterprise-base --uscc "9144030071526726XG"
一次调用获取企业各维度数据的统计摘要。
scripts/yd-run enterprise-summary --id "企业ID"
查询企业各维度详细记录,支持分页。每次调用消耗 5-10 积分(涉诉统计和涉诉文书 10 积分,其余 5 积分)。
# 查询企业涉诉文书
scripts/yd-run enterprise-list --type writ-list --uscc "9144030071526726XG"
# 查询企业对外投资
scripts/yd-run enterprise-list --type invest --uscc "9144030071526726XG" --page 1 --size 10
# 查询企业商标
scripts/yd-run enterprise-list --type brand --uscc "9144030071526726XG"
| TYPE | 名称 | 积分 |
|---|---|---|
| invest | 对外投资 | 5 |
| brand | 商标 | 5 |
| patent | 专利 | 5 |
| soft-right | 软件著作权 | 5 |
| works-right | 作品著作权 | 5 |
| icp | 网站备案 | 5 |
| change-info | 变更记录 | 5 |
| writ-agg | 涉诉信息统计 | 10 |
| writ-list | 涉诉文书 | 10 |
| court-session | 开庭公告 | 5 |
| court-notice | 法院公告 | 5 |
| execution | 失信被执行人 | 5 |
| executed-person | 被执行人 | 5 |
| frozen-equity | 股权冻结 | 5 |
| punishment | 行政处罚 | 5 |
| pledge | 股权出质 | 5 |
| guaranty | 对外担保 | 5 |
| abnormal | 经营异常 | 5 |
| tax | 欠税公告 | 5 |
| serious-illegal | 严重违法 | 5 |
| 参数 | 说明 | 可选值 |
|---|---|---|
--effect1 | 效力级别(可多次指定) | 宪法、法律、司法解释、行政法规、部门规章、地方性法规 等 |
--sxx | 时效性(可多次指定) | 现行有效、失效、已被修改、部分失效、尚未生效 |
| 参数 | 说明 |
|---|---|
--province / --xzqh-p | 省份筛选 |
--jarq-start / --jarq-end | 结案日期范围 |
--cj | 法院层级:最高/高级/中级/基层 |
--wenshu-type | 案件类型:刑事案件/民事案件/行政案件 |
references/MANIFEST.json 记录全部已适配接口的元数据(端点、子命令、分层、分类),以及平台接口排查历史。下次排查新增接口时,更新该文件的 check_history 即可。
每次 API 调用的完整结果会自动归档到 archive/ 目录。当用户提到"之前查过什么"时,AI 可以直接从归档中提取历史结果,无需重新调用 API。
浏览历史记录:
scripts/yd-run archive-list
scripts/yd-run archive-list --keyword "正当防卫"
如果用户说"之前查正当防卫的时候看到一个案例",AI 应先用 archive-list --keyword "正当防卫" 找到对应的归档文件,然后直接读取其中的 response 字段返回给用户。这不需要消耗积分。
scripts/yd-run raw /open/law_vector_search "正当防卫" --extra '{"fatiao_filter":{"sxx":["现行有效"]}}'
脚本每 7 天自动检测远程版本。也可手动检查:
# 检查是否有新版本(会显示最近提交记录)
scripts/yd-run check-update
# 执行更新(仅下载本 skill 目录下的文件,不影响其他目录)
scripts/yd-run do-update
do-update 仅更新 yuandian-law-search/ 目录下的文件,不会修改 .env(API Key)和 archive/(历史检索记录)。