name: docs-seeker description: “使用可执行脚本搜索技术文档以检测查询类型,从llms.txt来源(context7.com)获取并分析结果。适用于用户需要时:(1) 主题特定文档(功能/组件/概念),(2) 库/框架文档,(3) GitHub仓库分析,(4) 文档发现与自动化代理分发策略” version: 3.1.0
通过脚本进行文档发现
概述
脚本优先 的文档发现使用llms.txt标准。
执行脚本来处理整个工作流程——无需手动构建URL。
主要工作流程
始终按此顺序执行脚本:
# 1. 检测查询类型(主题特定 vs 一般)
node scripts/detect-topic.js "<用户查询>"
# 2. 使用脚本输出获取文档
node scripts/fetch-docs.js "<用户查询>"
# 3. 分析结果(如果返回多个URL)
cat llms.txt | node scripts/analyze-llms-txt.js -
脚本自动处理URL构建、回退链和错误处理。
脚本
detect-topic.js - 分类查询类型
- 识别主题特定 vs 一般查询
- 提取库名称 + 主题关键词
- 返回JSON:
{topic, library, isTopicSpecific} - 零标记执行
fetch-docs.js - 检索文档
- 自动构建context7.com URL
- 处理回退:主题 → 一般 → 错误
- 输出llms.txt内容或错误消息
- 零标记执行
analyze-llms-txt.js - 处理llms.txt
- 分类URL(关键/重要/补充)
- 推荐代理分发(1个代理、3个代理、7个代理、分阶段)
- 返回带有策略的JSON
- 零标记执行
工作流程参考
主题特定搜索 - 最快路径(10-15秒)
一般库搜索 - 全面覆盖(30-60秒)
仓库分析 - 回退策略
参考
context7-patterns.md - URL模式、已知仓库
errors.md - 错误处理、回退策略
advanced.md - 边缘情况、版本控制、多语言
执行原则
- 脚本优先 - 执行脚本而非手动URL构建
- 零标记开销 - 脚本运行无需上下文加载
- 自动回退 - 脚本处理主题 → 一般 → 错误链
- 渐进式披露 - 仅在需要时加载工作流程/参考
- 代理分发 - 脚本推荐并行代理策略
快速入门
主题查询: “如何在shadcn中使用日期选择器?”
node scripts/detect-topic.js "<查询>" # → {topic, library, isTopicSpecific}
node scripts/fetch-docs.js "<查询>" # → 2-3个URL
# 使用WebFetch读取URL
一般查询: “Next.js文档”
node scripts/detect-topic.js "<查询>" # → {isTopicSpecific: false}
node scripts/fetch-docs.js "<查询>" # → 8+个URL
cat llms.txt | node scripts/analyze-llms-txt.js - # → {totalUrls, distribution}
# 按推荐部署代理
环境
脚本加载.env:process.env > .claude/skills/docs-seeker/.env > .claude/skills/.env > .claude/.env
查看.env.example获取配置选项。