| name | yd-law-search |
| version | 2.0.1 |
| user_invocable | true |
| description | 元典法律法规检索技能（开放平台版 https://open.chineselaw.com）。
用于中国法律、行政法规、司法解释、部门规章、地方性法规等规范性文件的检索。
适合：法条语义检索、法条关键词检索、法规级别检索、法条/法规详情查询。
不负责最终法律结论；如需基于检索结果做法律分析，应继续调用 cs-china-lawyer-analyst；
若是"做法律研究备忘录"类完整流程，应交由 legal-research 编排技能调度。
|
元典法条/法规检索技能（yd-law-search）
定位
检索型 skill，把规范依据稳定、结构化地检索出来。
- 它负责：查法条、查法规、查司法解释、查具体条文全文
- 它不负责：直接替代法律分析、出完整法律意见
- 与现有 skill 的关系：
yd-law-search：检索规范依据（本 skill）yd-case-search：检索案例与类案cs-china-lawyer-analyst：基于检索结果做法律分析legal-research：上层编排技能，按"查法规→查案例→出备忘录"调度上述三者
API Key 配置
脚本按以下顺序读取 API Key：
- 环境变量
YD_OPEN_API_KEY
~/.yd_open_api_key- 环境变量
YD_API_KEY
~/.yd_api_key- 脚本目录下
.api_key
申请入口：https://open.chineselaw.com/
工作流（重要）
- 默认搜索只返回元数据 + 高亮/要旨片段，不返回全文。
- 当需要某条法条或法规的全文时，使用
ft_detail / fg_detail 配合 id 拉取。
- 不要在搜索后立即对全部命中条目调用详情接口；先由模型/用户筛选 1-3 条最相关的，再单独拉详情。
--full 开关用于调试或用户明确要求全文展示时使用。
子命令决策树（严格遵守，不要自由发挥）
默认路由（用于 99% 的"查法律/查规定"提问）：
- 自然语言问题、想要规范依据原文 →
search（语义法条）
- 多关键词、术语精确、要做条件过滤 →
search_keyword（关键词法条）
- 已知法规名 + 条号 →
ft_detail（法条详情）
仅在出现以下显式信号时才走「法规级别」接口：
- 用户问"有哪些法规/规章/规定"、"列出相关法规"
- 用户问"某机关发过什么文件"、"做法规盘点"
- 用户已明确给出法规名要拉法规全文 →
fg_detail
明确禁止：
- 不要用
search_fg 来回答"某规则是什么"——那是 search / search_keyword 的活。
search_fg 只回法规清单（标题、发布部门、发布日期），不返回具体条文。
调用方式
echo '{"query":"民间借贷利率上限"}' | \
python3 ~/.claude/skills/yd-law-search/scripts/yd_law_search.py search --stdin
echo '{"keyword":"个人信息 处罚","search_mode":"AND","sxx":"现行有效"}' | \
python3 ~/.claude/skills/yd-law-search/scripts/yd_law_search.py search_keyword --stdin
echo '{"fgmc":"中华人民共和国刑法","ftnum":"第一百条"}' | \
python3 ~/.claude/skills/yd-law-search/scripts/yd_law_search.py ft_detail --stdin
echo '{"keyword":"行政处罚","sxx":"现行有效","top_k":8}' | \
python3 ~/.claude/skills/yd-law-search/scripts/yd_law_search.py search_fg --stdin
echo '{"fgmc":"中华人民共和国民法典"}' | \
python3 ~/.claude/skills/yd-law-search/scripts/yd_law_search.py fg_detail --stdin
echo '{"query":"民法典","ft_name":"第六百八十条"}' | \
python3 ~/.claude/skills/yd-law-search/scripts/yd_law_search.py search_ft_info --stdin
通用 flag：
--stdin：从 stdin 读 JSON--full：打印全文（默认只打 ≤120 字摘要）--raw：直接打印 API 原始 JSON
使用规则
- 默认
top_k = 8；用户明确要更多时再调大。
- 时效性默认
现行有效；查历史版本用 refer_date（仅 ft_detail / fg_detail 支持）。
- 展示结果时至少保留：法规名、条号、时效性、内容片段、链接、id（便于下钻详情）。
- 引用法条原文时不擅自改写。
- 若需要论证法条如何适用，转入
cs-china-lawyer-analyst。
输出建议
- 最相关法条 / 法规清单（≤8 条）
- 关键条文摘要 + id
- 链接
- 提示是否需要拉全文（ft_detail/fg_detail）或继续案例检索
