技能介绍

解决 RFC 文档检索的碎片化痛点

在网络协议开发与系统架构设计中，工程师经常需要查阅 IETF 发布的 RFC（Request for Comments）标准文档。然而，传统的查阅方式往往依赖手动打开浏览器、在 ietf.org 庞大的目录中搜索、复制粘贴正文，甚至手动解析 HTML 标签提取特定章节。这种碎片化的操作不仅打断了开发心流，也难以与自动化工作流或大模型 Agent 进行无缝集成。RFC 文档服务 旨在将这一过程标准化，提供一个专为程序化交互设计的 MCP（Model Context Protocol）服务器，让大模型能够直接、结构化地获取和阅读 RFC 文档。

核心能力与路由机制

该技能的核心在于将“意图理解”与“API 调用”解耦。大模型作为智能路由层，负责解析用户的自然语言指令，将其映射为具体的工具调用。技能底层封装了三个核心工具函数：

scripts.tools.get_rfc：通过 RFC 编号获取完整文档、元数据或结构化分段。
scripts.tools.search_rfcs：基于关键词或短语进行全文检索，支持限制返回结果数量。
scripts.tools.get_rfc_section：精准提取特定编号文档中的指定章节或段落。

关键工作流程如下：

密钥鉴权：首次调用前，系统会检查 scripts.config.settings.api_key。若为空，将通过交互式提问向用户索要 API 密钥，并调用 scripts.config.set_api_key(key) 持久化保存。
意图路由：根据用户请求匹配上述三个工具之一。若关键参数缺失，会主动追问以补全上下文。
参数注入：使用关键字参数（Keyword Arguments）调用对应的工具函数，例如 scripts.tools.get_rfc(number='2616', format='metadata')。
数据组装：接收底层 API 返回的字典对象，提取 raw 字段中的 JSON 数据进行整理，并将最终结果反馈给用户。

适用边界与安全约束

该服务高度依赖外部 API 的可用性与权限配置。最显著的注意点是强绑定的 API 密钥机制。在未提供有效 XBY_APIKEY 的情况下，技能将被严格限制调用，大模型绝对禁止通过其他网络搜索工具自行寻找或编造 RFC 内容，以确保数据源的唯一性与准确性。此外，虽然工具支持按需提取章节，但面对超长篇幅的协议规范时，仍需在 limit 参数和返回数据的 token 消耗之间做好权衡，避免上下文溢出。