常见问题

Skill 安装

如何安装 SolveX Skill？

将 Agent 安装提示复制并发送给你的 AI Agent（如 Claude Code、Cursor 等），Agent 会自动执行安装命令并完成配置。

也可以手动运行安装命令：

npx skills add solvex-top/solvex-skills@traffic-standards-kb -g -y

安装命令报错 "npx not found" 怎么办？

该错误表示系统中未安装 Node.js 或 npm。请先安装 Node.js（推荐 18.x 或更高版本）：

• macOS：brew install node
• Ubuntu/Debian：sudo apt install nodejs npm
• Windows：从 nodejs.org 下载安装包

安装完成后重新打开终端，再次运行安装命令。

如何更新已安装的 Skill？

重新运行安装命令即可覆盖更新到最新版本：

npx skills add solvex-top/solvex-skills@traffic-standards-kb -g -y

如何卸载 Skill？

npx skills remove solvex-top/solvex-skills@traffic-standards-kb -g

API Key 配置

API Key 从哪里获取？

1. 访问 SolveX 开放平台 注册账号
2. 登录后进入「API Key」页面
3. 创建新的 API Key 并复制

详见 API Key 管理。

API Key 配置在哪里？

API Key 需要配置在 Claude Code 的 ~/.claude/settings.json 文件的 env 字段中：

{
  "env": {
    "STANDARDS_API_KEY": "你的API Key"
  }
}

也可以导出为 shell 环境变量：

export STANDARDS_API_KEY="你的API Key"

如何验证 API Key 是否有效？

在终端中运行以下命令测试：

curl -X POST https://solvexpert.net/api/v1/standards/query \
  -H "Authorization: Bearer 你的API Key" \
  -H "Content-Type: application/json" \
  -d '{"query": "信号灯设置规范", "limit": 1}'

返回正常结果即表示 API Key 有效。也可以直接让 Agent 用 Skill 查询一个简单问题来验证。

环境变量

STANDARDS_API_KEY 未配置会怎样？

Agent 在调用 Skill 时会收到 API 认证失败的错误提示。Skill 本身可以安装成功，但无法查询交通标准数据。需要先配置 STANDARDS_API_KEY 才能正常使用。

如何确认环境变量已生效？

在终端中运行：

echo $STANDARDS_API_KEY

如果输出你的 API Key 则已生效。Claude Code 用户可以让 Agent 检查 ~/.claude/settings.json 中的 env 字段。

使用问题

如何判断 Skill 是否安装成功？

让 Agent 用 Skill 查询一个交通标准问题（如「查询信号灯设置规范」），如果返回带标准编号和引用内容的格式化结果，则安装成功。

也可以检查 ~/.claude/skills/ 目录下是否存在对应的 Skill 文件。

Skill 调用返回空结果怎么办？

• 检查查询关键词是否与交通标准领域相关（信号控制、智能停车、V2X、ETC 等）
• 尝试更具体的关键词，如「GB 14886 信号灯」
• 确认 API Key 配额是否充足，详见 套餐方案
• 如果问题持续，可能是后端服务暂时不可用，请稍后重试

一个 Agent 可以安装多个 Skill 吗？

可以。每个 Skill 使用不同的安装命令独立安装，互不冲突。SolveX 后续将推出更多 Skill，可按需安装。