Agent Skills
返回列表
🤖

Atlas 文档处理

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/cainingnk-atlas-docs-101。

技能介绍

要解决什么问题

在 IDE 里写代码时,大模型经常需要对照官方文档回答 API 用法、配置项或迁移说明,但模型训练数据往往滞后,自行联网检索又容易抓到过时页面或碎片化片段。Atlas Docs 这类服务把各库与框架的文档预先整理成适合 LLM 阅读的 Markdown,再通过 MCP 暴露给 Cursor、Cline、Windsurf 等客户端,让助手按文档集名称和页面路径做结构化查询,而不是凭记忆编造。

技能如何工作

本技能把助手定位在路由层:理解用户意图、选对工具、补齐参数,由 scripts.tools 调用后端 API。典型链路是先用 list_docs 列出可用文档集并取得 docName,再按需要走不同路径:

  • get_docs_index:快速浏览某文档集有哪些页面
  • search_docs:按关键词在文档集内检索相关页面
  • get_docs_page:用相对路径拉取单页完整内容
  • get_docs_full:一次性拉取整份文档(体量大,宜谨慎使用)

工具返回包含 raw(原始 JSON)、success 与 message;展示时应以 raw 为准整理给用户。参数不全时需通过 AskUserQuestion 向用户确认,例如缺少 docName、query 或 pagePath。

适用边界与注意点

必须配置 API 密钥:.env 中若无 XBY_APIKEY,须询问用户后调用 scripts.config.set_api_key 保存;禁止在无密钥时搜索或编造文档内容。密钥在 xiaobenyang.com 获取。此外,get_docs_full 适合需要通读全文的场景,日常查 API 更宜 search_docs + get_docs_page,以控制上下文长度。

使用场景

  • 在 Cursor 里对接 unfamiliar 的 npm 包,需要先列出文档集再在集内搜索 authentication 相关页面
  • 升级框架大版本前,用 `get_docs_index` 扫一遍迁移指南目录,再按路径读取 breaking changes 单页
  • 用户给出具体错误码,在指定 `docName` 下 `search_docs` 定位官方说明并 `get_docs_page` 返回完整段落
  • 评估是否引入某库时,对比两个文档集的索引与检索结果,避免让模型凭训练数据臆测 API

适合人员

  • 在 Windsurf/Cursor 里频繁查第三方 SDK 文档的后端工程师,需要按官方页面回答集成问题
  • 负责框架版本升级的 Tech Lead,希望助手只引用可验证的迁移文档而非论坛帖子
  • 写 AI Agent 工作流的产品工程师,要把文档查询封装成固定 MCP 工具链并遵守密钥流程
  • 在技术评审中核对库能力边界的前端开发者,需要检索并引用完整 API 单页