mcpField
O
oma-search

oma-search

github.com/gracefullight生产力4945 次安装1 天前更新
代码仓库

关于 oma-search

oma-search 会将信息查询路由到文档、网页、远程代码或本地代码搜索，并返回带有来源和可信度信息的结果。它面向需要查找 API 文档、网络资料或代码实现模式的用户，并说明搜索路径的限制。

主要功能

  1. 01按查询选择搜索渠道
  2. 02搜索官方文档与网页
  3. 03搜索远程仓库代码
  4. 04返回来源、相关性和可信度
  5. 05披露回退路径与限制

适用场景

  1. 01查找库和框架的官方文档
  2. 02研究网页资料并核对来源
  3. 03寻找 GitHub 或 GitLab 实现模式
  4. 04搜索当前项目的文件与符号

安装

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

$npx skills add https://github.com/gracefullight/stock-checker --skill oma-search

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

resources/
checklist.md
error-playbook.md
examples.md
execution-protocol.md
intent-rules.md
trust-registry.md

详细介绍

搜索路由器

调度

目标

将信息请求路由到适当的渠道，并返回带有信任标签的相关来源。

意图特征
  • 搜索、查找、查询、参考文档、检查官方 API，或搜索远程代码。
  • 其他技能请求使用文档、网页、代码或本地搜索，并提供查询和约束条件。
适用场景
  • 库文档、网络研究、GitHub/GitLab 实现模式，或搜索渠道不明确时。
不适用场景
  • 纯粹探索本地代码 → 使用共享契约中配置的代码智能。
  • Git 历史记录/责任归属查询 → 使用 oma-scm；架构分析 → 使用 oma-architecture。
预期输入

查询、可选的路由提示（docs、web、code、local）、来源/时效性约束和标志。显式指定 --docs、--code 或 --web 会选择相应路由；--strict 会筛选信任级别，--wide 会保留带标签的结果，--gitlab 会选择远程代码托管平台。

预期输出

按排名排列的来源，包含 URL 或文件引用、路由、相关性、信任级别/分数，以及重要的回退限制。如果没有找到可靠结果，不要编造来源。

依赖项

文档搜索使用 Context7，网页搜索使用运行时网页搜索，远程代码搜索使用 oma search/gh/glab，本地搜索使用已配置的代码智能或原生本地搜索。

结构化流程

路由
路由主要方式回退方式适用场景
docsContext7 resolve-library-id → query-docs网页搜索官方 API/框架文档
web运行时网页搜索对已知结果 URL 使用 oma search fetch <url>网页来源
codeoma search code报告托管平台/身份验证不可用远程仓库模式
local已配置的代码智能提供程序原生搜索和范围限定的读取当前项目文件和符号
失败与恢复
  • 文档查询缺失/为空：使用网页搜索并说明已回退。
  • 已知 URL 无法获取：使用路由参考中的获取策略；如果所有策略均失败，则保留身份验证/访问受阻错误。
  • 已配置的本地工具不可用或超时：遵循 ../_shared/core/code-intelligence.md。
  • 信任级别未知：保留结果并将其标记为 unknown，分数标为 —；不要暗示结果已得到验证。
  • 没有结果满足 --strict：报告此结果，并提供扩大或缩小查询范围的选项。
退出

返回有证据支持的结果，并说明失败的路由或来源限制。仅有域名分数并不能验证具体声明。

逻辑操作

规范工作流路径
  1. 解析查询和显式标志。仅在需要分类时使用 resources/intent-rules.md；除非存在歧义，否则只选择一个路由。
  2. 根据“路由”进行分派。为所选渠道加载 resources/execution-protocol.md，以了解命令标志、获取策略或规范化详情。
  3. 收集来源引用并按 URL 去重。对于非本地结果，使用 resources/trust-registry.md 确定域名信任级别；复用当前会话缓存。评分后再应用 --strict。
  4. 按相关性排序，并以信任级别作为次要排序依据。返回所需答案或来源列表，并附上支持性引用和回退限制。
CLI 入口
oma search code "<query>" [--host gitlab] [--language <lang>] [--repo <owner/repo>]
oma search trust <domain>
oma search fetch <url>

CLI 还提供 api、api:search、meta、rss、rss:google、media、archive 和 doctor；只有所选路由需要时才使用这些基础功能。

防护规则
  • 显式路由/来源约束优先于自动分类。
  • 在域名级别评分，而非 URL 路径或页面级别。使用 CLI 注册表以及文档中列明的 Context7/官方网站例外；不要编造分数。
  • 不要重复执行已成功的路由，也不要通过网页在本地搜索。
  • 使用可用的运行时网页工具和已配置的本地提供程序；不要自动安装或跟踪仓库。
资源范围和影响

搜索可能会联系外部服务、检查本地代码并启动 gh/glab 进程。查询约束、所选来源和信任元数据属于会话上下文；持久缓存应存放在生成状态中，而非技能定义中。

参考资料

  • 意图分类器：resources/intent-rules.md（未指定路由或查询含糊）
  • 路由执行详情：resources/execution-protocol.md（仅限所选渠道）
  • 信任解析和缓存规则：resources/trust-registry.md（非本地来源）
  • 恢复详情：resources/error-playbook.md（路由失败）
  • 结果检查清单：resources/checklist.md（适用路由的检查项）
  • 示例：resources/examples.md（不熟悉的输入／输出约定）
  • 本地代码智能约定：../_shared/core/code-intelligence.md

评论

支持 Markdown