mcpField
S
searching-packages

searching-packages

github.com/robomotionio开发5121 次安装5 天前更新
代码仓库

关于 searching-packages

Robomotion 技能,通过 `robomotion` 命令行查找包、节点和模板,并查看其架构与文档。搜索支持模糊匹配和同义词扩展,覆盖多个来源。

主要功能

  1. 01搜索包、节点和模板
  2. 02按包、标签或类别筛选资源
  3. 03查看节点架构和包详情
  4. 04读取并筛选包文档
  5. 05模糊搜索与同义词扩展

适用场景

  1. 01为工作流查找节点
  2. 02连接节点前核对属性
  3. 03查找包的身份验证说明

MCP 相关

该技能使用 `robomotion` 命令行;搜索会在后台启动 `robomotion-sdk-mcp`。无需单独的 MCP 客户端。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/robomotionio/agent-skills --skill searching-packages

安装后在 Claude Code 中输入/searching-packages确认已加载。

附带文件config.json

详细介绍

搜索 Robomotion 包

发现 Robomotion 包、节点和模板。所有查询都通过 robomotion CLI 完成——无需单独的 MCP 客户端。

四个动词涵盖所有查询

robomotion search <query>                        # cross-source fuzzy+semantic search
robomotion get <resource> [query] [flags]        # list or filter a resource
robomotion describe <resource> <name>            # full detail of one thing
robomotion docs <namespace>                      # read a package's llms.txt

get 的资源:packages | nodes | templates | categories | tags(运行时数据还包括 vaults | vault-items | robots)。 describe 的资源:node | package | template。

编写流程时的典型工作流

  1. 查找可用内容 — 如果你还不知道要用哪个包或节点:

    robomotion search "http request"              # mixed results across sources
    robomotion get nodes click                    # nodes with "click" in the name
    robomotion get nodes --in Core.Browser        # every node in one package
    robomotion get templates bmi                  # match by slug/name/summary
    robomotion get templates --category "Web Scraping"
    robomotion get templates --tag api
    robomotion get categories                     # vocabulary
    robomotion get tags                           # vocabulary
    
  2. 验证属性后再编写:

    robomotion describe node Core.Net.HttpRequest
    robomotion describe node Core.Net.HttpRequest,Core.Flow.GoTo   # batch
    

    返回完整卡片:属性名称、类型、描述、枚举值、默认值和常见属性(delayBefore、continueOnError,……)。

  3. 为非 Core.* 包接线时,阅读包文档:

    robomotion docs Robomotion.WordPress                   # compact (first 100 lines)
    robomotion docs Robomotion.WordPress --full            # whole llms.txt
    robomotion docs Robomotion.WordPress --grep auth       # line-filtered
    robomotion docs Robomotion.WordPress --section CreatePost
    

    docs 包含身份验证模式和包级别的注意事项,这些内容不会出现在节点架构中。每个你使用的非 Core.* 包都要运行此命令。许多包没有 llms.txt(例如 Robomotion.HermesAgent):此时 docs 会返回 "available":false,而包自身的描述就是文档——运行 robomotion describe package <ns> 查看其节点和版本,并对每个接入的节点运行 robomotion describe node <type>(每个属性都附带描述)。

搜索引擎功能

在底层,robomotion search 使用 Bleve 全文搜索,支持:

功能行为
全文搜索根据标题、名称、描述、内容和关键词进行 BM25 排名
模糊搜索Levenshtein 距离 ≤ 2 — 可容忍拼写错误(browsr → browser、wordpres → wordpress)
语义搜索同义词扩展 — 搜索 browser 也会匹配 chrome、firefox、web、scraping
多源搜索一次调用即可搜索包文档(llms.txt)和模板

内置同义词组:

  • browser ↔ chrome · firefox · web · scraping
  • automation ↔ robot · flow · workflow · process
  • wordpress ↔ blog · cms · post · article
  • database ↔ sql · sqlite · query · table
  • email ↔ mail · smtp · send · message
  • file ↔ filesystem · directory · folder · path

筛选标志

robomotion search "automation" --limit 5
robomotion get nodes "click" --package Core.Browser
robomotion get templates --tag api --limit 10
robomotion describe node Core.Browser.ClickElement --json     # raw MCP response

首次调用预热

robomotion search 会在底层启动 robomotion-sdk-mcp;其 Bleve 索引在冷启动时需要约 3–6 s 才能构建完成。CLI 会在遇到 "Search index not ready" 时自动重试,因此每个会话中会有一次搜索较慢,之后则几乎即时完成。

快速参考

我想要……命令
按关键词查找任何内容robomotion search <query>
列出所有包robomotion get packages
查找包robomotion get packages <keyword>
列出包中的节点robomotion get nodes --in <namespace>
按关键词查找节点robomotion get nodes <keyword>
获取完整节点架构robomotion describe node <type>
阅读包文档robomotion docs <namespace>
搜索包文档robomotion docs <namespace> --grep <pattern>
列出可用保险库robomotion get vaults
列出机器人robomotion get robots

相关技能

  • creating-flow — 使用找到的节点生成流程
  • validating-flow — 对结果进行 pspec 检查
  • running-flow — 提交流程并流式接收 Agent 事件

评论

支持 Markdown