English | 简体中文
⚠️ 机器翻译声明
本文档由 AI 自动翻译生成。虽然我们努力确保翻译质量,但可能存在不准确或不自然的表述。
欢迎通过 GitHub Issue #260 帮助改进翻译!您的反馈对我们非常宝贵。
🧠 AI 系统的数据层。 Skill Seekers 将任何文档、GitHub 仓库或 PDF 转换为结构化知识资产——可在几分钟内为 AI 技能(Claude、Gemini、OpenAI)、RAG 流水线(LangChain、LlamaIndex、Pinecone)和 AI 编程助手(Cursor、Windsurf、Cline)提供支持。
🌐 访问 SkillSeekersWeb.com - 浏览 24+ 个预设配置,分享您的配置,访问完整文档!
📋 查看开发路线图和任务 - 10 个类别的 134 个任务,选择任意一个参与贡献!
Skill Seekers 是通用预处理层,位于原始文档和所有使用它的 AI 系统之间。无论您是在构建 Claude 技能、LangChain RAG 流水线,还是 Cursor .cursorrules 文件——数据准备工作完全相同。只需执行一次,即可导出到所有目标平台。
# 一条命令 → 结构化知识资产
skill-seekers create https://docs.react.dev/
# 或: skill-seekers create facebook/react
# 或: skill-seekers create ./my-project
# 导出到任意 AI 系统
skill-seekers package output/react --target claude # → Claude AI 技能 (ZIP)
skill-seekers package output/react --target langchain # → LangChain Documents
skill-seekers package output/react --target llama-index # → LlamaIndex TextNodes
skill-seekers package output/react --target cursor # → .cursorrules
| 输出 | 目标 | 应用场景 |
|---|---|---|
| Claude 技能 (ZIP + YAML) | --target claude | Claude Code、Claude API |
| Gemini 技能 (tar.gz) | --target gemini | Google Gemini |
| OpenAI / Custom GPT (ZIP) | --target openai | GPT-4o、自定义助手 |
| LangChain Documents | --target langchain | QA 链、智能体、检索器 |
| LlamaIndex TextNodes | --target llama-index | 查询引擎、对话引擎 |
| Haystack Documents | --target haystack | 企业级 RAG 流水线 |
| Pinecone 就绪 (Markdown) | --target markdown | 向量上传 |
| ChromaDB / FAISS / Qdrant | --format chroma/faiss/qdrant | 本地向量数据库 |
Cursor .cursorrules | --target claude → 复制 | Cursor IDE AI 上下文 |
| Windsurf / Cline / Continue | --target claude → 复制 | VS Code、IntelliJ、Vim |
pip install skill-seekers
# 从任意来源构建 AI 技能
skill-seekers create https://docs.django.com/ # 文档网站
skill-seekers create django/django # GitHub 仓库
skill-seekers create ./my-codebase # 本地项目
skill-seekers create manual.pdf # PDF 文件
# 根据用途导出
skill-seekers package output/django --target claude # Claude AI 技能
skill-seekers package output/django --target langchain # LangChain RAG
skill-seekers package output/django --target cursor # Cursor IDE 上下文
完整示例:
Skill Seekers 是 AI 系统的数据层,将文档网站、GitHub 仓库和 PDF 文件转换为适用于所有 AI 目标的结构化知识资产:
| 使用场景 | 获得的内容 | 示例 |
|---|---|---|
| AI 技能 | 完整的 SKILL.md + 参考文件 | Claude Code、Gemini、GPT |
| RAG 流水线 | 带丰富元数据的分块文档 | LangChain、LlamaIndex、Haystack |
| 向量数据库 | 预格式化的待上传数据 | Pinecone、Chroma、Weaviate、FAISS |
| AI 编程助手 | IDE AI 自动读取的上下文文件 | Cursor、Windsurf、Cline、Continue.dev |
Skill Seekers 通过以下步骤代替数天的手动预处理工作:
security-focus、architecture-comprehensive 或自定义 YAML 预设Documents、LlamaIndex TextNodes、Haystack Documents.cursorrules / .windsurfrules / .clinerules--target 标志选择平台| 平台 | 格式 | 上传 | 增强 | API Key | 自定义端点 |
|---|---|---|---|---|---|
| Claude AI | ZIP + YAML | ✅ 自动 | ✅ 是 | ANTHROPIC_API_KEY | ANTHROPIC_BASE_URL |
| Google Gemini | tar.gz | ✅ 自动 | ✅ 是 | GOOGLE_API_KEY | - |
| OpenAI ChatGPT | ZIP + Vector Store | ✅ 自动 | ✅ 是 | OPENAI_API_KEY | - |
| 通用 Markdown | ZIP | ❌ 手动 | ❌ 否 | - | - |
# Claude(默认 - 无需更改!)
skill-seekers package output/react/
skill-seekers upload react.zip
# Google Gemini
pip install skill-seekers[gemini]
skill-seekers package output/react/ --target gemini
skill-seekers upload react-gemini.tar.gz --target gemini
# OpenAI ChatGPT
pip install skill-seekers[openai]
skill-seekers package output/react/ --target openai
skill-seekers upload react-openai.zip --target openai
# 通用 Markdown(通用导出)
skill-seekers package output/react/ --target markdown
Skill Seekers 支持任意 Claude 兼容的 API 端点:
# 选项 1:官方 Anthropic API(默认)
export ANTHROPIC_API_KEY=sk-ant-...
# 选项 2:GLM-4.7 Claude 兼容 API
export ANTHROPIC_API_KEY=your-glm-47-api-key
export ANTHROPIC_BASE_URL=https://glm-4-7-endpoint.com/v1
# 所有 AI 增强功能将使用配置的端点
skill-seekers enhance output/react/
skill-seekers analyze --directory . --enhance
注意:设置 ANTHROPIC_BASE_URL 允许您使用任意 Claude 兼容的 API 端点,例如 GLM-4.7(智谱 AI)或其他兼容服务。
安装:
# 安装 Gemini 支持
pip install skill-seekers[gemini]
# 安装 OpenAI 支持
pip install skill-seekers[openai]
# 安装所有 LLM 平台
pip install skill-seekers[all-llms]
✅ LangChain Documents - 直接导出为 Document 格式,包含 page_content + 元数据
✅ LlamaIndex TextNodes - 导出为带唯一 ID + 嵌入的 TextNode 格式
✅ Pinecone 就绪格式 - 针对向量数据库上传进行优化
快速导出:
# LangChain Documents(JSON)
skill-seekers package output/django --target langchain
# → output/django-langchain.json
# LlamaIndex TextNodes(JSON)
skill-seekers package output/django --target llama-index
# → output/django-llama-index.json
# Markdown(通用)
skill-seekers package output/django --target markdown
# → output/django-markdown/SKILL.md + references/
完整 RAG 流水线指南: RAG 流水线文档
将任意框架文档转换为 4+ 种 AI 助手的专家编程上下文:
✅ Cursor IDE - 为 AI 驱动的代码建议生成 .cursorrules
✅ Windsurf - 使用 .windsurfrules 自定义 Windsurf AI 助手上下文
✅ Cline(VS Code) - VS Code 智能体的系统提示 + MCP
✅ Continue.dev - 与 IDE 无关的 AI 上下文服务器
快速导出(适用于 AI 编程工具):
# 适用于任意 AI 编程助手(Cursor、Windsurf、Cline、Continue.dev)
skill-seekers scrape --config configs/django.json
skill-seekers package output/django --target claude
# 复制到项目(以 Cursor 为例)
cp output/django-claude/SKILL.md my-project/.cursorrules
# 或用于 Windsurf
cp output/django-claude/SKILL.md my-project/.windsurf/rules/django.md
# 或用于 Cline
cp output/django-claude/SKILL.md my-project/.clinerules
集成中心: 所有 AI 系统集成
三流说明:
from skill_seekers.cli.unified_codebase_analyzer import UnifiedCodebaseAnalyzer
# 使用三流分析 GitHub 仓库
analyzer = UnifiedCodebaseAnalyzer()
result = analyzer.analyze(
source="https://github.com/facebook/react",
depth="c3x", # 或 "basic" 快速分析
fetch_github_metadata=True
)
print(f"设计模式: {len(result.code_analysis['c3_1_patterns'])}")
print(f"Stars: {result.github_insights['metadata']['stars']}")
完整文档:三流实现总结
~/.config/skill-seekers/config.json(权限 600)prompt、wait、switch、fail--non-interactive 标志用于自动化快速设置:
# 一次性配置(5 分钟)
skill-seekers config --github
# 为私有仓库使用特定配置文件
skill-seekers github --repo mycompany/private-repo --profile work
# CI/CD 模式(快速失败,无提示)
skill-seekers github --repo owner/repo --non-interactive
将 skill-seekers 自身作为 Claude Code 技能生成:
./scripts/bootstrap_skill.sh
cp -r output/skill-seekers ~/.claude/skills/
C3.4:配置模式提取(含 AI 增强)
C3.3:AI 增强操作指南
使用方法:
# 快速分析(1–2 分钟,仅基础功能)
skill-seekers analyze --directory tests/ --quick
# 全面分析(含 AI,20–60 分钟)
skill-seekers analyze --directory tests/ --comprehensive
# 含 AI 增强
skill-seekers analyze --directory tests/ --enhance
完整文档: docs/HOW_TO_GUIDES.md
可重用的 YAML 定义增强流水线,控制 AI 如何将原始文档转换为精心打磨的技能。
default、minimal、security-focus、architecture-comprehensive、api-documentation~/.config/skill-seekers/workflows/# 应用单个工作流
skill-seekers create ./my-project --enhance-workflow security-focus
# 链式多个工作流(按顺序应用)
skill-seekers create ./my-project \
--enhance-workflow security-focus \
--enhance-workflow minimal
# 管理预设
skill-seekers workflows list # 列出所有(内置 + 用户)
skill-seekers workflows show security-focus # 显示 YAML 内容
skill-seekers workflows copy security-focus # 复制到用户目录以便编辑
skill-seekers workflows add ./my-workflow.yaml # 安装自定义预设
skill-seekers workflows remove my-workflow # 删除用户预设
skill-seekers workflows validate security-focus # 验证预设结构
# 同时复制多个
skill-seekers workflows copy security-focus minimal api-documentation
# 同时添加多个文件
skill-seekers workflows add ./wf-a.yaml ./wf-b.yaml
# 同时删除多个
skill-seekers workflows remove my-wf-a my-wf-b
YAML 预设格式:
name: security-focus
description: "安全重点审查:漏洞、认证、数据处理"
version: "1.0"
stages:
- name: vulnerabilities
type: custom
prompt: "审查 OWASP Top 10 和常见安全漏洞..."
- name: auth-review
type: custom
prompt: "检查认证和授权模式..."
uses_history: true
--async 标志)# 基础安装(文档抓取、GitHub 分析、PDF、打包)
pip install skill-seekers
# 包含所有 LLM 平台支持
pip install skill-seekers[all-llms]
# 包含 MCP 服务器
pip install skill-seekers[mcp]
# 全部功能
pip install skill-seekers[all]
需要帮助选择? 运行设置向导:
skill-seekers-setup
| 安装命令 | 功能 |
|---|---|
pip install skill-seekers | 抓取、GitHub 分析、PDF、所有平台 |
pip install skill-seekers[gemini] | + Google Gemini 支持 |
pip install skill-seekers[openai] | + OpenAI ChatGPT 支持 |
pip install skill-seekers[all-llms] | + 所有 LLM 平台 |
pip install skill-seekers[mcp] | + MCP 服务器 |
pip install skill-seekers[all] | 全部功能 |
从配置到上传技能的最快方式——全自动化:
# 从官方配置安装 React 技能(自动上传到 Claude)
skill-seekers install --config react
# 从本地配置文件安装
skill-seekers install --config configs/custom.json
# 安装但不上传(仅打包)
skill-seekers install --config django --no-upload
# 预览工作流而不执行
skill-seekers install --config react --dry-run
执行阶段:
📥 阶段 1:获取配置(如果提供配置名称) 📖 阶段 2:抓取文档 ✨ 阶段 3:AI 增强 📦 阶段 4:打包技能 ☁️ 阶段 5:上传到 Claude(可选,需要 API Key)
Skill Seekers 支持 4 个 LLM 平台和 5 种技能模式,功能完全对等。
平台: Claude AI、Google Gemini、OpenAI ChatGPT、通用 Markdown 技能模式: 文档、GitHub、PDF、统一多源、本地仓库
完整信息请查看 完整功能矩阵。
| 功能 | Claude | Gemini | OpenAI | Markdown |
|---|---|---|---|---|
| 格式 | ZIP + YAML | tar.gz | ZIP + Vector | ZIP |
| 上传 | ✅ API | ✅ API | ✅ API | ❌ 手动 |
| 增强 | ✅ Sonnet 4 | ✅ 2.0 Flash | ✅ GPT-4o | ❌ 无 |
| 所有技能模式 | ✅ | ✅ | ✅ | ✅ |
# 抓取文档网站
skill-seekers scrape --config configs/react.json
# 快速抓取(无需配置)
skill-seekers scrape --url https://react.dev --name react
# 异步模式(快 3 倍)
skill-seekers scrape --config configs/godot.json --async --workers 8
# 基础 PDF 提取
skill-seekers pdf --pdf docs/manual.pdf --name myskill
# 高级功能
skill-seekers pdf --pdf docs/manual.pdf --name myskill \
--extract-tables \ # 提取表格
--parallel \ # 快速并行处理
--workers 8 # 使用 8 个 CPU 核心
# 扫描 PDF(需要: pip install pytesseract Pillow)
skill-seekers pdf --pdf docs/scanned.pdf --name myskill --ocr
# 基础仓库抓取
skill-seekers github --repo facebook/react
# 配置认证(更高速率限制)
export GITHUB_TOKEN=ghp_your_token_here
skill-seekers github --repo facebook/react
# 自定义包含内容
skill-seekers github --repo django/django \
--include-issues \ # 提取 GitHub Issues
--max-issues 100 \ # 限制 issue 数量
--include-changelog # 提取 CHANGELOG.md
将文档 + GitHub + PDF 合并为一个带冲突检测的统一技能:
# 使用现有统一配置
skill-seekers unified --config configs/react_unified.json
# 或创建统一配置
cat > configs/myframework_unified.json << 'EOF'
{
"name": "myframework",
"merge_mode": "rule-based",
"sources": [
{
"type": "documentation",
"base_url": "https://docs.myframework.com/",
"max_pages": 200
},
{
"type": "github",
"repo": "owner/myframework",
"code_analysis_depth": "surface"
}
]
}
EOF
skill-seekers unified --config configs/myframework_unified.json
冲突检测自动发现:
完整指南: 参见 docs/UNIFIED_SCRAPING.md。
使用私有 Git 仓库在团队间共享自定义配置:
# 使用 MCP 工具注册团队私有仓库
add_config_source(
name="team",
git_url="https://github.com/mycompany/skill-configs.git",
token_env="GITHUB_TOKEN"
)
# 从团队仓库获取配置
fetch_config(source="team", config_name="internal-api")
支持的平台:
GITHUB_TOKEN)、GitLab(GITLAB_TOKEN)、Gitea(GITEA_TOKEN)、Bitbucket(BITBUCKET_TOKEN)完整指南: 参见 docs/GIT_CONFIG_SOURCES.md。
.zip 文件开始前,请确保您具备:
首次使用? → 从这里开始:防弹快速入门指南 🎯
技能打包完成后,需要将其上传到 Claude:
# 设置 API Key(一次性)
export ANTHROPIC_API_KEY=sk-ant-...
# 打包并自动上传
skill-seekers package output/react/ --upload
# 或上传已有的 .zip
skill-seekers upload output/react.zip
# 打包技能
skill-seekers package output/react/
# → 创建 output/react.zip
# 然后手动上传:
# - 访问 https://claude.ai/skills
# - 点击"上传技能"
# - 选择 output/react.zip
在 Claude Code 中,直接询问: "打包并上传 React 技能"
Skill Seekers 可自动将技能安装到 10+ 个 AI 编程代理。
# 安装到特定代理
skill-seekers install-agent output/react/ --agent cursor
# 一次性安装到所有代理
skill-seekers install-agent output/react/ --agent all
# 预览而不安装
skill-seekers install-agent output/react/ --agent cursor --dry-run
| 代理 | 路径 | 类型 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | 全局 |
| Cursor | .cursor/skills/ | 项目 |
| VS Code / Copilot | .github/skills/ | 项目 |
| Amp | ~/.amp/skills/ | 全局 |
| Goose | ~/.config/goose/skills/ | 全局 |
| OpenCode | ~/.opencode/skills/ | 全局 |
| Windsurf | ~/.windsurf/skills/ | 全局 |
Skill Seekers 提供 MCP 服务器,可在 Claude Code、Cursor、Windsurf、VS Code + Cline 或 IntelliJ IDEA 中使用。
# stdio 模式(Claude Code、VS Code + Cline)
python -m skill_seekers.mcp.server_fastmcp
# HTTP 模式(Cursor、Windsurf、IntelliJ)
python -m skill_seekers.mcp.server_fastmcp --transport http --port 8765
# 一次性自动配置所有代理
./setup_mcp.sh
所有 26 个工具:
list_configs、generate_config、validate_config、estimate_pages、scrape_docs、package_skill、upload_skill、enhance_skill、install_skillscrape_github、scrape_pdf、unified_scrape、merge_sources、detect_conflicts、add_config_source、fetch_config、list_config_sources、remove_config_source、split_configexport_to_chroma、export_to_weaviate、export_to_faiss、export_to_qdrantcloud_upload、cloud_download、cloud_list完整指南: docs/MCP_SETUP.md
# 列出所有预设
skill-seekers list-configs
| 类别 | 预设 |
|---|---|
| Web 框架 | react、vue、angular、svelte、nextjs |
| Python | django、flask、fastapi、sqlalchemy、pytest |
| 游戏开发 | godot、pygame、unity |
| 工具与 DevOps | docker、kubernetes、terraform、ansible |
| 统一(文档 + GitHub) | react-unified、vue-unified、nextjs-unified 等 |
# 选项 1:交互式
skill-seekers scrape --interactive
# 选项 2:复制并编辑预设
cp configs/react.json configs/myframework.json
nano configs/myframework.json
skill-seekers scrape --config configs/myframework.json
{
"name": "myframework",
"description": "何时使用此技能",
"base_url": "https://docs.myframework.com/",
"selectors": {
"main_content": "article",
"title": "h1",
"code_blocks": "pre code"
},
"url_patterns": {
"include": ["/docs", "/guide"],
"exclude": ["/blog", "/about"]
},
"categories": {
"getting_started": ["intro", "quickstart"],
"api": ["api", "reference"]
},
"rate_limit": 0.5,
"max_pages": 500
}
工具按以下顺序搜索:
./configs/(当前目录)~/.config/skill-seekers/configs/(用户配置目录)output/ ├── godot_data/ # 抓取的原始数据 │ ├── pages/ # JSON 文件(每页一个) │ └── summary.json # 概览 │ └── godot/ # 技能文件 ├── SKILL.md # 含真实示例的增强版 ├── references/ # 分类文档 │ ├── index.md │ ├── getting_started.md │ ├── scripting.md │ └── ... ├── scripts/ # 空(可添加自己的脚本) └── assets/ # 空(可添加自己的资源)
main_content 选择器article、main、div[role="main"]# 强制重新抓取
rm -rf output/myframework_data/
skill-seekers scrape --config configs/myframework.json
编辑配置中的 categories 部分,使用更好的关键词。
# 删除旧数据并重新抓取
rm -rf output/godot_data/
skill-seekers scrape --config configs/godot.json
# 检查 API Key 是否设置
echo $ANTHROPIC_API_KEY
# 尝试 LOCAL 模式(使用 Claude Code Max,无需 API Key)
skill-seekers enhance output/react/ --mode LOCAL
# 监控后台增强状态
skill-seekers enhance-status output/react/ --watch
# 设置 GitHub Token(5000 次/小时 vs 匿名 60 次/小时)
export GITHUB_TOKEN=ghp_your_token_here
# 或配置多个配置文件
skill-seekers config --github
| 任务 | 时间 | 备注 |
|---|---|---|
| 抓取(同步) | 15–45 分钟 | 仅首次,基于线程 |
| 抓取(异步) | 5–15 分钟 | --async 标志快 2–3 倍 |
| 构建 | 1–3 分钟 | 从缓存快速重建 |
| 重建 | <1 分钟 | 使用 --skip-scrape |
| 增强(LOCAL) | 30–60 秒 | 使用 Claude Code Max |
| 增强(API) | 20–40 秒 | 需要 API Key |
| 打包 | 5–10 秒 | 最终 .zip 创建 |
MIT 许可证 - 详见 LICENSE 文件
祝您构建技能愉快! 🚀