pkulaw-mcp-semantic-nlsql

name	pkulaw-mcp-semantic-nlsql
description	使用 `semantic-nlsql` 做跨库语义检索与综合法律资料召回。Use when：用户问题同时跨法规、案例、法条或多类材料，希望先用一次自然语言检索拿到综合候选结果。NOT for：只查单一法规、只查单一案例、已知法规名加条号的精准查询，以及未完成 `serverPaths.semantic-nlsql` 配置的环境。必须先确认实例路径可用；未配置时只能提示配置与替代方案，不得伪造结果。
license	MIT
metadata	{"pkulaw":{"protocol":"MCP","service_source":"北大法宝原生 MCP 服务","cli_debug_entry":"@pkulaw/mcp-cli","product_lines":["法宝语义检索（NL-SQL）"],"server_ids":["semantic-nlsql"],"mcp_cli":"@pkulaw/mcp-cli"}}
version	1.1.0

北大法宝 MCP：语义检索（semantic-nlsql）

这个 Skill 只负责一件事：用一次自然语言检索，先把跨库候选材料召回出来。

它适合做“综合探索入口”，不适合直接替代法规检索、案例检索、精准法条回源或引用核验。你应该把它理解为第一跳，不是最后一跳。

使用前必须检查

1. 已配置 serverPaths.semantic-nlsql
2. pkulaw-mcp tools semantic-nlsql 能正常返回
3. 对应服务已订阅、Token 可用

如果上面任何一点不成立，必须停止继续使用本 Skill，并提示用户先配置或改走其他 Skill。

先看边界

• 本 Skill 的长处是综合召回，不是最终结论生成器。
• 召回结果必须继续做分流、核验、收窄，不得直接包装成确定法律意见。
• 如果问题本来就只是查法规或只是查案例，优先用更窄的 Skill，而不是为了“高级”强行走 NL-SQL。

默认路由

符合下面条件时才优先用 semantic-nlsql：

• 问题同时跨法规、案例、法条或多类材料
• 用户表述较长，且暂时无法明确拆成单一路径
• 你希望先拿到一批综合候选，再分流继续查

不符合时，直接改走：

• 法规问题 -> pkulaw-mcp-law-retrieval
• 案例问题 -> pkulaw-mcp-case-retrieval

推荐工作流

1. 先确认配置与工具可用。
2. 用自然语言完整表达问题，不要先压缩成过短关键词。
3. 完成一次综合检索。
4. 按返回内容分成法规、案例、法条或其他候选。
5. 明确告诉用户：这是“综合召回结果”，不是最终定论。
6. 必要时把候选继续转交给更窄的 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 等工具名

输出结构

按下面结构输出最稳：

1. 问题重述
2. 前置检查结果
3. 综合召回摘要
4. 建议的下一步分流
5. 局限说明

补充材料

• 示例见 examples.md
• 法规检索见 pkulaw-mcp-law-retrieval
• 案例检索见 pkulaw-mcp-case-retrieval