用途:这是一个针对 ZIO HTTP 的知识检索技能,目标是保证涉及 ZIO HTTP 的事实与代码准确,不依赖模型训练数据,回答前先抓取对应文档页面。
主要能力与原则:准确优先于记忆,回答前先获取相关文档;优先 MCP 工具,回退站点地图;所有回答附带文档 URL 或文档路径以便用户核实;定位到具体参考页而非泛泛概览;回退 WebFetch 时优先抓取文档 URL 的 .md 版本,失败再用普通 HTML 页面。
使用方式:先判断 zio-http MCP 服务器(https://mcp.ziohttp.com/mcp)是否已连接。已连接时,先调用 search_docs 检索问题,结果为 path 就用 get_doc_page(path) 取全文,为 source_url 则直接抓取;需要浏览全部索引页可用 get_doc_index。未连接时回退到 LLM 站点地图 https://ziohttp.com/llms.txt,按 llmstxt.org 标准列出各页 URL 与一行描述,再抓取对应 .md 页面。若会话需要跨章节回答多个问题,可一次性读取全文文档 https://ziohttp.com/llms-full.txt。
适用场景:路由、Endpoint API、认证、客户端、模板、迁移等 ZIO HTTP 相关问答。不确定性时引导用户查看 https://ziohttp.com。
其他资源:GitHub 仓库 https://github.com/zio/zio-http、Maven Central 制品 dev.zio/zio-http_3、示例目录 zio-http-example/src/main/scala/example。
常见失败处理:search_docs 返回 source_url 时直接抓取,不要调用 get_doc_page;get_doc_page 失败先原样重试一次再回退站点地图;MCP 不可用回退站点地图;站点地图抓取失败先重试一次,仍失败则以 GitHub 源码与 README 为准;页面 404 说明已改名或删除,重新抓取站点地图定位新 URL;主题不在站点地图中,可搜索示例目录与 zio-http/src/main/scala/zio/http 下的源码;多页覆盖同一主题时优先 ziohttp.com 页面,内容有实质差异则同时引用;文档与训练数据冲突时以文档为准,并引用页面便于核实。
限制:技能本身为文档检索工作流,不提供额外功能或托管服务;所有能力依赖文档站点与 MCP 服务可用性,具体 API 细节以官方文档为准。