zuoguyoupan2023 北大法宝 MCP：语义检索（semantic-nlsql）
这个 Skill 只负责一件事：用一次自然语言检索，先把跨库候选材料召回出来。
它适合做“综合探索入口”，不适合直接替代法规检索、案例检索、精准法条回源或引用核验。你应该把它理解为第一跳，不是最后一跳。
使用前必须检查
- 已配置
serverPaths.semantic-nlsql pkulaw-mcp tools semantic-nlsql能正常返回- 对应服务已订阅、Token 可用
如果上面任何一点不成立，必须停止继续使用本 Skill，并提示用户先配置或改走其他 Skill。
先看边界
- 本 Skill 的长处是综合召回，不是最终结论生成器。
- 召回结果必须继续做分流、核验、收窄，不得直接包装成确定法律意见。
- 如果问题本来就只是查法规或只是查案例，优先用更窄的 Skill，而不是为了“高级”强行走 NL-SQL。
默认路由
符合下面条件时才优先用 semantic-nlsql：
- 问题同时跨法规、案例、法条或多类材料
- 用户表述较长，且暂时无法明确拆成单一路径
- 你希望先拿到一批综合候选，再分流继续查
不符合时，直接改走：
- 法规问题 -> pkulaw-mcp-law-retrieval
- 案例问题 -> pkulaw-mcp-case-retrieval
推荐工作流
- 先确认配置与工具可用。
- 用自然语言完整表达问题，不要先压缩成过短关键词。
- 完成一次综合检索。
- 按返回内容分成法规、案例、法条或其他候选。
- 明确告诉用户：这是“综合召回结果”，不是最终定论。
- 必要时把候选继续转交给更窄的 Skill 做二次检索。
失败与降级
配置缺失
只允许输出类似下面的结构：
当前无法使用 `semantic-nlsql`，因为实例路径尚未完成配置。
建议动作：
- 先配置 `serverPaths.semantic-nlsql`
- 执行 `pkulaw-mcp tools semantic-nlsql` 验证
- 如暂不配置，可改用法规语义检索与案例语义检索分别完成
401/403 或无结果
当前未拿到 semantic-nlsql 的有效检索结果。
失败原因：
- [未认证 / 无订阅 / 无结果 / 命令报错]
建议动作：
- 检查 Token 与订阅状态
- 调整自然语言问题表述
- 改走法规或案例的窄路径检索
终端复现与排障
如需在终端复现，请先安装 @pkulaw/mcp-cli；安装后命令为 pkulaw-mcp。
pkulaw-mcp tools semantic-nlsql
pkulaw-mcp semantic-nlsql <toolName> --json
说明：
<toolName>必须以tools输出为准- 不要在文档中写死
ai_pkulaw_search等工具名
输出结构
按下面结构输出最稳：
- 问题重述
- 前置检查结果
- 综合召回摘要
- 建议的下一步分流
- 局限说明
补充材料
- 示例见 examples.md
- 法规检索见 pkulaw-mcp-law-retrieval
- 案例检索见 pkulaw-mcp-case-retrieval