licanfu/multica-best-practices/multica-platform-knowledge-base

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 执行规范（必须）

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

配置

超时 / 不可用停轮规则（强制）

禁止为等知识库结果而卡在「运行中」。

1. --health 失败，或 kb_ask.py 超时/报错 → 标注「团队知识库不可用/超时」
2. 立刻结束本轮等待，说明阻塞与可选方案（重试 / 跳过知识库 / 检查 Bridge）
3. 调用方（如 T1 Step 0.5）可标注后继续，但不得反复轮询到用户感知卡死
4. 禁止因不可用而臆造业务规则或引用来源

故障排查

与测试流程的关系

• T1 功能用例（multica-test-t1-design）：生成前 Step 0.5 查知识库补入口/术语；验收仍以当前 JIRA/PRD 为准
• 接口场景补充（multica-platform-apifox）：查同模块历史鉴权/造数方式
• 前端/后端实现：查模块约定、错误码、权限语义

为什么有效

知识库从测试专用 squad 抽成 platform skill，各角色按名挂载，避免在角色提示词写死 Bridge 地址或 SSH 路径。