将本地开发的 Skills 批量同步到 ClawHub 平台。支持智能 .gitignore 过滤、白名单控制、增量同步、单个 skill 同步。本技能应在用户需要将本地 skills 发布到 ClawHub、批量同步技能、检查发布状态时使用。
从已开发代码项目中提取技术实现证据，围绕候选专利方案生成算法/软件类说明书式技术交底书，并以“权利要求布局卡 → 发明专利初稿”两步法继续生成接近可申报版的中国发明专利起草材料。触发场景包括：读取代码仓库后撰写技术交底书、将人工总结的专利方案映射到具体实现、从代码中挖掘可专利技术方案、为专利代理师准备权利要求布局和发明专利初稿。
视频截图提取工具。从录屏视频（微信聊天录屏、会议录屏等）中自动抽取关键帧、去重并保存为图片文件，可用作法律证据。支持场景变化检测、关键帧提取、固定间隔、智能去重四种策略，配合内容区 dHash、像素差异、SSIM、滚动帧合并和 OCR 文本去重。触发词：视频截图、录屏截图、聊天记录截图、抽帧去重、视频截帧、视频关键帧提取。不要用于：视频压缩、视频剪辑、音频提取。
管理 Claude Code、Codex 和 OpenClaw Skills 的安装、版本追踪和更新检查。支持从本地路径或 GitHub 仓库安装，自动识别 .codex/.claude/.openclaw 目标目录，记录每个 Skill 的安装时间、来源 URL 和版本号，并检查 GitHub 更新。
本技能应在 GitHub 项目发布新版本时使用，覆盖版本号管理、CHANGELOG 同步、Release Notes 撰写、tag 创建、CI 构建监控、发布验证和历史清理全流程。适用于桌面应用、CLI 工具、Web 应用、库/SDK 等任何基于 GitHub 的软件项目。当用户提到"发布"、"release"、"打 tag"、"新版本"、"更新版本号"、"写 release notes"、"发布失败了"、"CI 挂了"时触发。不要用于非 GitHub 项目（如纯 GitLab / Gitea 项目）或无需 CI 的手动发布场景。
将案件/咨询材料整理成标准化目录结构。支持诉讼案件（12目录）和潜在项目/咨询（3目录）两种预设。本技能应在用户需要创建新案件、初始化案件目录结构、整理咨询材料、或通过参数和自然语言指定案件编号、委托人、案件类型等信息快速创建案件时使用。不要用于：单独生成法律文书、进行法律研究、证据分析等非案件初始化任务。
| name | yuandian-law-search |
| homepage | https://github.com/cat-xierluo/legal-skills |
| author | 杨卫薪律师（微信ywxlaw） |
| version | 1.3.4 |
| license | MIT |
| description | 元典法条与案例检索。本技能应在需要查询中国法律法规条文、检索相关案例、为法律分析提供数据支撑时使用。 |
通过元典开放平台 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。yd-run 会以干净环境启动 Python：清除 Codex/代理相关环境变量，保留 HOME、PATH、语言环境、YD_API_KEY、YD_STRATEGY，并继续读取 scripts/.env 和 archive/ 缓存。
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/（历史检索记录）。