技能介绍

它解决什么问题

在 Python 生态里，PyPI 包的文档往往散落在 Read the Docs、官方文档站和包内的 docstring 之间。开发者想确认某个函数的签名、类型提示或调用示例时，通常要离开当前项目，在多个站点之间来回翻找。这个技能把「查文档」这一步收敛到本地索引：通过 PyPI JSON API 获取包元数据，再结合 Read the Docs API 抓取托管文档，最终生成一份可搜索的参考目录。

核心能力与工作方式

技能的核心流程可以拆成两步：

元数据抓取：调用 PyPI 的 JSON API，拿到包的版本、依赖、描述等结构化信息；
文档索引：对 Read the Docs 上托管的文档做抓取与解析，提取其中的函数签名、类型提示和代码示例。

输出结果是一个可搜索的参考目录，而不是简单地把文档页链接罗列出来。这意味着检索某个函数名时，能直接定位到签名与用法示例，不必再逐页浏览 HTML。

适用边界与注意点

数据来源是 PyPI JSON API 与 Read the Docs API，因此只能覆盖发布到 PyPI 且文档托管在 Read the Docs 的包。托管在其他平台（GitHub Pages、自建文档站等）的文档不在索引范围内。
PyPI 是 Python 官方包仓库，但包文档的质量和完整性由各维护者决定。索引器负责结构化抓取，无法替上游修复缺失或过时的说明。
若工作流涉及包发布，SKILL.md 中给出了 Trusted Publisher 相关操作的参考，包括为已有项目添加 Trusted Publisher、用 Trusted Publisher 创建新项目以及发布流程，详见官方文档站 docs.pypi.org。
索引结果的时效性取决于上游文档的更新频率；包发布新版本后文档可能随之变化，建议对关键依赖定期重建索引。