---
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-law-retrieval/SKILL.md)
- 案例问题 -> [pkulaw-mcp-case-retrieval](../pkulaw-mcp-case-retrieval/SKILL.md)

## 推荐工作流

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

## 失败与降级

### 配置缺失

只允许输出类似下面的结构：

```markdown
当前无法使用 `semantic-nlsql`，因为实例路径尚未完成配置。

建议动作：
- 先配置 `serverPaths.semantic-nlsql`
- 执行 `pkulaw-mcp tools semantic-nlsql` 验证
- 如暂不配置，可改用法规语义检索与案例语义检索分别完成
```

### 401/403 或无结果

```markdown
当前未拿到 semantic-nlsql 的有效检索结果。

失败原因：
- [未认证 / 无订阅 / 无结果 / 命令报错]

建议动作：
- 检查 Token 与订阅状态
- 调整自然语言问题表述
- 改走法规或案例的窄路径检索
```

## 终端复现与排障

如需在终端复现，请先安装 `@pkulaw/mcp-cli`；安装后命令为 `pkulaw-mcp`。

```bash
pkulaw-mcp tools semantic-nlsql
pkulaw-mcp semantic-nlsql <toolName> --json
```

说明：

- `<toolName>` 必须以 `tools` 输出为准
- 不要在文档中写死 `ai_pkulaw_search` 等工具名

## 输出结构

按下面结构输出最稳：

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

## 补充材料

- 示例见 [examples.md](examples.md)
- 法规检索见 [pkulaw-mcp-law-retrieval](../pkulaw-mcp-law-retrieval/SKILL.md)
- 案例检索见 [pkulaw-mcp-case-retrieval](../pkulaw-mcp-case-retrieval/SKILL.md)