SkillPkg Logo
SKILL.md
---
name: law-search
description: |
  中国法律法规检索技能，基于元典法条检索API（yd_law_search）。当用户提到任何与中国法律、法规、法条、司法解释、行政法规相关的查询时，必须使用此技能。包括但不限于：查找某个法律问题对应的法条、检索特定法规的具体条款、用关键词搜索法律条文、了解某法律的具体规定、查看法条全文及元数据。即使用户没有明确说"查法条"或"检索法律"，只要问题涉及中国法律法规的具体规定，都应触发此技能。
---

法律法规检索技能（law-search）

通过元典法条检索API查找中国法律法规条文。收到用户法律问题后，立即选择合适的接口并调用脚本，不要做多余的前置步骤。

API Key 配置

API Key 由脚本自动从以下位置读取（按优先级）：环境变量 YD_API_KEY、~/.yd_api_key、脚本同目录 .api_key。

如果调用脚本时输出"未检测到 API Key"，则引导用户：

  1. 访问 https://passport.legalmind.cn/apiKey/manage 注册获取免费 API Key（限时免费 1000 次）
  2. 配置方式（任选其一）：
    • export YD_API_KEY="sk-密钥" （推荐）
    • echo "sk-密钥" > ~/.yd_api_key
    • echo "sk-密钥" > /path/to/law-search/scripts/.api_key
  3. 如果用户直接提供了 key（如"我的 key 是 sk-xxx"），直接帮用户写入配置文件后继续检索

三个检索接口

1. 语义检索（/search）— 默认首选

用自然语言描述法律问题，语义匹配最相关法条。用户描述场景或问题时用这个。

参数：query（必填）、effect1（效力级别）、sxx（时效性）

2. 关键词检索（/search_keyword）

精确关键词匹配。用户给出明确法律术语时用这个。

参数：query（必填，空格分隔关键词）、effect1、sxx、search_mode（"and"默认/"or"）、fbrq_start/fbrq_end（发布日期，yyyy-MM-dd）、ssrq_start/ssrq_end（生效日期，yyyy-MM-dd）

3. 法条详情（/search_ft_info）

按法规名称+条号查具体法条。用户指定了具体法规和条号时用这个。

参数：query（必填，法规名称）、ft_name（必填，如"第十五条"）、reference_date（可选，yyyy-MM-dd，查历史时点版本）

筛选参数可选值

effect1（效力级别）： 宪法、法律、司法解释、行政法规、监察法规、部门规章、党内法规、军事法规规章、立法机关工作文件、行政机关工作文件、行业/团体规范、地方性法规、自治条例和单行条例、地方司法文件、地方政府规章、地方规范性文件、地方律协规定

sxx（时效性）： 现行有效、失效、已被修改、部分失效、尚未生效

调用方式

收到问题后立即调用，不需要预检 API Key。优先用 Python 脚本，如果环境无 Python 则用 curl 直接调用。

方式一：Python 脚本（推荐）

使用 --stdin 模式（跨平台兼容）：

echo '{"query": "正当防卫", "sxx": ["现行有效"]}' | python /path/to/law-search/scripts/law_search.py search --stdin
echo '{"query": "人工智能 监管", "search_mode": "and", "fbrq_start": "2023-01-01"}' | python /path/to/law-search/scripts/law_search.py search_keyword --stdin
echo '{"query": "民法典", "ft_name": "第十五条"}' | python /path/to/law-search/scripts/law_search.py search_ft_info --stdin

API Key 由脚本自动读取，缺失时脚本会输出引导信息。

方式二：curl 直连（无需 Python）

如果环境中没有 Python，直接用 curl 调用 API。API Key 按此顺序读取：$YD_API_KEY → ~/.yd_api_key → 脚本同目录 .api_key。

# 读取 API Key（按优先级）
API_KEY="${YD_API_KEY:-$(cat ~/.yd_api_key 2>/dev/null || cat /path/to/law-search/scripts/.api_key 2>/dev/null)}"

# 语义检索
curl -s -X POST "http://aiapi.ailaw.cn:8319/search?api_key=$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "正当防卫", "sxx": ["现行有效"]}'

# 关键词检索
curl -s -X POST "http://aiapi.ailaw.cn:8319/search_keyword?api_key=$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "人工智能 监管", "search_mode": "and"}'

# 法条详情
curl -s -X POST "http://aiapi.ailaw.cn:8319/search_ft_info?api_key=$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "民法典", "ft_name": "第十五条"}'

curl 返回原始 JSON，由 Claude 自行解析和格式化展示。

通用规则

默认添加 "sxx": ["现行有效"]，除非用户明确要求查历史法规。根据上下文合理设置 effect1。如果用户提到时间范围，使用日期筛选参数。

结果展示

将脚本输出整理为用户友好的格式，每条法条必须包含：

  • 法规名称和条号
  • 法条全文（保持原文准确）
  • 时效性状态
  • 法规链接（https://ydzk.chineselaw.com/...）— 每条都要附上

对法条做简要通俗解读，说明多条法条之间的关系。

注意事项

  • 法律检索结果仅供参考，提醒用户具体问题应咨询专业律师
  • 已失效法条需特别标注
  • 展示法条时保持原文准确性，不要修改法条内容