docs-seeker 是一个脚本优先(Script-first)的文档发现工具,基于 llms.txt 标准工作,主要面向需要快速定位技术文档、库用法或仓库资料的场景。其核心思路是:整个检索流程通过执行脚本完成,无需手动构造 URL,脚本会自动处理 URL 拼接、降级链和错误处理。
主要能力由三个脚本构成。detect-topic.js 用于分类查询类型,区分“主题特定查询”与“通用查询”,提取库名和主题关键词,返回 JSON:{topic, library, isTopicSpecific}。fetch-docs.js 用于获取文档,自动构造 context7.com 的 URL,按“主题 → 通用 → 错误”的顺序降级,输出 llms.txt 内容或错误信息。analyze-llms-txt.js 用于处理 llms.txt,将 URL 划分为关键、重要、补充三类,并建议智能体分工方式(1 个、3 个、7 个或分阶段),返回带策略的 JSON。三个脚本均为零 token 执行开销。
推荐使用顺序为:先执行 node scripts/detect-topic.js "<user query>" 检测查询类型,再执行 node scripts/fetch-docs.js "<user query>" 抓取文档,若返回多个 URL 则用 cat llms.txt | node scripts/analyze-llms-txt.js - 分析结果。对于主题特定查询(如“How do I use date picker in shadcn?”),通常返回 2-3 个 URL;对于通用查询(如“Documentation for Next.js”),可能返回 8 个以上 URL,此时按 analyze 脚本建议分派智能体读取。
该技能还提供工作流参考(主题搜索、库搜索、仓库分析)与参考文档(context7 URL 模式、错误处理、进阶边界情况)。执行原则包括:脚本优先、零 token 开销、自动降级、渐进式加载参考资料、按脚本建议分派智能体。脚本会按 process.env > .claude/skills/docs-seeker/.env > .claude/skills/.env > .claude/.env 的顺序加载 .env。
适用场景为需要检索技术文档、库用法或代码仓库信息的开发与研究工作。限制方面:资料未提供所支持的平台、依赖安装方式、收费情况、检索速度以外的性能数据以及 context7.com 之外的数据源说明,这些内容暂未提供。