111:用自然语言查询资产、采购与应用后台数据

前言

运维、采购或应用运营同事经常要在多个后台里翻列表:按序列号查资产、按省份筛合同、看验收记录或应用使用日志。每次都要记住菜单路径、字段名和分页参数,再手工拼查询条件,成本高也容易漏筛选项。

若你已经在用支持 Skill 的 Agent(如 Cursor、Claude Code),可以把查询意图交给模型,由 Skill 按约定好的 HTTP 接口发起请求。下面介绍 SkillHub 社区技能 111(坐标 @user_62e67ef7/1165477):它在 SKILL.md 中写清了五类业务查询的网关地址、请求体字段和示例话术,Agent 读取后即可按场景调用对应 POST 接口。

这是什么

111 是 SkillHub 上的社区来源(community)技能,分类为 ai-agent,当前版本 1.0.0,由发布者 user_62e67ef7 维护。SkillHub 页面未单独写简介,能力以包内 SKILL.md 为准。

该技能不封装本地脚本,而是指导 Agent 以 API 接口调用 方式访问同一网关下的多个 appstoreOss 接口(基址为 http://111.34.85.148:9019)。平台标签标明 requires_api_key=false,即 Skill 元数据未要求额外 API Key;实际能否访问仍取决于你所在网络能否连上该网关,以及服务端是否另有鉴权。

核心功能

以下能力均来自 SKILL.md,按业务块划分。

资产信息查询

支持分页查询资产列表,可按序列号、资产类型、交付状态、状态、公司名称、项目类型、省市区、激活状态、资产管理员、时间范围等筛选。

接口:

POST http://111.34.85.148:9019/gateway/appstoreOss/asset/queryAssetInfo
Content-Type: application/json

请求体字段包括 pageNo、pageSize,以及 serialno、type、deliverState、state、companyName、projectType、provinceId、cityId、countyId、activeState、assetAdmin、date、startTime、endTime 等(空字符串表示不按该维度过滤)。

采购合同信息查询

支持按采购单号、供应商、省份、状态筛选采购合同分页列表。

POST http://111.34.85.148:9019/gateway/appstoreOss/procurement/contract/getProcurementContractPageList
Content-Type: application/json

请求体示例结构:

{
    "pageNo": 1,
    "pageSize": 10,
    "procurementNo": "",
    "supplier": "",
    "province": "",
    "status": ""
}

验收信息查询

支持按采购单号、设备名称、SN、设备类型、设备归属、省份查询验收分页列表。

POST http://111.34.85.148:9019/gateway/appstoreOss/procurement/acceptance/getProcurementAcceptancePageList
Content-Type: application/json

应用管理查询

支持按应用名称、类型、审核状态、状态、开发者 ID、上线状态查询应用管理列表。

POST http://111.34.85.148:9019/gateway/appstoreOss/appManage/getManageAppPageList
Content-Type: application/json

应用使用日志查询

支持按开始时间、结束时间分页查询应用使用日志。

POST http://111.34.85.148:9019/gateway/appstoreOss/appUselog/getAppUseLogPageList
Content-Type: application/json

安装与启用

安装 SkillHub CLI

若本机尚未安装 skillhub,可先检查版本:

command -v skillhub && skillhub --version

未安装时,可按 SkillHub 官方安装文档执行(完整安装含 CLI 与默认 Skill):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装技能 111

安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录,否则默认会装到 ./skills/,Agent 可能识别不到。官方页面给出的安装提示为:依据 https://skillhub.cn/install/skillhub.md ,安装 @user_62e67ef7/1165477。

命令行等价写法为:

skillhub install 1165477 --namespace user_62e67ef7 --dir <你的 skills 目录>

常用客户端 skills 路径(摘自 SkillHub 安装文档):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后,按你所用客户端的要求重启或刷新 Agent,使其加载新 Skill。

典型用法

SKILL.md 中为每类查询给出了自然语言示例,Agent 在匹配到意图后应构造对应 POST 请求体并调用网关。你可直接复用或改写下列说法:

资产

  • 帮我查询资产列表
  • 查询资产序列号为 XXX 的信息
  • 帮我查山东省的资产
  • 查询资产管理员是 XXX 的资产

采购合同

  • 帮我查询采购合同列表
  • 查询采购单号 XXX
  • 查询山东省的采购合同
  • 查询已完成的采购合同

验收

  • 帮我查询验收列表
  • 查询采购单号 XXX 的验收信息
  • 查询设备 SN 为 XXX 的验收记录
  • 查询山东省的设备验收信息

应用管理

  • 帮我查询应用列表
  • 查询已上线的应用
  • 查询名称为 XXX 的应用
  • 查询开发者 XXX 的应用

应用使用日志

  • 帮我查询应用使用日志
  • 查询今天的应用使用记录
  • 查询近 7 天的应用使用日志

分页时默认常从 pageNo: 1、pageSize: 10 起步;需要更多结果时让 Agent 调整分页参数或说明翻页需求。

适用场景与注意

适合谁

  • 已接入 SkillHub、并在 Cursor / Claude Code 等环境使用 Agent 的团队。
  • 日常需要查资产、采购合同、验收、应用台账或使用日志,且后端已暴露上述网关接口的环境。

限制与注意

  1. 网络与权限:接口指向内网或专线 IP,仅在可达该网关的网络中有效;Skill 元数据未声明 API Key,若网关后续要求鉴权,需在 Agent 或代理层自行补充,当前 SKILL.md 未描述 Token 头。
  2. 名称与检索:SkillHub 展示名为「111」,搜索时可能与其他同名技能混淆,安装时请确认坐标为 @user_62e67ef7/1165477。
  3. 数据与合规:查询结果来自远端业务系统,请遵守本单位数据访问与审计规定;勿在不可信环境中把敏感筛选条件发给第三方模型,必要时在本地或私有化 Agent 中使用。
  4. 平台数据:截至资料核对时,SkillHub 显示评分为 100000,下载 968 次,安装计数为 0;该数字只反映商店统计,不代表接口可用性。

结尾

111 把资产、采购、验收、应用管理及使用日志五类查询收敛到一份 SKILL.md 里,适合用自然语言驱动 Agent 调用固定网关接口,减少反复登录后台手工筛表。安装前确认 skills 目录与网络可达性,使用时以包内文档中的 URL 与 JSON 字段为准。

官方页面:https://www.skillhub.cn/skills/user_62e67ef7/1165477

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye