it235 Platform · Knowledge Base（远程 Wiki）
Purpose
通过 Knowledge Base Bridge（知识库 Bridge） HTTP API 查阅团队 Wiki 知识库。供 @Tester / @FrontendDev / @BackendDev / @Architect 查入口路径、术语、历史背景。
整合自
内部知识库 squad；脚本scripts/kb_ask.py（仅 stdlib，跨平台）。
架构
Agent（本机）
↓ kb_ask.py（HTTP）
Knowledge Base Bridge :3910
↓ Cursor SDK Agent + Skills
团队知识库
/home/ubuntu/cursor-workspace/.cursor/skills/knowledge-base/知识库/
（路径在知识库服务侧；本机 Agent 仅通过 Bridge HTTP 访问。）
Agent 执行规范（必须）
| 步骤 | 动作 | 禁止 |
|---|---|---|
| 1 | python scripts/kb_ask.py --health |
SSH 兜底、手写 curl |
| 2 | python scripts/kb_ask.py "问题" [系统代码] |
编造引用来源 |
| 3 | 呈现 stdout 的 answer |
把历史规则扩成当前验收点 |
Bridge 识别规则
脚本自动满足 Wiki 问答条件（Agent 不得改用其他 HTTP 方式绕过）：
taskId >= 500000000（脚本默认生成）- prompt 前缀
【Wiki 知识库问答】
何时使用
- 本机没有知识库副本，需查 CRM/MES/BOSS 等业务 Wiki
- 用户要求远程查 团队知识库
- T1 Step 0.5b：按模块关键词检索入口/术语/历史背景（验收仍以当前 JIRA 为准）
何时不必使用
- 本机已有完整知识库副本且可直接 Read/Grep 命中所需内容
- 问题与当前需求无关、或仅为验证 Bridge 连通性（用
--health即可）
用法
python scripts/kb_ask.py --health
python scripts/kb_ask.py "CRM 病例管理入口在哪？"
python scripts/kb_ask.py "MES 工单状态" MES
python scripts/kb_ask.py "问题" --json
配置
| 变量 | 说明 |
|---|---|
KB_BRIDGE |
Bridge 地址，默认见 config.yaml |
KB_POLL_INTERVAL |
轮询间隔秒，默认 2 |
KB_POLL_TIMEOUT |
超时秒，默认 600 |
超时 / 不可用停轮规则（强制）
禁止为等知识库结果而卡在「运行中」。
--health失败，或kb_ask.py超时/报错 → 标注「团队知识库不可用/超时」- 立刻结束本轮等待，说明阻塞与可选方案（重试 / 跳过知识库 / 检查 Bridge）
- 调用方（如 T1 Step 0.5）可标注后继续，但不得反复轮询到用户感知卡死
- 禁止因不可用而臆造业务规则或引用来源
故障排查
| 现象 | 处理 |
|---|---|
| 无法连接 Bridge | VPN/内网；python scripts/kb_ask.py --health |
| 超时 | 按上方停轮规则；仅在用户明确要求时增大 KB_POLL_TIMEOUT |
| status=error | 加 --json 查看 error |
与测试流程的关系
- T1 功能用例（
multica-test-t1-design）：生成前 Step 0.5 查知识库补入口/术语；验收仍以当前 JIRA/PRD 为准 - 接口场景补充（
multica-platform-apifox）：查同模块历史鉴权/造数方式 - 前端/后端实现：查模块约定、错误码、权限语义
为什么有效
知识库从测试专用 squad 抽成 platform skill，各角色按名挂载，避免在角色提示词写死 Bridge 地址或 SSH 路径。