用途:这是一个根据网络研究自动生成技能的流程型工具,给定主题后先搜索权威文档,再抓取内容,最后整理为 SKILL.md 技能文件。主要能力体现在配套脚本 fetch_docs.py,包含 search 与 crawl 两个子命令。
主要能力与用法:
- 搜索:运行 python scripts/fetch_docs.py search "{topic} documentation",返回 JSON,包含 URL、标题、评分与内容片段,用于挑选最佳来源。优先官方文档,避免博客、变更日志、营销页与术语表。
- 抓取:示例为 python scripts/fetch_docs.py crawl --url {selected_url} --no-external --select-paths "/docs/." "/guide/." --instructions "Focus on API methods and code examples"。核心参数有 --url(必填)、--instructions(自然语言指引)、--limit(默认 50)、--max-depth(默认 2)。过滤参数有 --no-external、--select-paths、--exclude-paths、--select-domains、--exclude-domains。质量参数有 --extract-depth(basic 或 advanced)、--format(markdown 或 text)、--timeout(10-150 秒,默认 150)。
- 生成技能:从抓取内容创建带 name 与 description 前置字段的 SKILL.md,包含 Quick Start、Core API、Common Patterns 等章节,输出位置为 ~/.claude/skills/{topic-slug}/SKILL.md,并抽取全部代码块;文件应控制在 500 行以内,超出则拆分到 references/。
适用场景:需要围绕某 API 或框架快速沉淀可复用技能文件时。
限制:资料未说明收费、价格、平台与效果;生成质量取决于所选文档是否权威,因此需人工筛选来源并控制抓取范围。