Traffic Standards Knowledge Base
Overview
Retrieve Chinese transportation standards (GB, JT, GA) via Solvex API. Detects domain → queries API → formats citations.
Installation
# Install globally (available in all projects)
npx skills add solvex-top/solvex-skills@traffic-standards-kb -g -y
# Install to current project only
npx skills add solvex-top/solvex-skills@traffic-standards-kb -y
# Update to latest version
npx skills update traffic-standards-kb
# Remove
npx skills remove traffic-standards-kb
Prerequisites
API Key: Get from https://solvexpert.net
# Option 1: Export in shell (for bash commands)
export STANDARDS_API_KEY="solvex-your-api-key"
# Option 2: Add to ~/.claude/settings.json (for Claude internal use)
{
"env": {
"STANDARDS_API_KEY": "solvex-your-api-key"
}
}
⚠️ CRITICAL: Environment variables in settings.json are NOT automatically available to bash commands. For API calls via bash, you must:
1. Export the variable in your shell, OR
2. Pass the key explicitly in the command
Quick Reference
| Domain | Keywords | Standards |
|---|---|---|
| Signal Control | 智慧路口, 交通信号, 自适应信号 | GB series, GB series |
| Parking | 智能停车, 停车诱导, 路侧停车 | GB/T series, JT/T series |
| Monitoring | 电子警察, 违章抓拍, 车牌识别 | GA/T series, GB/T series |
| Data Collection | 交通检测, 流量检测, 地磁, 雷达 | JT/T series, GB/T series |
| Tolling | ETC, 电子收费 | JT/T series, JTG series |
| Smart Highway | 智慧高速, 高速监控 | JT/T series, JT/T series |
| Service Area | 智慧服务区, 服务区设施 | JTJ series, JT/T series |
| Public Transit | 智慧公交, BRT, 公交优先 | JT/T series |
| V2X | V2X, V2V, V2I, C-V2X | GB/T series, YD/T series |
| MaaS | MaaS, 出行即服务 | JT/T series |
| Emerging | 新兴领域, 智能交通 | GB/T, JT/T, GA/T series |
Usage
Minimum Working Request
curl -s -X POST "https://solvexpert.net/api/v1/standards/query" \
-H "Content-Type: application/json" \
-H "X-API-Key: $STANDARDS_API_KEY" \
-d '{
"question": "智慧高速及智慧服务区相关的标准",
"domains": ["新兴领域"],
"depth": "medium",
"searchId": "4d68cee6226611f19327c66d7f7cba76",
"searchAuthToken": "Thn5ItDQS9aEa3cay-855l2woSmW2Z4U"
}' | python3 -m json.tool
Required Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
question |
string | ✅ | Natural language query |
domains |
string[] | ❌ | Domain filter (auto-detected if omitted) |
depth |
string | ❌ | basic/medium/full (default: medium) |
searchAuthToken |
string | ✅ | REQUIRED: Thn5ItDQS9aEa3cay-855l2woSmW2Z4U |
searchId |
string | ❌ | Recommended: 4d68cee6226611f19327c66d7f7cba76 |
Valid Domain Values
- 信号控制
- 停车系统
- 交通监控
- 数据采集
- 收费系统
- 公共交通
- 车路协同
- 出行服务
- 交通管理
- 新兴领域
Response Format
{
"code": 0,
"message": "Success",
"data": {
"standards": [
{
"standardNumber": "GB 14886-2016",
"title": "道路交通信号灯设置与安装规范",
"similarity": 0.92,
"content": "..."
}
],
"total": 10
}
}
Citation Format:
[1] GB 14886-2016 道路交通信号灯设置与安装规范
[2] GA/T 1400-2017 公安视频监控联网系统
See api-reference.md for full API docs.
Common Mistakes
| Mistake | Consequence | Fix |
|---|---|---|
Missing searchAuthToken |
❌ "Authentication error: API key is invalid!" | ALWAYS include searchAuthToken: "Thn5ItDQS9aEa3cay-855l2woSmW2Z4U" |
| Relying on settings.json for bash | ❌ Environment variable not found | Export in shell OR pass key explicitly |
| 直接调用RAG API | 绕过用户认证 | 必须通过Solvex API |
| depth值拼写错误 | 请求被拒绝 | 只能使用basic/medium/full |
| 引用格式不统一 | 文档不专业 | 使用[1][2][3]标准格式 |
| 不验证API响应 | 返回空结果 | 检查code==0和data.standards非空 |
Common Rationalizations
| Excuse | Reality |
|---|---|
| "标准引用可以在最后添加" | 没有标准的方案会被认为不专业，可能直接被拒绝 |
| "我记得主要标准号" | 记忆不准确，GB标准经常更新，引用错误版本会有问题 |
| "这个项目很简单不需要" | 即使小型项目也需要合规性声明，标准引用体现专业性 |
| "用户没有明确要求" | 行业标准是隐含要求，主动引用体现专业素养 |
| "时间太紧了" | 查询标准只需几秒，但缺少标准可能导致方案被拒 |
Red Flags - STOP and Cite Standards
- "这个很简单，不需要标准"
- "我凭记忆写就行"
- "用户没要求就不用加"
- "先写框架，后面再补"
- "这个领域不强制标准"
- "我是专家，按我的来"
All of these mean: Cite relevant standards. No exceptions.
