┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   18 種資料來源   │ ──→ │   Skill Seekers   │ ──→ │  12+ AI 平台     │
│ Docs/GitHub/PDF  │     │  (Data Layer)     │     │ Claude/LangChain │
│ Video/Wiki/API   │     │  分析+結構化+增強   │     │ Cursor/Gemini    │
└─────────────────┘     └──────────────────┘     └─────────────────┘

# 基本安裝（文件擷取、GitHub 分析、PDF、打包）
pip install skill-seekers

# 含所有 LLM 平台支援
pip install skill-seekers[all-llms]

# 含 MCP Server
pip install skill-seekers[mcp]

# 含影片支援
pip install skill-seekers[video]        # 轉錄文字 + metadata
pip install skill-seekers[video-full]   # + Whisper + 視覺擷取

# 含所有功能
pip install skill-seekers[all]

uv tool install skill-seekers

git clone https://github.com/yusufkaraaslan/Skill_Seekers.git
cd Skill_Seekers
pip install -e ".[all]"

# 使用 Docker Compose
git clone https://github.com/yusufkaraaslan/Skill_Seekers.git
cd Skill_Seekers

# 設定環境變數
cp .env.example .env
# 編輯 .env 填入 API Keys

# 啟動
docker-compose up -d

# 執行指令
docker exec -it skill-seekers skill-seekers create https://react.dev/

docker build -f Dockerfile.mcp -t skill-seekers-mcp .
docker run -p 8765:8765 skill-seekers-mcp

# 驗證安裝
skill-seekers --version
# 輸出：skill-seekers 3.5.1

# 診斷檢查（8 項檢查）
skill-seekers doctor
# 檢查：Python 版本、依賴套件、API Keys、MCP Server、輸出目錄

# 設定精靈
skill-seekers-setup

# 快速測試：從 React 文件建立 Skill
skill-seekers create https://react.dev/ --name react-test

# 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

# 自動設定所有支援的 Agent
./setup_mcp.sh

