通过脚本发现文档
概述
脚本优先的文档发现,使用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了解配置选项。