安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install jishudb-mcp-check
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 jishudb-mcp-check。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

JishuDB MCP Check 通过主机代理已配置的 JishuDB MCP 连接器，运行明确请求的功能测试。默认的冒烟模式会检查连接、功能和可见工具目录，而不会修改资源；all-tools 模式则运行范围更广、彼此隔离的验收套件，使用临时测试数据，并要求明确批准。
作为用于 MCP 连接器验证的 Openclaw Skills 之一，它着重于观察到的证据、与契约基线的比较、严格的凭据脱敏，以及清理运行期间创建的资源。它不用于初始连接器设置、连接修复或常规知识库搜索。

应用场景

配置 JishuDB MCP 连接器后，运行只读冒烟测试。
将服务器公布的工具与打包的
jishudb-mcp-v2
契约基线进行比较。
使用临时测试数据，运行经明确批准且彼此隔离的 all-tools 验收测试。
生成 Markdown 报告，展示测试结果、覆盖缺口、契约偏差和清理状态。
确定测试是否因缺少连接器、授权、外部前置条件或主机功能而受阻。

工作原理

确认主机已公开配置好的 JishuDB 连接器；如果没有，则将前置条件标记为 BLOCKED 并停止。
调用 kb_get_capabilities 并验证 jishudb-mcp-v2 契约。记录报告的传输方式、版本、修订版本、配置文件、工具和上传模式。
将运行时目录与打包的契约基线进行比较，将缺失工具记录为失败，将新增工具或摘要偏差记录为覆盖限制。
在冒烟模式下，仅运行只读用例。在 all-tools 模式下，要求使用 jishudb 配置文件，并在修改资源前取得对所述临时资源范围的批准。
生成运行 ID，按需创建限定于本次运行的测试数据，按文档规定的顺序执行用例，并依据返回的证据评估断言。
按文档规定的间隔和超时时间轮询异步作业；保留观察到的结果和经过脱敏的错误，不得捏造结果。
尝试有针对性地清理本次运行创建的资源，验证删除情况，并报告任何剩余的运行 ID。
生成 Markdown 验收报告，列出结果数量、未测试的工具、可采取行动的失败、清理状态、元数据可见性和脱敏声明。

配置指南

此技能需要主机代理已配置 JishuDB MCP 连接器。它不会安装或配置连接器，也不应用于设置或修复。
使用主机自身的技能管理流程安装此技能，或使其可供主机代理使用。
单独配置 JishuDB MCP 连接器，并确认代理可以访问该连接器。
对于 all-tools 模式，确保 jishudb 配置文件可用，并针对临时资源范围取得用户的明确批准。未指定模式时，默认使用冒烟模式。
确保主机能够读取技能的参考文件和捆绑的测试数据。直接上传覆盖测试还要求主机执行返回的原始字节 HTTP PUT。

SKILL.md 中未指定安装命令或包管理器工作流。

请按照主机代理文档说明的流程配置主机连接器。

数据架构

此技能会记录限定于本次运行的测试状态并生成 Markdown 验收报告；它不定义单独的持久化数据库架构。
记录或制品 用途
runId 安全用于文件系统的 UTC 时间戳加短随机后缀；用于限定测试运行范围。
kbId 临时知识库 ID，格式为 jishudb-mcp-check-。
noteId, noteCreatedAt 生成的 Note UUID 和 RFC 3339 时间戳，用于创建和重放 Note。
返回的资源 ID 记录 documentId、jobId、Note updatedAt、可选的 uploadId 以及任何经批准的 source ID；不得根据名称重构 ID。
用例记录 caseId、tool、expected、evidence、result、errorCode 和 cleanupImpact。
捆绑的测试数据 assets/canary.txt、assets/canary.pdf 和 assets/canary.md；仅用于文档说明的 all-tools 用例，并保留精确字节内容。
参考资料 references/test-cases.md、references/report-template.md、references/contract-baseline.md，以及 all-tools 模式所需的 references/fixture-values.md。
报告包含 PASS、FAIL、SKIP 和 BLOCKED 的数量；没有正向路径测试的已公布工具；首个可采取行动的失败；清理状态和剩余运行 ID；是否公开了稳定错误元数据；以及脱敏声明。不得包含凭据、Base64 测试数据值、本地路径、敏感上传授权值，以及包含查询参数或片段的完整导入 URL。

高级特性

提供不同的只读
smoke
模式，以及需明确批准且彼此隔离的
all-tools
模式。
根据打包的契约基线检查实时工具目录，并报告缺失工具、额外的未测试工具或契约摘要偏差。
使用限定于本次运行的 ID，并跟踪返回的资源标识符，以限制资源修改和清理范围。
以两秒为轮询间隔、最长等待 120 秒测试异步工作流；Note 刷新检查也允许在相同时间限制内进行防抖和处理。
当主机能够执行返回的原始字节 PUT 时，支持可选的直接上传覆盖测试；否则将正向路径标记为 BLOCKED，并可使用文档所述的 PDF 测试数据支持后续测试。
失败后继续执行安全且独立的只读诊断，同时停止修改失败的资源。
要求失败后尝试清理，并将清理失败视为总体 FAIL。
强制对凭据和敏感值进行脱敏，禁止使用私有 JishuDB HTTP API，并区分消费者层级的功能测试与原始 MCP 协议一致性测试。

name: jishudb-mcp-check description: >- 按用户明确要求测试已配置的 JishuDB MCP，适用于只读冒烟测试、工具能力核对、
全工具验收和验收报告；全工具模式需另行授权临时读写及清理。
不用于普通知识库查询或首次连接配置。 /
Run explicitly requested JishuDB MCP smoke checks or all-tools acceptance
through a configured host connector, with fixtures, cleanup, and a Markdown
report. Default to read-only smoke checks; not for initial setup or ordinary
knowledge search.
compatibility: Requires a host agent with a configured JishuDB MCP connector. The all-tools mode requires the jishudb profile. Optional direct-upload coverage requires the host to perform the returned raw HTTP PUT.