Name: multica-platform-knowledge-base
Author: LiCanFu

Imported from LiCanFu/multica-best-practices (templates/zh_CN/skills/platform/multica-platform-knowledge-base/SKILL.md). Install upstream with npx skills add LiCanFu/multica-best-practices --skill multica-platform-knowledge-base. Copyright stays with the author.

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 路径。

{ "ocm": "1", "id": "licanfu-multica-best-practices-multica-platform-knowledge-base", "kind": "skill", "name": "multica-platform-knowledge-base", "description": "远程 Wiki 知识库问答（Knowledge Base Bridge（知识库 Bridge））。平台 skill，测试/前端/后端按需挂载；由内容 skill 按名调用。", "publisher": "LiCanFu", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "远程 Wiki 知识库问答（Knowledge Base Bridge（知识库 Bridge））。平台 skill，测试/前端/后端按需挂载；由内容 skill 按名调用。" ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/LiCanFu/multica-best-practices", "path": "templates/zh_CN/skills/platform/multica-platform-knowledge-base/SKILL.md", "ref": "c7ffb17e9dd9c8085b0cc3b63fc044d96672b414", "url": "https://github.com/LiCanFu/multica-best-practices/blob/c7ffb17e9dd9c8085b0cc3b63fc044d96672b414/templates/zh_CN/skills/platform/multica-platform-knowledge-base/SKILL.md", "key": "LiCanFu/multica-best-practices/templates/zh_CN/skills/platform/multica-platform-knowledge-base/SKILL.md" } }, "instructions": "# Platform · Knowledge Base（远程 Wiki）\n\n## Purpose\n\n通过 **Knowledge Base Bridge（知识库 Bridge）** HTTP API 查阅团队 Wiki 知识库。供 **@Tester / @FrontendDev / @BackendDev / @Architect** 查入口路径、术语、历史背景。\n\n> 整合自 `内部知识库 squad`；脚本 `scripts/kb_ask.py`（仅 stdlib，跨平台）。\n\n## 架构\n\n```text\nAgent（本机）\n ↓ kb_ask.py（HTTP）\nKnowledge Base Bridge :3910\n ↓ Cursor SDK Agent + Skills\n团队知识库\n /home/ubuntu/cursor-workspace/.cursor/skills/knowledge-base/知识库/\n```\n\n（路径在知识库服务侧；本机 Agent 仅通过 Bridge HTTP 访问。）\n\n## Agent 执行规范（必须）\n\n| 步骤 | 动作 | 禁止 |\n| --- | --- | --- |\n| 1 | `python scripts/kb_ask.py --health` | SSH 兜底、手写 curl |\n| 2 | `py", "cost": { "context_tokens": 503 } }

multica-platform-knowledge-base

About