前言¶
采购、运维或做工业软件时，经常要在规格书里核对轴承型号，或按内径、外径、宽度筛一批候选件。这类查询往往分散在内部系统或供应商站点里，对话式助手若没有明确流程，容易只给出泛泛建议，无法落到可核对的产品列表。
下面介绍 SkillHub 上的 bearingsearch（@user_59555a97/bearingsearch）。它把「解析用户意图 → 调用轴承搜索接口 → 表格化结果」写进标准 SKILL.md，让支持 Skills 的 Agent 在触发词匹配时按同一套参数与输出格式工作。SkillHub 标注该 Skill 无需 API Key（requires_api_key=false）。
这是什么¶
bearingsearch 是社区来源（community）的 Agent Skill，坐标 @user_59555a97/bearingsearch，当前版本 1.0.0，分类为 business-ops，由发布者 user_59555a97 维护。
一句话定位：根据型号、品牌、尺寸参数搜索轴承产品，并将命中记录整理成表格供用户核对。
核心功能¶
依据 Skill 包内 SKILL.md 与 SkillHub 页面说明，已核实的能力如下。
搜索与筛选维度¶
支持通过自然语言或结构化参数组合查询，字段包括：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 否 | 型号或品牌关键词 |
| partNumber | string | 否 | 精确型号 |
| minInnerDiameter / maxInnerDiameter | number | 否 | 内径范围（mm） |
| minOuterDiameter / maxOuterDiameter | number | 否 | 外径范围（mm） |
| brandId | string | 否 | 品牌 ID |
| bearingTypeId | string | 否 | 轴承类型 ID |
| page | number | 否 | 页码，默认 1 |
| pageSize | number | 否 | 每页数量，默认 20 |
后端接口（Skill 文档约定）¶
Agent 按 Skill 工作流调用以下 HTTP 接口（路径为 Skill 内文档所列，需由运行环境提供可访问的 API 基址）：
GET /api/bearings/search— 搜索轴承列表GET /api/bearings/by-part/:partNumber— 按精确型号查询GET /api/bearings/hot— 热门轴承推荐GET /api/brands— 品牌列表GET /api/bearing-types— 轴承类型列表
内置工作流¶
- 解析用户输入，提取型号、尺寸范围、品牌等搜索参数。
- 调用
GET /api/bearings/search（或对精确型号走by-part）执行查询。 - 将结果格式化为表格或列表。
- 若无结果，提示用户放宽或调整条件。
触发词¶
Skill 元数据中声明的触发词包括：search、find、bearing、轴承、搜索。用户提到轴承选型、查型号时，Agent 更容易选中该 Skill。
输出形态¶
成功时按模板展示分页与表格列：型号、品牌、内径、外径、宽度、类型。
安装与启用¶
方式一：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
安装 bearingsearch 时，必须用 --dir 指向当前 Agent 的 skills 目录；默认 ./skills/ 可能不会被客户端加载。示例：
skillhub install @user_59555a97/bearingsearch --dir ~/.cursor/skills/
其他常见路径（来自 SkillHub 安装文档）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/ - Windsurf：
~/.codeium/windsurf/skills/或.windsurf/skills/
安装完成后，按你所用客户端要求重启或刷新 Skills 列表。
方式二：让 Agent 按官方提示安装¶
SkillHub 页面提供的安装提示为：根据 https://skillhub.cn/install/skillhub.md，安装 @user_59555a97/bearingsearch。可将该句发给已接入 Skill 安装的助手，由它按文档完成 CLI 与 --dir 配置。
典型用法¶
Skill 设计为对话驱动，无需单独记 CLI 子命令。下列示例与 SKILL.md 中的参数、工作流一致，便于在 Agent 里复现。
按精确型号查询（纯数字型号会走精确型号逻辑，例如文档中的四位以上数字型号）：
查轴承型号 6204
按「内径 × 外径 × 宽度」尺寸串筛选（单位 mm，Skill 实现支持 20x47x14 或 × 分隔）：
找内径外径宽度 20x47x14 的轴承
带文字标注的尺寸与品牌：
轴承 内径 25 外径 52 品牌 SKF
分页（对应 page、pageSize）：
搜索 keyword 深沟球 轴承，第 2 页，每页 10 条
Agent 应返回类似结构：
找到 N 条结果（第 X 页）：
| 型号 | 品牌 | 内径 | 外径 | 宽度 | 类型 |
|------|------|------|------|------|------|
| ... | ... | ... | ... | ... | ... |
若需品牌或类型 ID，可先通过 Skill 文档中的 GET /api/brands、GET /api/bearing-types 获取列表，再在搜索参数中填入 brandId、bearingTypeId。
适用场景与注意¶
适合谁
- 在 Cursor、Claude Code、Codex 等支持 Skills 的环境里做轴承选型、报价前规格核对。
- 希望 Agent 输出统一表格，而不是自由发挥一段 unstructured 文本的团队。
限制与注意
- Skill 描述的是查询流程与接口契约；实际能否搜到数据，取决于运行环境是否配置了可访问的轴承 API 基址，以及后端库是否覆盖你的品牌与型号范围。SkillHub 标签标明 requires_api_key=false，但具体部署仍可能因企业网关或内网策略而不同。
- 包内除
SKILL.md外含有 TypeScript 执行器源码，引用上层api模块；在纯「只读 SKILL 指导 Agent」的场景下，以SKILL.md为准即可。若你依赖自动执行器，需确认宿主项目是否提供对应 API 客户端与基址配置。 - SkillHub 页面统计（截至查阅时）：评分 100000，下载约 740 次；安装计数可能随客户端上报变化，以 SkillHub 为准。
结尾¶
bearingsearch 把轴承检索的参数字段、REST 路径和表格输出固定成可复用的 Agent Skill，适合在对话里快速从型号或尺寸落到可核对的产品列表。需要安装或更新时，以 SkillHub 为准：
- 技能页：https://www.skillhub.cn/skills/user_59555a97/bearingsearch
- API 元数据：https://api.skillhub.cn/user_59555a97/bearingsearch
- 安装说明：https://skillhub.cn/install/skillhub.md