{
  "mcpServers": {
    "skill-seekers": {
      "command": "python",
      "args": ["-m", "skill_seekers.mcp.server_fastmcp"],
      "env": {
        "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

# 強制重新擷取
rm -rf output/myframework_data/
skill-seekers create https://docs.myframework.com/

# 使用 LOCAL 模式（免 API Key，需 Claude Code Max）
skill-seekers enhance output/react/ --mode LOCAL

# 監控增強進度
skill-seekers enhance-status output/react/ --watch

# 設定速率限制策略
skill-seekers config --rate-limit-strategy wait

# 多 Token 配置（自動輪替）
skill-seekers config --github
# → 互動式精靈引導設定多個 GitHub Token

{
  "name": "myframework",
  "description": "MyFramework 的完整技術文件 Skill",
  "base_url": "https://docs.myframework.com/",
  "selectors": {
    "main_content": "article",
    "title": "h1",
    "code_blocks": "pre code"
  },
  "url_patterns": {
    "include": ["/docs", "/guide", "/api"],
    "exclude": ["/blog", "/about", "/changelog"]
  },
  "categories": {
    "getting_started": ["intro", "quickstart", "installation"],
    "api_reference": ["api", "reference", "methods"],
    "guides": ["guide", "tutorial", "howto"],
    "architecture": ["architecture", "design", "pattern"]
  },
  "rate_limit": 0.5,
  "max_pages": 500
}

# 列出所有預設 config
skill-seekers list-configs

# 使用預設 config
skill-seekers scrape --config configs/react.json

# 互動式建立新 config
skill-seekers scrape --interactive

# 複製預設 config 後修改
cp configs/react.json configs/myframework.json

# security-focus.yaml 範例
name: security-focus
description: "Security-focused review: vulnerabilities, auth, data handling"
version: "1.0"
stages:
  - name: vulnerabilities
    type: custom
    prompt: "Review for OWASP top 10 and common security vulnerabilities..."
  - name: auth-review
    type: custom
    prompt: "Examine authentication and authorisation patterns..."
    uses_history: true

# 套用單一 workflow
skill-seekers create ./my-project --enhance-workflow security-focus

# 串接多個 workflow（依序套用）
skill-seekers create ./my-project \
  --enhance-workflow security-focus \
  --enhance-workflow minimal

# 管理 presets
skill-seekers workflows list                    # 列出全部
skill-seekers workflows show security-focus     # 檢視內容
skill-seekers workflows copy security-focus     # 複製到使用者目錄
skill-seekers workflows add ./my-workflow.yaml  # 安裝自訂 preset
skill-seekers workflows validate security-focus # 驗證結構

{
  "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"
    },
    {
      "type": "pdf",
      "path": "./docs/architecture.pdf"
    }
  ]
}

# 執行統一擷取
skill-seekers unified --config configs/myframework_unified.json

# 快速分析（1-2 分鐘，基本功能）
skill-seekers analyze --directory ./src --quick

# 全面分析含 AI（20-60 分鐘，所有功能）
skill-seekers analyze --directory ./src --comprehensive

# 含 AI 增強
skill-seekers analyze --directory ./src --enhance

# 註冊團隊的私有 config 儲存庫
skill-seekers config add-source \
  --name team \
  --git-url https://github.com/mycompany/skill-configs.git \
  --token-env GITHUB_TOKEN

# 從團隊 repo 取得 config
skill-seekers scrape --config team:internal-api

# 列出所有 config 來源
skill-seekers config list-sources

# 自動偵測來源類型
skill-seekers create https://docs.react.dev/     # → 文件網站
skill-seekers create facebook/react               # → GitHub Repo
skill-seekers create ./my-project                 # → 本地專案
skill-seekers create manual.pdf                   # → PDF
skill-seekers create report.docx                  # → Word
skill-seekers create book.epub                    # → EPUB
skill-seekers create notebook.ipynb               # → Jupyter
skill-seekers create openapi.yaml                 # → OpenAPI
skill-seekers create presentation.pptx            # → PowerPoint
skill-seekers create guide.adoc                   # → AsciiDoc
skill-seekers create page.html                    # → HTML
skill-seekers create feed.rss                     # → RSS

# 指定不同的 AI Agent 進行增強
skill-seekers create https://docs.django.com/ --agent kimi
skill-seekers create https://docs.django.com/ --agent codex
skill-seekers create https://docs.django.com/ --agent-cmd "my-custom-agent run"

# 基本 repo 分析
skill-seekers github --repo facebook/react

# 含認證（提升至 5000 req/hr）
export GITHUB_TOKEN=ghp_your_token_here
skill-seekers github --repo facebook/react

# 自訂擷取內容
skill-seekers github --repo django/django \
    --include-issues \
    --max-issues 100 \
    --include-changelog

from skill_seekers.cli.unified_codebase_analyzer import UnifiedCodebaseAnalyzer

analyzer = UnifiedCodebaseAnalyzer()
result = analyzer.analyze(
    source="https://github.com/facebook/react",
    depth="c3x",
    fetch_github_metadata=True
)

# 存取三個 Stream
print(f"Design patterns: {len(result.code_analysis['c3_1_patterns'])}")
print(f"README: {result.github_docs['readme'][:100]}")
print(f"Stars: {result.github_insights['metadata']['stars']}")

# 從 OpenAPI Spec 建立 Skill
skill-seekers create openapi.yaml

# 從遠端 Swagger URL
skill-seekers create https://api.example.com/swagger.json --name my-api

# 使用預設 config
skill-seekers scrape --config configs/django.json

# 快速擷取（不用 config）
skill-seekers scrape --url https://react.dev --name react

# Async 模式（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

# 掃描 PDF（需 OCR）
skill-seekers pdf --pdf docs/scanned.pdf --name myskill --ocr

# Word 文件
skill-seekers create report.docx

# EPUB 電子書
skill-seekers create book.epub

# 安裝影片支援
pip install skill-seekers[video]
pip install skill-seekers[video-full]  # + Whisper + 視覺擷取

# 自動偵測 GPU 並安裝視覺依賴
skill-seekers video --setup

# YouTube 影片
skill-seekers video --url https://www.youtube.com/watch?v=... --name mytutorial

# YouTube 播放清單
skill-seekers video --playlist https://www.youtube.com/playlist?list=... --name myplaylist

# 本地影片
skill-seekers video --video-file recording.mp4 --name myrecording

# 含視覺擷取（程式碼畫面 OCR）
skill-seekers video --url https://www.youtube.com/watch?v=... --visual

# 含 AI 增強
skill-seekers video --url https://www.youtube.com/watch?v=... --visual --enhance-level 2

# 擷取特定時間段
skill-seekers video --url https://www.youtube.com/watch?v=... --start-time 1:30 --end-time 5:00

# 使用現有 unified config
skill-seekers unified --config configs/react_unified.json

# 自訂 unified config
cat > configs/myapp_unified.json << 'EOF'
{
  "name": "myapp",
  "merge_mode": "rule-based",
  "sources": [
    {
      "type": "documentation",
      "base_url": "https://docs.myapp.com/",
      "max_pages": 200
    },
    {
      "type": "github",
      "repo": "mycompany/myapp",
      "code_analysis_depth": "c3x"
    }
  ]
}
EOF

skill-seekers unified --config configs/myapp_unified.json

output/
├── react_data/              # 擷取的原始資料
│   ├── pages/               # JSON 檔（每頁一個）
│   └── summary.json         # 概覽
│
└── react/                   # Skill 成品
    ├── SKILL.md             # AI 增強的主文件（500+ 行）
    ├── references/          # 分類文件
    │   ├── index.md
    │   ├── getting_started.md
    │   ├── api_reference.md
    │   ├── guides.md
    │   └── ...
    ├── scripts/             # 自訂腳本（可自行新增）
    └── assets/              # 資產檔案（可自行新增）

# 建立並安裝 Skill 到 Claude Code
skill-seekers create facebook/react
skill-seekers install-agent output/react/ --agent claude

# Skill 會安裝到 ~/.claude/skills/

# 設定 API Key
export ANTHROPIC_API_KEY=sk-ant-...

# 打包並上傳
skill-seekers package output/react/ --upload

# 或上傳已有的 .zip
skill-seekers upload output/react.zip

> 請擷取 React 文件並建立 Skill
> 幫我分析 facebook/react 的程式碼模式
> 將 Django Skill 打包並上傳

你現在是一位 React 專家。我已載入 React 的完整 SKILL.md 和 API 參考文件。

請根據以下需求，使用 React 18 最佳實務產生程式碼：

1. 使用 TypeScript
2. 使用 React Hooks（useState, useEffect, useCallback）
3. 遵循 React 官方文件的模式
4. 加入適當的 error boundary

需求：建立一個帶有分頁、搜尋和排序功能的使用者列表元件。

# 安裝到 VS Code / Copilot
skill-seekers install-agent output/react/ --agent copilot

# Skill 會安裝到 .github/skills/

# 將 Skill 內容注入 Copilot 指引
cat output/react/SKILL.md >> .github/copilot-instructions.md

@workspace 根據專案中的 SKILL.md，幫我建立一個符合框架最佳實務的 REST API Controller

# 安裝到指定 Agent
skill-seekers install-agent output/react/ --agent <agent-name>

# 安裝到所有支援的 Agent
skill-seekers install-agent output/react/ --agent all

# 預覽（不實際安裝）
skill-seekers install-agent output/react/ --agent cursor --dry-run

# 常用範例
skill-seekers install-agent output/react/ --agent cursor
# → .cursor/skills/ 下安裝 SKILL.md + references/

skill-seekers install-agent output/react/ --agent copilot
# → .github/skills/ 下安裝

# 也可直接複製 SKILL.md 為 rules 檔案
cp output/react-claude/SKILL.md my-project/.cursorrules
cp output/react-claude/SKILL.md my-project/.windsurfrules
cp output/react-claude/SKILL.md my-project/.clinerules

# 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

# 使用不同 AI Agent 進行增強
skill-seekers create https://docs.django.com/ --agent claude   # 預設
skill-seekers create https://docs.django.com/ --agent kimi
skill-seekers create https://docs.django.com/ --agent codex
skill-seekers create https://docs.django.com/ --agent copilot
skill-seekers create https://docs.django.com/ --agent opencode

# 使用自訂 Agent 指令
skill-seekers create https://docs.django.com/ --agent-cmd "my-custom-agent run"

.codex-plugin/
├── plugin.json          # Codex CLI 外掛資訊定義
├── instructions.md      # 外掛使用指引
└── tools/               # MCP 工具映射

# 建立 Spring Boot Skill
skill-seekers create https://docs.spring.io/spring-boot/reference/ --name spring-boot

# 建立 Vue 3 Skill
skill-seekers create https://vuejs.org/guide/ --name vue3

# 建立 Spring Security Skill（安全導向）
skill-seekers create https://docs.spring.io/spring-security/reference/ \
  --name spring-security \
  --enhance-workflow security-focus

# 打包並安裝到 Claude Code
skill-seekers install-agent output/spring-boot/ --agent claude
skill-seekers install-agent output/vue3/ --agent claude

# 從 OpenAPI Spec 建立 Skill
skill-seekers create ./docs/api-spec.yaml --name internal-api

# 從現有 Spring Boot 專案建立 Skill
skill-seekers create ./backend --name backend-codebase

Prompt 範例：

「根據 Spring Boot 最佳實務，建立一個 RESTful API Controller。
需求：
1. 使用 Clean Architecture（Controller → Service → Repository）
2. 使用 Spring Data JPA
3. 包含分頁和排序
4. 使用 Swagger/OpenAPI 3.0 註解
5. 實作 HATEOAS
6. 包含統一錯誤處理
7. 使用 Jakarta Validation

Entity：User（id, username, email, role, createdAt, updatedAt）

# 從現有程式碼產生 API 文件 Skill
skill-seekers analyze --directory ./src/main/java --comprehensive --enhance

# 整合到 CI/CD（GitHub Actions）
cat > .github/workflows/update-skill.yml << 'EOF'
name: Update AI Skill
on:
  push:
    branches: [main]
    paths: ['src/**', 'docs/**']

jobs:
  update-skill:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'
      - run: pip install skill-seekers
      - run: |
          skill-seekers create ./src --name project-codebase
          skill-seekers package output/project-codebase --target claude
      - uses: actions/upload-artifact@v4
        with:
          name: ai-skill
          path: output/project-codebase-claude.zip
EOF

Prompt 範例：

「根據載入的 Spring Boot Skill 和 pytest Skill，
為以下 Service 類別產生完整的 JUnit 5 測試：

1. 使用 @SpringBootTest 或 @ExtendWith(MockitoExtension.class)
2. Mock 所有外部依賴
3. 涵蓋：正常流程、邊界條件、例外處理
4. 使用 AssertJ 斷言
5. 測試命名：should_[行為]_when_[條件]

目標類別：UserService

# 建立 OWASP Security Skill
skill-seekers create https://owasp.org/www-project-top-ten/ \
  --name owasp-top-10 \
  --enhance-workflow security-focus

# 建立 Spring Security Skill
skill-seekers create https://docs.spring.io/spring-security/reference/ \
  --name spring-security \
  --enhance-workflow security-focus

# 安裝到 IDE
skill-seekers install-agent output/owasp-top-10/ --agent all

# 使用 security-focus workflow 分析現有程式碼
skill-seekers analyze --directory ./src \
  --comprehensive \
  --enhance-workflow security-focus

# C3.4 Config 分析會自動偵測：
# - 硬編碼的密鑰（Hardcoded Secrets）
# - 暴露的認證資訊（Exposed Credentials）
# - 不安全的設定模式

# 建立 Dependency 分析 Skill
skill-seekers github --repo mycompany/myapp \
  --include-issues \
  --include-changelog

# 自動偵測已知漏洞的依賴

# 自動掃描擷取內容中的注入模式
# 使用 security-focus workflow 時自動啟用

skill-seekers create https://docs.example.com/ \
  --enhance-workflow security-focus
# → 自動掃描並標記可疑內容

# 策略一：定期重新建立
# 建議頻率：每週或每次文件更新
skill-seekers create https://docs.react.dev/ --name react

# 策略二：使用 Sync 模組偵測變更
# ChangeDetector 會比對上次擷取的內容

# 策略三：CI/CD 自動化
# 在 GitHub Actions 中設定排程

# .github/workflows/skill-update.yml
name: Weekly Skill Update
on:
  schedule:
    - cron: '0 2 * * 1'  # 每週一凌晨 2 點
  workflow_dispatch:

jobs:
  update:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'
      - run: pip install skill-seekers
      - run: |
          skill-seekers create ./src --name codebase
          skill-seekers install-agent output/codebase/ --agent all
      - uses: stefanzweifel/git-auto-commit-action@v5
        with:
          commit_message: "chore: update AI skills"

# Checkpoint / Resume 機制
# 長時間擷取會自動儲存進度（預設：60 秒）

# 列出可恢復的任務
skill-seekers resume --list

# 恢復中斷的任務
skill-seekers resume github_react_20260117_143022

# 自動清理舊任務（預設：7 天）

# 從遠端 Config Repo 同步
skill-seekers sync-config --repo mycompany/skill-configs

# 推送本地 Config 到遠端
skill-seekers push-config --repo mycompany/skill-configs --name react

# 衝突偵測（自動比對本地 vs 遠端）
skill-seekers sync-config --detect-conflicts

# 發布 Skill 到 Marketplace
skill-seekers marketplace publish output/react/ \
  --name "React Best Practices" \
  --tags "react,frontend,hooks"

# 搜尋 Marketplace
skill-seekers marketplace search "spring boot"

# 安裝社群 Skill
skill-seekers marketplace install react-best-practices

# 啟用非同步模式（推薦）
skill-seekers scrape --config configs/react.json --async --workers 8

# 跳過擷取，僅重新建置
skill-seekers create ./src --skip-scrape

# 使用 LOCAL 增強（免費，使用 Claude Code Max）
skill-seekers enhance output/react/ --mode LOCAL

# 監控增強狀態
skill-seekers enhance-status output/react/ --watch

# 診斷檢查
skill-seekers doctor

# 檢查項目：
# ✅ Python 版本
# ✅ 依賴套件
# ✅ API Keys 設定
# ✅ MCP Server 狀態
# ✅ 輸出目錄權限
# ✅ 磁碟空間
# ✅ 網路連線
# ✅ GPU 偵測（影片功能）

# 升級到最新版
pip install --upgrade skill-seekers

# 升級含所有功能
pip install --upgrade skill-seekers[all]

# 查看變更日誌
# https://github.com/yusufkaraaslan/Skill_Seekers/blob/development/CHANGELOG.md

# 查看目前版本
skill-seekers --version

# v3.4 → v3.5 Config 相容性
# 舊版單來源 config 完全向下相容
# 新版 unified config 為新增功能

# 驗證 config 格式
skill-seekers workflows validate my-workflow

# 備份現有 config
cp -r ~/.config/skill-seekers/ ~/.config/skill-seekers.bak/

✅ 好的 Prompt 模式：

「根據載入的 [框架名稱] Skill，
 使用 [具體模式/最佳實務]，
 實作 [具體需求]。
 需遵循：[約束條件]」

❌ 避免的 Prompt 模式：

「幫我寫一個程式」（太模糊）
「用 React 做個頁面」（缺乏具體需求）

{
  "name": "spring-boot",
  "description": "Spring Boot 完整技術文件",
  "base_url": "https://docs.spring.io/spring-boot/reference/",
  "selectors": {
    "main_content": "article",
    "title": "h1",
    "code_blocks": "pre code"
  },
  "url_patterns": {
    "include": ["/reference"],
    "exclude": ["/api"]
  },
  "categories": {
    "getting_started": ["getting-started", "quickstart"],
    "core": ["core", "features", "boot-features"],
    "data": ["data", "sql", "nosql"],
    "web": ["web", "servlet", "reactive"],
    "security": ["security", "authentication"],
    "testing": ["testing", "test"],
    "deployment": ["deployment", "production", "actuator"]
  },
  "rate_limit": 0.5,
  "max_pages": 500
}

{
  "name": "enterprise-app",
  "merge_mode": "rule-based",
  "sources": [
    {
      "type": "documentation",
      "base_url": "https://docs.myapp.com/",
      "max_pages": 300
    },
    {
      "type": "github",
      "repo": "mycompany/myapp",
      "code_analysis_depth": "c3x",
      "include_issues": true,
      "max_issues": 50
    },
    {
      "type": "pdf",
      "path": "./docs/architecture-guide.pdf"
    }
  ]
}