# Skill Seekers [English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Português](README.pt-BR.md) | Türkçe | [العربية](README.ar.md) | [हिन्दी](README.hi.md) | [Русский](README.ru.md) > ⚠️ **Makine çevirisi bildirimi** > > Bu belge yapay zeka tarafından otomatik olarak çevrilmiştir. Kaliteyi sağlamak için çaba göstermemize rağmen, hatalı ifadeler bulunabilir. > > Çeviriyi iyileştirmemize yardımcı olmak için [GitHub Issue #260](https://github.com/yusufkaraaslan/Skill_Seekers/issues/260) üzerinden geri bildirimlerinizi paylaşabilirsiniz! [](https://github.com/yusufkaraaslan/Skill_Seekers/releases) [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) [](https://modelcontextprotocol.io) [](tests/) [](https://github.com/users/yusufkaraaslan/projects/2) [](https://pypi.org/project/skill-seekers/) [](https://pypi.org/project/skill-seekers/) [](https://pypi.org/project/skill-seekers/) [](https://skillseekersweb.com/) [](https://x.com/_yUSyUS_) [](https://github.com/yusufkaraaslan/Skill_Seekers) **🧠 Yapay zeka sistemleri için veri katmanı.** Skill Seekers; dokümantasyon sitelerini, GitHub depolarını, PDF'leri, videoları, Jupyter not defterlerini, vikileri ve 17'den fazla kaynak türünü yapılandırılmış bilgi varlıklarına dönüştürür — AI Yetenekleri (Claude, Gemini, OpenAI), RAG hatları (LangChain, LlamaIndex, Pinecone) ve AI kodlama asistanları (Cursor, Windsurf, Cline) için saatler değil dakikalar içinde hazır hale getirir. > 🌐 **[SkillSeekersWeb.com'u Ziyaret Edin](https://skillseekersweb.com/)** - 24'ten fazla hazır yapılandırmayı inceleyin, kendi yapılandırmalarınızı paylaşın ve tam dokümantasyona erişin! > 📋 **[Geliştirme Yol Haritası ve Görevleri Görüntüleyin](https://github.com/users/yusufkaraaslan/projects/2)** - 10 kategoride 134 görev, istediğinizi seçip katkıda bulunun! ## 🌐 Ekosistem Skill Seekers çoklu depo projesidır. Her şeyin bulunduğu yerler: | Depo | Açıklama | Bağlantılar | |------|----------|-------------| | **[Skill_Seekers](https://github.com/yusufkaraaslan/Skill_Seekers)** | Ana CLI ve MCP sunucusu (bu depo) | [PyPI](https://pypi.org/project/skill-seekers/) | | **[skillseekersweb](https://github.com/yusufkaraaslan/skillseekersweb)** | Web sitesi ve belgeler | [Site](https://skillseekersweb.com/) | | **[skill-seekers-configs](https://github.com/yusufkaraaslan/skill-seekers-configs)** | Topluluk yapılandırma deposu | | | **[skill-seekers-action](https://github.com/yusufkaraaslan/skill-seekers-action)** | GitHub Action CI/CD | | | **[skill-seekers-plugin](https://github.com/yusufkaraaslan/skill-seekers-plugin)** | Claude Code eklentisi | | | **[homebrew-skill-seekers](https://github.com/yusufkaraaslan/homebrew-skill-seekers)** | macOS için Homebrew tap | | > **Katkıda bulunmak ister misiniz?** Web sitesi ve yapılandırma depoları yeni katkıda bulunanlar için harika başlangıç noktalarıdır! ## 🧠 Yapay Zeka Sistemleri İçin Veri Katmanı **Skill Seekers, evrensel bir ön işleme katmanıdır** ve ham dokümantasyon ile onu tüketen tüm yapay zeka sistemleri arasında yer alır. İster Claude yetenekleri, ister LangChain RAG hattı, ister Cursor `.cursorrules` dosyası oluşturuyor olun — veri hazırlık süreci aynıdır. Bir kez yaparsınız, tüm hedef platformlara dışa aktarırsınız. ```bash # Tek komut → yapılandırılmış bilgi varlığı skill-seekers create https://docs.react.dev/ # veya: skill-seekers create facebook/react # veya: skill-seekers create ./my-project # Herhangi bir AI sistemine dışa aktar skill-seekers package output/react --target claude # → Claude AI Yeteneği (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 ``` ### Oluşturulan Çıktılar | Çıktı | Hedef | Kullanım Alanı | |-------|-------|---------------| | **Claude Yeteneği** (ZIP + YAML) | `--target claude` | Claude Code, Claude API | | **Gemini Yeteneği** (tar.gz) | `--target gemini` | Google Gemini | | **OpenAI / Custom GPT** (ZIP) | `--target openai` | GPT-4o, özel asistanlar | | **LangChain Documents** | `--target langchain` | QA zincirleri, ajanlar, alıcılar | | **LlamaIndex TextNodes** | `--target llama-index` | Sorgu motorları, sohbet motorları | | **Haystack Documents** | `--target haystack` | Kurumsal RAG hatları | | **Pinecone-hazır** (Markdown) | `--target markdown` | Vektör yükleme | | **ChromaDB / FAISS / Qdrant** | `--format chroma/faiss/qdrant` | Yerel vektör veritabanları | | **Cursor** `.cursorrules` | `--target claude` → kopyala | Cursor IDE AI bağlamı | | **Windsurf / Cline / Continue** | `--target claude` → kopyala | VS Code, IntelliJ, Vim | ### Neden Önemli - ⚡ **%99 daha hızlı** — Günlerce süren manuel veri hazırlığı → 15–45 dakika - 🎯 **AI Yetenek kalitesi** — Örnekler, desenler ve kılavuzlar içeren 500+ satırlık SKILL.md dosyaları - 📊 **RAG-hazır parçalar** — Kod bloklarını koruyan ve bağlamı sürdüren akıllı parçalama - 🎬 **Videolar** — YouTube ve yerel videolardan kod, altyazı ve yapılandırılmış bilgi çıkarma - 🔄 **Çoklu kaynak** — 17 kaynak türünü (dokümantasyon, GitHub, PDF, video, not defterleri, vikiler ve daha fazlası) tek bir bilgi varlığında birleştirme - 🌐 **Bir hazırlık, her hedef** — Yeniden tarama yapmadan aynı varlığı 16 platforma dışa aktarma - ✅ **Savaşta test edilmiş** — 2.540+ test, 24+ çerçeve ön ayarı, üretime hazır ## 🚀 Hızlı Başlangıç (3 Komut) ```bash # 1. Kurulum pip install skill-seekers # 2. Herhangi bir kaynaktan yetenek oluştur skill-seekers create https://docs.django.com/ # 3. AI platformunuz için paketle skill-seekers package output/django --target claude ``` **İşte bu kadar!** Artık kullanıma hazır `output/django-claude.zip` dosyanız var. ### Diğer Kaynaklar (17 Desteklenen) ```bash # GitHub deposu skill-seekers create facebook/react # Yerel proje skill-seekers create ./my-project # PDF belgesi skill-seekers create manual.pdf # Word belgesi skill-seekers create report.docx # EPUB e-kitap skill-seekers create book.epub # Jupyter Not Defteri skill-seekers create notebook.ipynb # OpenAPI spec skill-seekers create openapi.yaml # PowerPoint sunumu skill-seekers create presentation.pptx # AsciiDoc belgesi skill-seekers create guide.adoc # Yerel HTML dosyası skill-seekers create page.html # RSS/Atom beslemesi skill-seekers create feed.rss # Man sayfası skill-seekers create curl.1 # Video (YouTube, Vimeo veya yerel dosya — skill-seekers[video] gerektirir) skill-seekers video --url https://www.youtube.com/watch?v=... --name mytutorial # İlk kez mi? GPU destekli görsel bağımlılıkları otomatik kur: skill-seekers video --setup # Confluence vikisi skill-seekers confluence --space TEAM --name wiki # Notion sayfaları skill-seekers notion --database-id ... --name docs # Slack/Discord sohbet dışa aktarımı skill-seekers chat --export-dir ./slack-export --name team-chat ``` ### Her Yere Dışa Aktar ```bash # Birden fazla platform için paketle for platform in claude gemini openai langchain; do skill-seekers package output/django --target $platform done ``` ## Skill Seekers Nedir? Skill Seekers, **yapay zeka sistemleri için veri katmanıdır**. 17 kaynak türünü — dokümantasyon siteleri, GitHub depoları, PDF'ler, videolar, Jupyter Not Defterleri, Word/EPUB/AsciiDoc belgeleri, OpenAPI spesifikasyonları, PowerPoint sunumları, RSS beslemeleri, man sayfaları, Confluence vikileri, Notion sayfaları, Slack/Discord dışa aktarımları ve daha fazlasını — her AI hedefi için yapılandırılmış bilgi varlıklarına dönüştürür: | Kullanım Alanı | Elde Ettiğiniz | Örnekler | |----------------|---------------|----------| | **AI Yetenekleri** | Kapsamlı SKILL.md + referanslar | Claude Code, Gemini, GPT | | **RAG Hatları** | Zengin meta verili parçalanmış belgeler | LangChain, LlamaIndex, Haystack | | **Vektör Veritabanları** | Yüklemeye hazır önceden biçimlendirilmiş veri | Pinecone, Chroma, Weaviate, FAISS | | **AI Kodlama Asistanları** | IDE yapay zekasının otomatik okuduğu bağlam dosyaları | Cursor, Windsurf, Cline, Continue.dev | Skill Seekers, günlerce süren manuel ön işleme çalışması yerine şunları yapar: 1. **Toplama** — Dokümantasyon, GitHub depoları, yerel kod tabanları, PDF'ler, videolar, Jupyter not defterleri, vikiler ve 17'den fazla kaynak türü 2. **Analiz** — Derin AST ayrıştırma, desen tespiti, API çıkarma 3. **Yapılandırma** — Meta verili kategorize edilmiş referans dosyaları 4. **Zenginleştirme** — AI destekli SKILL.md oluşturma (Claude, Gemini veya yerel) 5. **Dışa Aktarma** — Tek bir varlıktan 16 platforma özel format ## 📚 Dokümantasyon | Yapmak istediğim... | Bunu oku | |---------------------|----------| | **Hızlıca başlamak** | [Hızlı Başlangıç](docs/getting-started/02-quick-start.md) - İlk yetenek için 3 komut | | **Kavramları anlamak** | [Temel Kavramlar](docs/user-guide/01-core-concepts.md) - Nasıl çalışır | | **Kaynak taramak** | [Tarama Kılavuzu](docs/user-guide/02-scraping.md) - Tüm kaynak türleri | | **Yetenekleri geliştirmek** | [Zenginleştirme Kılavuzu](docs/user-guide/03-enhancement.md) - AI zenginleştirme | | **Yetenekleri dışa aktarmak** | [Paketleme Kılavuzu](docs/user-guide/04-packaging.md) - Platform dışa aktarımı | | **Komutları aramak** | [CLI Referansı](docs/reference/CLI_REFERENCE.md) - Tüm 20 komut | | **Yapılandırma yapmak** | [Yapılandırma Formatı](docs/reference/CONFIG_FORMAT.md) - JSON spesifikasyonu | | **Sorunları çözmek** | [Sorun Giderme](docs/user-guide/06-troubleshooting.md) - Yaygın sorunlar | **Tam dokümantasyon:** [docs/README.md](docs/README.md) ## Neden Kullanmalısınız? ### AI Yetenek Oluşturucuları İçin (Claude, Gemini, OpenAI) - 🎯 **Üretime hazır yetenekler** — Kod örnekleri, desenler ve kılavuzlar içeren 500+ satırlık SKILL.md dosyaları - 🔄 **Zenginleştirme iş akışları** — `security-focus`, `architecture-comprehensive` veya özel YAML ön ayarları uygulayın - 🎮 **Her alan** — Oyun motorları (Godot, Unity), çerçeveler (React, Django), dahili araçlar - 🔧 **Ekipler** — Dahili dokümantasyon + kodu tek bir doğruluk kaynağında birleştirin - 📚 **Kalite** — Örnekler, hızlı referans ve navigasyon kılavuzu ile AI zenginleştirilmiş ### RAG Geliştiricileri ve AI Mühendisleri İçin - 🤖 **RAG-hazır veri** — Önceden parçalanmış LangChain `Documents`, LlamaIndex `TextNodes`, Haystack `Documents` - 🚀 **%99 daha hızlı** — Günlerce süren ön işleme → 15–45 dakika - 📊 **Akıllı meta veri** — Kategoriler, kaynaklar, türler → daha iyi alma doğruluğu - 🔄 **Çoklu kaynak** — Tek bir hatta dokümantasyon + GitHub + PDF + video birleştirme - 🌐 **Platform bağımsız** — Yeniden tarama yapmadan herhangi bir vektör veritabanına veya çerçeveye dışa aktarma ### AI Kodlama Asistanı Kullanıcıları İçin - 💻 **Cursor / Windsurf / Cline** — Otomatik `.cursorrules` / `.windsurfrules` / `.clinerules` oluşturma - 🎯 **Kalıcı bağlam** — Tekrarlanan yönlendirme olmadan AI çerçevelerinizi "bilir" - 📚 **Her zaman güncel** — Dokümantasyon değiştiğinde bağlamı dakikalar içinde güncelleyin ## Temel Özellikler ### 🌐 Dokümantasyon Tarama - ✅ **llms.txt Desteği** - LLM-hazır dokümantasyon dosyalarını otomatik algılar ve kullanır (10 kat daha hızlı) - ✅ **Evrensel Tarayıcı** - HERHANGİ bir dokümantasyon sitesiyle çalışır - ✅ **Akıllı Kategorileme** - İçeriği konuya göre otomatik düzenler - ✅ **Kod Dili Algılama** - Python, JavaScript, C++, GDScript vb. tanır - ✅ **24+ Hazır Ön Ayar** - Godot, React, Vue, Django, FastAPI ve daha fazlası ### 📄 PDF Desteği - ✅ **Temel PDF Çıkarma** - PDF dosyalarından metin, kod ve resim çıkarma - ✅ **Taranmış PDF'ler İçin OCR** - Taranmış belgelerden metin çıkarma - ✅ **Parola Korumalı PDF'ler** - Şifrelenmiş PDF'leri işleme - ✅ **Tablo Çıkarma** - PDF'lerden karmaşık tabloları çıkarma - ✅ **Paralel İşleme** - Büyük PDF'ler için 3 kat daha hızlı - ✅ **Akıllı Önbellekleme** - Tekrar çalıştırmalarda %50 daha hızlı ### 🎬 Video Çıkarma - ✅ **YouTube ve Yerel Videolar** - Videolardan altyazı, kod ve yapılandırılmış bilgi çıkarma - ✅ **Görsel Kare Analizi** - Kod editörleri, terminaller, slaytlar ve diyagramlardan OCR çıkarma - ✅ **GPU Otomatik Algılama** - Doğru PyTorch derlemesini otomatik yükleme (CUDA/ROCm/MPS/CPU) - ✅ **AI Zenginleştirme** - İki aşamalı: OCR yapıtlarını temizleme + gösterişli SKILL.md oluşturma - ✅ **Zaman Kırpma** - `--start-time` ve `--end-time` ile belirli bölümleri çıkarma - ✅ **Oynatma Listesi Desteği** - YouTube oynatma listesindeki tüm videoları toplu işleme - ✅ **Vision API Yedekleme** - Düşük güvenilirlikli OCR kareleri için Claude Vision kullanma ### 🐙 GitHub Deposu Analizi - ✅ **Derin Kod Analizi** - Python, JavaScript, TypeScript, Java, C++, Go için AST ayrıştırma - ✅ **API Çıkarma** - Parametreler ve türlerle fonksiyonlar, sınıflar, yöntemler - ✅ **Depo Meta Verileri** - README, dosya ağacı, dil dağılımı, yıldız/çatal sayıları - ✅ **GitHub Issues ve PR'ler** - Etiketler ve kilometre taşlarıyla açık/kapalı sorunları getirme - ✅ **CHANGELOG ve Sürümler** - Sürüm geçmişini otomatik çıkarma - ✅ **Çakışma Tespiti** - Belgelenmiş API'ler ile gerçek kod uygulamasını karşılaştırma - ✅ **MCP Entegrasyonu** - Doğal dil: "GitHub deposu facebook/react'i tara" ### 🔄 Birleşik Çoklu Kaynak Tarama - ✅ **Birden Fazla Kaynağı Birleştirme** - Tek bir yetenekte dokümantasyon + GitHub + PDF karıştırma - ✅ **Çakışma Tespiti** - Dokümantasyon ile kod arasındaki tutarsızlıkları otomatik bulma - ✅ **Akıllı Birleştirme** - Kural tabanlı veya AI destekli çakışma çözümleme - ✅ **Şeffaf Raporlama** - ⚠️ uyarılarıyla yan yana karşılaştırma - ✅ **Dokümantasyon Boşluk Analizi** - Güncelliğini yitirmiş dokümantasyon ve belgelenmemiş özellikleri belirleme - ✅ **Tek Doğruluk Kaynağı** - Hem niyet (dokümantasyon) hem de gerçeği (kod) gösteren tek yetenek - ✅ **Geriye Dönük Uyumluluk** - Eski tek kaynaklı yapılandırmalar çalışmaya devam eder ### 🤖 Çoklu LLM Platform Desteği - ✅ **12 LLM Platformu** - Claude AI, Google Gemini, OpenAI ChatGPT, MiniMax AI, Genel Markdown, OpenCode, Kimi, DeepSeek, Qwen, OpenRouter, Together AI, Fireworks AI - ✅ **Evrensel Tarama** - Aynı dokümantasyon tüm platformlar için çalışır - ✅ **Platforma Özel Paketleme** - Her LLM için optimize edilmiş formatlar - ✅ **Tek Komutla Dışa Aktarma** - `--target` bayrağı ile platform seçimi - ✅ **İsteğe Bağlı Bağımlılıklar** - Yalnızca ihtiyacınız olanı yükleyin - ✅ **%100 Geriye Dönük Uyumluluk** - Mevcut Claude iş akışları değişmez | Platform | Format | Yükleme | Zenginleştirme | API Key | Özel Uç Nokta | |----------|--------|---------|----------------|---------|---------------| | **Claude AI** | ZIP + YAML | ✅ Otomatik | ✅ Evet | ANTHROPIC_API_KEY | ANTHROPIC_BASE_URL | | **Google Gemini** | tar.gz | ✅ Otomatik | ✅ Evet | GOOGLE_API_KEY | - | | **OpenAI ChatGPT** | ZIP + Vector Store | ✅ Otomatik | ✅ Evet | OPENAI_API_KEY | - | | **Genel Markdown** | ZIP | ❌ Manuel | ❌ Hayır | - | - | ```bash # Claude (varsayılan - değişiklik gerekmez!) 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 # Genel Markdown (evrensel dışa aktarma) skill-seekers package output/react/ --target markdown ```

🔧 Claude Uyumlu API'ler İçin Ortam Değişkenleri (ör. GLM-4.7)

Skill Seekers, herhangi bir Claude uyumlu API uç noktasını destekler: ```bash # Seçenek 1: Resmi Anthropic API (varsayılan) export ANTHROPIC_API_KEY=sk-ant-... # Seçenek 2: GLM-4.7 Claude uyumlu API export ANTHROPIC_API_KEY=your-glm-47-api-key export ANTHROPIC_BASE_URL=https://glm-4-7-endpoint.com/v1 # Tüm AI zenginleştirme özellikleri yapılandırılmış uç noktayı kullanacaktır skill-seekers enhance output/react/ skill-seekers analyze --directory . --enhance ``` **Not**: `ANTHROPIC_BASE_URL` ayarlamak, GLM-4.7 veya diğer uyumlu hizmetler gibi herhangi bir Claude uyumlu API uç noktasını kullanmanıza olanak tanır.

**Kurulum:** ```bash # Gemini desteği ile kur pip install skill-seekers[gemini] # OpenAI desteği ile kur pip install skill-seekers[openai] # Tüm LLM platformlarını kur pip install skill-seekers[all-llms] ``` ### 🔗 RAG Çerçeve Entegrasyonları - ✅ **LangChain Documents** - `page_content` + meta veri ile doğrudan `Document` formatına dışa aktarma - İçin uygun: QA zincirleri, alıcılar, vektör depoları, ajanlar - Örnek: [LangChain RAG Hattı](examples/langchain-rag-pipeline/) - Kılavuz: [LangChain Entegrasyonu](docs/integrations/LANGCHAIN.md) - ✅ **LlamaIndex TextNodes** - Benzersiz ID'ler + gömüler ile `TextNode` formatına dışa aktarma - İçin uygun: Sorgu motorları, sohbet motorları, depolama bağlamı - Örnek: [LlamaIndex Sorgu Motoru](examples/llama-index-query-engine/) - Kılavuz: [LlamaIndex Entegrasyonu](docs/integrations/LLAMA_INDEX.md) - ✅ **Pinecone-Hazır Format** - Vektör veritabanı yüklemesi için optimize edilmiş - İçin uygun: Üretim vektör araması, anlamsal arama, hibrit arama - Örnek: [Pinecone Yükleme](examples/pinecone-upsert/) - Kılavuz: [Pinecone Entegrasyonu](docs/integrations/PINECONE.md) **Hızlı Dışa Aktarma:** ```bash # 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 (Evrensel) skill-seekers package output/django --target markdown # → output/django-markdown/SKILL.md + references/ ``` **Tam RAG Hattı Kılavuzu:** [RAG Hatları Dokümantasyonu](docs/integrations/RAG_PIPELINES.md) --- ### 🧠 AI Kodlama Asistanı Entegrasyonları Herhangi bir çerçeve dokümantasyonunu 4+ AI asistanı için uzman kodlama bağlamına dönüştürün: - ✅ **Cursor IDE** - AI destekli kod önerileri için `.cursorrules` oluşturma - İçin uygun: Çerçeveye özel kod üretimi, tutarlı desenler - Birlikte çalışır: Cursor IDE (VS Code çatalı) - Kılavuz: [Cursor Entegrasyonu](docs/integrations/CURSOR.md) - Örnek: [Cursor React Yeteneği](examples/cursor-react-skill/) - ✅ **Windsurf** - `.windsurfrules` ile Windsurf AI asistanı bağlamını özelleştirme - İçin uygun: IDE-yerel AI yardımı, akış tabanlı kodlama - Birlikte çalışır: Codeium tarafından Windsurf IDE - Kılavuz: [Windsurf Entegrasyonu](docs/integrations/WINDSURF.md) - Örnek: [Windsurf FastAPI Bağlamı](examples/windsurf-fastapi-context/) - ✅ **Cline (VS Code)** - VS Code ajanı için sistem yönergeleri + MCP - İçin uygun: VS Code'da ajanlı kod üretimi - Birlikte çalışır: VS Code için Cline eklentisi - Kılavuz: [Cline Entegrasyonu](docs/integrations/CLINE.md) - Örnek: [Cline Django Asistanı](examples/cline-django-assistant/) - ✅ **Continue.dev** - IDE bağımsız AI için bağlam sunucuları - İçin uygun: Çoklu IDE ortamları (VS Code, JetBrains, Vim), özel LLM sağlayıcıları - Birlikte çalışır: Continue.dev eklentisi bulunan herhangi bir IDE - Kılavuz: [Continue Entegrasyonu](docs/integrations/CONTINUE_DEV.md) - Örnek: [Continue Evrensel Bağlam](examples/continue-dev-universal/) **AI Kodlama Araçları İçin Hızlı Dışa Aktarma:** ```bash # Herhangi bir AI kodlama asistanı için (Cursor, Windsurf, Cline, Continue.dev) skill-seekers scrape --config configs/django.json skill-seekers package output/django --target claude # veya --target markdown # Projenize kopyalayın (Cursor örneği) cp output/django-claude/SKILL.md my-project/.cursorrules # Veya Windsurf için cp output/django-claude/SKILL.md my-project/.windsurf/rules/django.md # Veya Cline için cp output/django-claude/SKILL.md my-project/.clinerules # Veya Continue.dev için (HTTP sunucusu) python examples/continue-dev-universal/context_server.py # ~/.continue/config.json içinde yapılandırın ``` **Entegrasyon Merkezi:** [Tüm AI Sistemi Entegrasyonları](docs/integrations/INTEGRATIONS.md) --- ### 🌊 Üç Akışlı GitHub Mimarisi - ✅ **Üçlü Akış Analizi** - GitHub depolarını Kod, Dokümantasyon ve İçgörü akışlarına ayırma - ✅ **Birleşik Kod Tabanı Analizcisi** - GitHub URL'leri VE yerel yollarla çalışır - ✅ **C3.x Analiz Derinliği** - 'basic' (1-2 dk) veya 'c3x' (20-60 dk) analiz seçimi - ✅ **Geliştirilmiş Yönlendirici Oluşturma** - GitHub meta verileri, README hızlı başlangıç, yaygın sorunlar - ✅ **Issue Entegrasyonu** - GitHub Issues'dan en yaygın sorunlar ve çözümler - ✅ **Akıllı Yönlendirme Anahtar Kelimeleri** - Daha iyi konu tespiti için GitHub etiketleri 2 kat ağırlıklandırılmış **Üç Akış Açıklaması:** - **Akış 1: Kod** - Derin C3.x analizi (desenler, örnekler, kılavuzlar, yapılandırmalar, mimari) - **Akış 2: Dokümantasyon** - Depo dokümantasyonu (README, CONTRIBUTING, docs/*.md) - **Akış 3: İçgörüler** - Topluluk bilgisi (issues, etiketler, yıldızlar, çatallar) ```python from skill_seekers.cli.unified_codebase_analyzer import UnifiedCodebaseAnalyzer # GitHub deposunu üç akışla analiz et analyzer = UnifiedCodebaseAnalyzer() result = analyzer.analyze( source="https://github.com/facebook/react", depth="c3x", # veya hızlı analiz için "basic" fetch_github_metadata=True ) # Kod akışına eriş (C3.x analizi) print(f"Tasarım desenleri: {len(result.code_analysis['c3_1_patterns'])}") print(f"Test örnekleri: {result.code_analysis['c3_2_examples_count']}") # Dokümantasyon akışına eriş (depo dokümantasyonu) print(f"README: {result.github_docs['readme'][:100]}") # İçgörü akışına eriş (GitHub meta verileri) print(f"Yıldızlar: {result.github_insights['metadata']['stars']}") print(f"Yaygın sorunlar: {len(result.github_insights['common_problems'])}") ``` **Tam dokümantasyonu görüntüle**: [Üç Akışlı Uygulama Özeti](docs/IMPLEMENTATION_SUMMARY_THREE_STREAM.md) ### 🔐 Akıllı İstek Hızı Limiti Yönetimi ve Yapılandırma - ✅ **Çoklu Token Yapılandırma Sistemi** - Birden fazla GitHub hesabını yönetme (kişisel, iş, açık kaynak) - `~/.config/skill-seekers/config.json` konumunda güvenli yapılandırma depolama (600 izinleri) - Profil başına hız limiti stratejileri: `prompt`, `wait`, `switch`, `fail` - Profil başına yapılandırılabilir zaman aşımı (varsayılan: 30 dk, süresiz beklemeyi önler) - Akıllı yedekleme zinciri: CLI argümanı → Ortam değişkeni → Yapılandırma dosyası → İstem - Claude, Gemini, OpenAI için API anahtarı yönetimi - ✅ **Etkileşimli Yapılandırma Sihirbazı** - Kolay kurulum için güzel terminal arayüzü - Token oluşturma için tarayıcı entegrasyonu (otomatik olarak GitHub vb. açar) - Token doğrulama ve bağlantı testi - Renk kodlamalı görsel durum göstergesi - ✅ **Akıllı Hız Limiti İşleyicisi** - Artık süresiz bekleme yok! - Hız limitleri hakkında önceden uyarı (60/saat vs 5000/saat) - GitHub API yanıtlarından gerçek zamanlı algılama - İlerleme ile canlı geri sayım zamanlayıcıları - Hız sınırına ulaşıldığında otomatik profil değiştirme - Dört strateji: prompt (sor), wait (geri sayım), switch (başkasını dene), fail (iptal et) - ✅ **Devam Etme Yeteneği** - Kesilen işlere devam etme - Yapılandırılabilir aralıklarla otomatik ilerleme kaydetme (varsayılan: 60 sn) - İlerleme ayrıntılarıyla tüm devam ettirilebilir işleri listeleme - Eski işleri otomatik temizleme (varsayılan: 7 gün) - ✅ **CI/CD Desteği** - Otomasyon için etkileşimsiz mod - `--non-interactive` bayrağı istemler olmadan hızlı başarısızlık - `--profile` bayrağı ile belirli GitHub hesabı seçimi - Hat günlükleri için açık hata mesajları **Hızlı Kurulum:** ```bash # Tek seferlik yapılandırma (5 dakika) skill-seekers config --github # Özel depolar için belirli profil kullanma skill-seekers github --repo mycompany/private-repo --profile work # CI/CD modu (hızlı başarısızlık, istem yok) skill-seekers github --repo owner/repo --non-interactive # Kesilen işe devam etme skill-seekers resume --list skill-seekers resume github_react_20260117_143022 ``` **Hız Limiti Stratejileri Açıklaması:** - **prompt** (varsayılan) - Hız sınırına ulaşıldığında ne yapılacağını sor (bekle, değiştir, token kur, iptal) - **wait** - Geri sayım zamanlayıcısıyla otomatik bekleme (zaman aşımına uyar) - **switch** - Sonraki kullanılabilir profili otomatik deneme (çoklu hesap kurulumları için) - **fail** - Açık hata ile hemen başarısız olma (CI/CD için mükemmel) ### 🎯 Bootstrap Yeteneği - Kendi Kendini Barındırma Skill-seekers'ı Claude Code içinde kullanmak üzere bir Claude Code yeteneği olarak oluşturma: ```bash # Yeteneği oluştur ./scripts/bootstrap_skill.sh # Claude Code'a yükle cp -r output/skill-seekers ~/.claude/skills/ ``` **Elde ettikleriniz:** - ✅ **Tam yetenek dokümantasyonu** - Tüm CLI komutları ve kullanım desenleri - ✅ **CLI komut referansı** - Her araç ve seçenekleri belgelenmiş - ✅ **Hızlı başlangıç örnekleri** - Yaygın iş akışları ve en iyi uygulamalar - ✅ **Otomatik oluşturulan API dokümantasyonu** - Kod analizi, desenler ve örnekler ### 🔐 Özel Yapılandırma Depoları - ✅ **Git Tabanlı Yapılandırma Kaynakları** - Özel/ekip git depolarından yapılandırma getirme - ✅ **Çoklu Kaynak Yönetimi** - Sınırsız GitHub, GitLab, Bitbucket deposu kaydetme - ✅ **Ekip İşbirliği** - 3-5 kişilik ekipler arasında özel yapılandırmaları paylaşma - ✅ **Kurumsal Destek** - Öncelik tabanlı çözümleme ile 500+ geliştiriciye ölçekleme - ✅ **Güvenli Kimlik Doğrulama** - Ortam değişkeni token'ları (GITHUB_TOKEN, GITLAB_TOKEN) - ✅ **Akıllı Önbellekleme** - Bir kez klonla, güncellemeleri otomatik çek - ✅ **Çevrimdışı Mod** - Çevrimdışıyken önbelleğe alınmış yapılandırmalarla çalışma ### 🤖 Kod Tabanı Analizi (C3.x) **C3.4: AI Zenginleştirmeli Yapılandırma Deseni Çıkarma** - ✅ **9 Yapılandırma Formatı** - JSON, YAML, TOML, ENV, INI, Python, JavaScript, Dockerfile, Docker Compose - ✅ **7 Desen Türü** - Veritabanı, API, günlükleme, önbellek, e-posta, kimlik doğrulama, sunucu yapılandırmaları - ✅ **AI Zenginleştirme** - İsteğe bağlı çift modlu AI analizi (API + LOCAL) - Her yapılandırmanın ne yaptığını açıklar - En iyi uygulamaları ve iyileştirmeleri önerir - **Güvenlik analizi** - Sabit kodlanmış sırları, açığa çıkmış kimlik bilgilerini bulur - ✅ **Otomatik Belgeleme** - Tüm yapılandırmaların JSON + Markdown dokümantasyonunu oluşturur - ✅ **MCP Entegrasyonu** - Zenginleştirme destekli `extract_config_patterns` aracı **C3.3: AI Zenginleştirilmiş Nasıl Yapılır Kılavuzları** - ✅ **Kapsamlı AI Zenginleştirme** - Temel kılavuzları profesyonel eğitimlere dönüştürme - ✅ **5 Otomatik İyileştirme** - Adım açıklamaları, sorun giderme, ön koşullar, sonraki adımlar, kullanım senaryoları - ✅ **Çift Mod Desteği** - API modu (Claude API) veya LOCAL modu (Claude Code CLI) - ✅ **LOCAL Moduyla Ücretsiz** - Claude Code Max planınızı kullanarak ÜCRETSİZ zenginleştirme - ✅ **Kalite Dönüşümü** - 75 satırlık şablonlar → 500+ satırlık kapsamlı kılavuzlar **Kullanım:** ```bash # Hızlı analiz (1-2 dk, yalnızca temel özellikler) skill-seekers analyze --directory tests/ --quick # AI ile kapsamlı analiz (20-60 dk, tüm özellikler) skill-seekers analyze --directory tests/ --comprehensive # AI zenginleştirme ile skill-seekers analyze --directory tests/ --enhance ``` **Tam Dokümantasyon:** [docs/HOW_TO_GUIDES.md](docs/HOW_TO_GUIDES.md#ai-enhancement-new) ### 🔄 Zenginleştirme İş Akışı Ön Ayarları AI'nın ham dokümantasyonunuzu cilalı bir yeteneğe nasıl dönüştüreceğini kontrol eden yeniden kullanılabilir YAML tanımlı zenginleştirme hatları. - ✅ **5 Yerleşik Ön Ayar** — `default`, `minimal`, `security-focus`, `architecture-comprehensive`, `api-documentation` - ✅ **Kullanıcı Tanımlı Ön Ayarlar** — `~/.config/skill-seekers/workflows/` dizinine özel iş akışları ekleme - ✅ **Çoklu İş Akışları** — Tek komutta iki veya daha fazla iş akışını zincirleme - ✅ **Tam CLI Yönetimi** — İş akışlarını listeleme, inceleme, kopyalama, ekleme, kaldırma ve doğrulama ```bash # Tek iş akışı uygula skill-seekers create ./my-project --enhance-workflow security-focus # Birden fazla iş akışını zincirle (sırayla uygulanır) skill-seekers create ./my-project \ --enhance-workflow security-focus \ --enhance-workflow minimal # Ön ayarları yönet skill-seekers workflows list # Tümünü listele (yerleşik + kullanıcı) skill-seekers workflows show security-focus # YAML içeriğini yazdır skill-seekers workflows copy security-focus # Düzenleme için kullanıcı dizinine kopyala skill-seekers workflows add ./my-workflow.yaml # Özel ön ayar yükle skill-seekers workflows remove my-workflow # Kullanıcı ön ayarını kaldır skill-seekers workflows validate security-focus # Ön ayar yapısını doğrula # Aynı anda birden fazla kopyala skill-seekers workflows copy security-focus minimal api-documentation # Aynı anda birden fazla dosya ekle skill-seekers workflows add ./wf-a.yaml ./wf-b.yaml # Aynı anda birden fazla kaldır skill-seekers workflows remove my-wf-a my-wf-b ``` **YAML ön ayar formatı:** ```yaml name: security-focus description: "Güvenlik odaklı inceleme: güvenlik açıkları, kimlik doğrulama, veri işleme" version: "1.0" stages: - name: vulnerabilities type: custom prompt: "OWASP ilk 10 ve yaygın güvenlik açıklarını inceleyin..." - name: auth-review type: custom prompt: "Kimlik doğrulama ve yetkilendirme desenlerini inceleyin..." uses_history: true ``` ### ⚡ Performans ve Ölçek - ✅ **Asenkron Mod** - async/await ile 2-3 kat daha hızlı tarama (`--async` bayrağını kullanın) - ✅ **Büyük Dokümantasyon Desteği** - Akıllı bölme ile 10K-40K+ sayfalık dokümantasyonu işleme - ✅ **Yönlendirici/Hub Yetenekleri** - Özelleştirilmiş alt yeteneklere akıllı yönlendirme - ✅ **Paralel Tarama** - Birden fazla yeteneği aynı anda işleme - ✅ **Kontrol Noktası/Devam Etme** - Uzun taramalarda hiçbir zaman ilerleme kaybetmeyin - ✅ **Önbellekleme Sistemi** - Bir kez tara, anında yeniden oluştur ### ✅ Kalite Güvencesi - ✅ **Tam Test Kapsamı** - 2.540+ test ile kapsamlı kapsam --- ## 📦 Kurulum ```bash # Temel kurulum (dokümantasyon tarama, GitHub analizi, PDF, paketleme) pip install skill-seekers # Tüm LLM platform desteği ile pip install skill-seekers[all-llms] # MCP sunucusu ile pip install skill-seekers[mcp] # Her şey pip install skill-seekers[all] ``` **Seçim konusunda yardım mı lazım?** Kurulum sihirbazını çalıştırın: ```bash skill-seekers-setup ``` ### Kurulum Seçenekleri | Kurulum | Özellikler | |---------|-----------| | `pip install skill-seekers` | Tarama, GitHub analizi, PDF, tüm platformlar | | `pip install skill-seekers[gemini]` | + Google Gemini desteği | | `pip install skill-seekers[openai]` | + OpenAI ChatGPT desteği | | `pip install skill-seekers[all-llms]` | + Tüm LLM platformları | | `pip install skill-seekers[mcp]` | + Claude Code, Cursor vb. için MCP sunucusu | | `pip install skill-seekers[video]` | + YouTube/Vimeo altyazı ve meta veri çıkarma | | `pip install skill-seekers[video-full]` | + Whisper transkripsiyonu ve görsel kare çıkarma | | `pip install skill-seekers[jupyter]` | + Jupyter Not Defteri desteği | | `pip install skill-seekers[pptx]` | + PowerPoint desteği | | `pip install skill-seekers[confluence]` | + Confluence viki desteği | | `pip install skill-seekers[notion]` | + Notion sayfaları desteği | | `pip install skill-seekers[rss]` | + RSS/Atom besleme desteği | | `pip install skill-seekers[chat]` | + Slack/Discord sohbet dışa aktarım desteği | | `pip install skill-seekers[asciidoc]` | + AsciiDoc belge desteği | | `pip install skill-seekers[all]` | Her şey etkin | > **Video görsel bağımlılıkları (GPU destekli):** `skill-seekers[video-full]` kurulumundan sonra > `skill-seekers video --setup` komutunu çalıştırarak GPU'nuzu otomatik algılayın ve doğru PyTorch > sürümünü + easyocr'ı yükleyin. Bu, görsel çıkarma bağımlılıklarını yüklemenin önerilen yoludur. --- ## 🚀 Tek Komutla Kurulum İş Akışı **Yapılandırmadan yüklenen yeteneğe en hızlı yol — tam otomasyon:** ```bash # Resmi yapılandırmalardan React yeteneğini kur (Claude'a otomatik yükle) skill-seekers install --config react # Yerel yapılandırma dosyasından kur skill-seekers install --config configs/custom.json # Yüklemeden kur (yalnızca paketle) skill-seekers install --config django --no-upload # Çalıştırmadan iş akışını önizle skill-seekers install --config react --dry-run ``` **Süre:** Toplamda 20-45 dakika | **Kalite:** Üretime hazır (9/10) | **Maliyet:** Ücretsiz **Yürütülen aşamalar:** ``` 📥 AŞAMA 1: Yapılandırmayı Getir (yapılandırma adı verilmişse) 📖 AŞAMA 2: Dokümantasyonu Tara ✨ AŞAMA 3: AI Zenginleştirme (ZORUNLU - atlama seçeneği yok) 📦 AŞAMA 4: Yeteneği Paketle ☁️ AŞAMA 5: Claude'a Yükle (isteğe bağlı, API anahtarı gerektirir) ``` **Gereksinimler:** - ANTHROPIC_API_KEY ortam değişkeni (otomatik yükleme için) - Claude Code Max planı (yerel AI zenginleştirme için) --- ## 📊 Özellik Matrisi Skill Seekers **12 LLM platformu**, **17 kaynak türü** ve tüm hedeflerde tam özellik eşitliğini destekler. **Platformlar:** Claude AI, Google Gemini, OpenAI ChatGPT, MiniMax AI, Genel Markdown, OpenCode, Kimi, DeepSeek, Qwen, OpenRouter, Together AI, Fireworks AI **Kaynak Türleri:** Dokümantasyon siteleri, GitHub depoları, PDF'ler, Word (.docx), EPUB, Video, Yerel kod tabanları, Jupyter Not Defterleri, Yerel HTML, OpenAPI/Swagger, AsciiDoc, PowerPoint (.pptx), RSS/Atom beslemeleri, Man sayfaları, Confluence vikileri, Notion sayfaları, Slack/Discord sohbet dışa aktarımları Ayrıntılı platform ve özellik desteği için [Tam Özellik Matrisi](docs/FEATURE_MATRIX.md) bölümüne bakın. ### Hızlı Platform Karşılaştırması | Özellik | Claude | Gemini | OpenAI | Markdown | |---------|--------|--------|--------|----------| | Format | ZIP + YAML | tar.gz | ZIP + Vector | ZIP | | Yükleme | ✅ API | ✅ API | ✅ API | ❌ Manuel | | Zenginleştirme | ✅ Sonnet 4 | ✅ 2.0 Flash | ✅ GPT-4o | ❌ Yok | | Tüm Yetenek Modları | ✅ | ✅ | ✅ | ✅ | --- ## Kullanım Örnekleri ### Dokümantasyon Tarama ```bash # Dokümantasyon sitesini tara skill-seekers scrape --config configs/react.json # Yapılandırma olmadan hızlı tarama skill-seekers scrape --url https://react.dev --name react # Asenkron mod ile (3 kat daha hızlı) skill-seekers scrape --config configs/godot.json --async --workers 8 ``` ### PDF Çıkarma ```bash # Temel PDF çıkarma skill-seekers pdf --pdf docs/manual.pdf --name myskill # Gelişmiş özellikler skill-seekers pdf --pdf docs/manual.pdf --name myskill \ --extract-tables \ # Tabloları çıkar --parallel \ # Hızlı paralel işleme --workers 8 # 8 CPU çekirdeği kullan # Taranmış PDF'ler (gerekli: pip install pytesseract Pillow) skill-seekers pdf --pdf docs/scanned.pdf --name myskill --ocr ``` ### Video Çıkarma ```bash # Video desteğini kur pip install skill-seekers[video] # Altyazılar + meta veri pip install skill-seekers[video-full] # + Whisper transkripsiyonu + görsel kare çıkarma # GPU'yu otomatik algıla ve görsel bağımlılıkları kur (PyTorch + easyocr) skill-seekers video --setup # YouTube videosundan çıkar skill-seekers video --url https://www.youtube.com/watch?v=dQw4w9WgXcQ --name mytutorial # YouTube oynatma listesinden çıkar skill-seekers video --playlist https://www.youtube.com/playlist?list=... --name myplaylist # Yerel video dosyasından çıkar skill-seekers video --video-file recording.mp4 --name myrecording # Görsel kare analizi ile çıkar (video-full bağımlılıkları gerektirir) skill-seekers video --url https://www.youtube.com/watch?v=... --name mytutorial --visual # AI zenginleştirme ile (OCR'ı temizle + cilalı SKILL.md oluştur) skill-seekers video --url https://www.youtube.com/watch?v=... --visual --enhance-level 2 # Videonun belirli bir bölümünü kırp (saniye, DD:SS, SS:DD:SS destekler) skill-seekers video --url https://www.youtube.com/watch?v=... --start-time 1:30 --end-time 5:00 # Düşük güvenilirlikli OCR kareleri için Vision API kullan (ANTHROPIC_API_KEY gerektirir) skill-seekers video --url https://www.youtube.com/watch?v=... --visual --vision-ocr # Daha önce çıkarılmış verilerden yeteneği yeniden oluştur (indirmeyi atla) skill-seekers video --from-json output/mytutorial/video_data/extracted_data.json --name mytutorial ``` > **Tam kılavuz:** Eksiksiz CLI referansı, görsel hat ayrıntıları, AI zenginleştirme seçenekleri > ve sorun giderme için [docs/VIDEO_GUIDE.md](docs/VIDEO_GUIDE.md) bölümüne bakın. ### GitHub Deposu Analizi ```bash # Temel depo tarama skill-seekers github --repo facebook/react # Kimlik doğrulama ile (daha yüksek hız limitleri) export GITHUB_TOKEN=ghp_your_token_here skill-seekers github --repo facebook/react # Nelerin dahil edileceğini özelleştir skill-seekers github --repo django/django \ --include-issues \ # GitHub Issues çıkar --max-issues 100 \ # Issue sayısını sınırla --include-changelog # CHANGELOG.md çıkar ``` ### Birleşik Çoklu Kaynak Tarama **Çakışma tespiti ile dokümantasyon + GitHub + PDF'yi tek bir birleşik yeteneğe dönüştürme:** ```bash # Mevcut birleşik yapılandırmaları kullan skill-seekers unified --config configs/react_unified.json skill-seekers unified --config configs/django_unified.json # Veya birleşik yapılandırma oluştur 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 ``` **Çakışma Tespiti otomatik olarak şunları bulur:** - 🔴 **Kodda eksik** (yüksek): Belgelenmiş ama uygulanmamış - 🟡 **Dokümantasyonda eksik** (orta): Uygulanmış ama belgelenmemiş - ⚠️ **İmza uyuşmazlığı**: Farklı parametreler/türler - ℹ️ **Açıklama uyuşmazlığı**: Farklı açıklamalar **Tam Kılavuz:** Eksiksiz dokümantasyon için [docs/UNIFIED_SCRAPING.md](docs/UNIFIED_SCRAPING.md) bölümüne bakın. ### Özel Yapılandırma Depoları **Özel git depoları kullanarak ekipler arasında özel yapılandırmaları paylaşma:** ```bash # Seçenek 1: MCP araçlarını kullanma (önerilen) # Ekibinizin özel deposunu kaydedin add_config_source( name="team", git_url="https://github.com/mycompany/skill-configs.git", token_env="GITHUB_TOKEN" ) # Ekip deposundan yapılandırma getir fetch_config(source="team", config_name="internal-api") ``` **Desteklenen Platformlar:** - GitHub (`GITHUB_TOKEN`), GitLab (`GITLAB_TOKEN`), Gitea (`GITEA_TOKEN`), Bitbucket (`BITBUCKET_TOKEN`) **Tam Kılavuz:** Eksiksiz dokümantasyon için [docs/GIT_CONFIG_SOURCES.md](docs/GIT_CONFIG_SOURCES.md) bölümüne bakın. ## Nasıl Çalışır ```mermaid graph LR A[Dokümantasyon Sitesi] --> B[Skill Seekers] B --> C[Tarayıcı] B --> D[AI Zenginleştirme] B --> E[Paketleyici] C --> F[Düzenlenmiş Referanslar] D --> F F --> E E --> G[Claude Yeteneği .zip] G --> H[Claude AI'ya Yükle] ``` 0. **llms.txt Algılama** - Önce llms-full.txt, llms.txt, llms-small.txt kontrol eder 1. **Tarama**: Dokümantasyondaki tüm sayfaları çıkarır 2. **Kategorileme**: İçeriği konulara göre düzenler (API, kılavuzlar, eğitimler vb.) 3. **Zenginleştirme**: AI dokümantasyonu analiz eder ve örneklerle kapsamlı SKILL.md oluşturur 4. **Paketleme**: Her şeyi Claude'a hazır `.zip` dosyasına paketler ## 📋 Ön Koşullar **Başlamadan önce şunlara sahip olduğunuzdan emin olun:** 1. **Python 3.10 veya üstü** - [İndir](https://www.python.org/downloads/) | Kontrol: `python3 --version` 2. **Git** - [İndir](https://git-scm.com/) | Kontrol: `git --version` 3. **İlk kurulum için 15-30 dakika** **İlk kez mi kullanıyorsunuz?** → **[Buradan Başlayın: Kurşun Geçirmez Hızlı Başlangıç Kılavuzu](BULLETPROOF_QUICKSTART.md)** 🎯 --- ## 📤 Yetenekleri Claude'a Yükleme Yeteneğiniz paketlendikten sonra Claude'a yüklemeniz gerekir: ### Seçenek 1: Otomatik Yükleme (API tabanlı) ```bash # API anahtarınızı ayarlayın (tek seferlik) export ANTHROPIC_API_KEY=sk-ant-... # Otomatik olarak paketle ve yükle skill-seekers package output/react/ --upload # VEYA mevcut .zip'i yükle skill-seekers upload output/react.zip ``` ### Seçenek 2: Manuel Yükleme (API Anahtarı Gerekmez) ```bash # Yeteneği paketle skill-seekers package output/react/ # → output/react.zip oluşturur # Sonra manuel olarak yükleyin: # - https://claude.ai/skills adresine gidin # - "Upload Skill" düğmesine tıklayın # - output/react.zip dosyasını seçin ``` ### Seçenek 3: MCP (Claude Code) ``` Claude Code'da şunu sorun: "React yeteneğini paketle ve yükle" ``` --- ## 🤖 AI Ajanlara Yükleme Skill Seekers, yetenekleri 18 AI kodlama ajanına otomatik olarak yükleyebilir. ```bash # Belirli bir ajana yükle skill-seekers install-agent output/react/ --agent cursor # Tüm ajanlara aynı anda yükle skill-seekers install-agent output/react/ --agent all # Yüklemeden önizle skill-seekers install-agent output/react/ --agent cursor --dry-run ``` ### Desteklenen Ajanlar | Ajan | Yol | Tür | |------|-----|-----| | **Claude Code** | `~/.claude/skills/` | Global | | **Cursor** | `.cursor/skills/` | Proje | | **VS Code / Copilot** | `.github/skills/` | Proje | | **Amp** | `~/.amp/skills/` | Global | | **Goose** | `~/.config/goose/skills/` | Global | | **OpenCode** | `~/.opencode/skills/` | Global | | **Windsurf** | `~/.windsurf/skills/` | Global | | **Roo Code** | `.roo/skills/` | Proje | | **Cline** | `.cline/skills/` | Proje | | **Aider** | `~/.aider/skills/` | Global | | **Bolt** | `.bolt/skills/` | Proje | | **Kilo Code** | `.kilo/skills/` | Proje | | **Continue** | `~/.continue/skills/` | Global | | **Kimi Code** | `~/.kimi/skills/` | Global | --- ## 🔌 MCP Entegrasyonu (26 Araç) Skill Seekers, Claude Code, Cursor, Windsurf, VS Code + Cline veya IntelliJ IDEA'dan kullanılmak üzere bir MCP sunucusu sağlar. ```bash # stdio modu (Claude Code, VS Code + Cline) python -m skill_seekers.mcp.server_fastmcp # HTTP modu (Cursor, Windsurf, IntelliJ) python -m skill_seekers.mcp.server_fastmcp --transport http --port 8765 # Tüm ajanları aynı anda otomatik yapılandır ./setup_mcp.sh ``` **Mevcut tüm 26 araç:** - **Çekirdek (9):** `list_configs`, `generate_config`, `validate_config`, `estimate_pages`, `scrape_docs`, `package_skill`, `upload_skill`, `enhance_skill`, `install_skill` - **Genişletilmiş (10):** `scrape_github`, `scrape_pdf`, `unified_scrape`, `merge_sources`, `detect_conflicts`, `add_config_source`, `fetch_config`, `list_config_sources`, `remove_config_source`, `split_config` - **Vektör Veritabanı (4):** `export_to_chroma`, `export_to_weaviate`, `export_to_faiss`, `export_to_qdrant` - **Bulut (3):** `cloud_upload`, `cloud_download`, `cloud_list` **Tam Kılavuz:** [docs/MCP_SETUP.md](docs/MCP_SETUP.md) --- ## ⚙️ Yapılandırma ### Mevcut Ön Ayarlar (24+) ```bash # Tüm ön ayarları listele skill-seekers list-configs ``` | Kategori | Ön Ayarlar | |----------|-----------| | **Web Çerçeveleri** | `react`, `vue`, `angular`, `svelte`, `nextjs` | | **Python** | `django`, `flask`, `fastapi`, `sqlalchemy`, `pytest` | | **Oyun Geliştirme** | `godot`, `pygame`, `unity` | | **Araçlar ve DevOps** | `docker`, `kubernetes`, `terraform`, `ansible` | | **Birleşik (Dokümantasyon + GitHub)** | `react-unified`, `vue-unified`, `nextjs-unified` ve daha fazlası | ### Kendi Yapılandırmanızı Oluşturma ```bash # Seçenek 1: Etkileşimli skill-seekers scrape --interactive # Seçenek 2: Bir ön ayarı kopyalayıp düzenleme cp configs/react.json configs/myframework.json nano configs/myframework.json skill-seekers scrape --config configs/myframework.json ``` ### Yapılandırma Dosyası Yapısı ```json { "name": "myframework", "description": "Bu yeteneğin ne zaman kullanılacağı", "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 } ``` ### Yapılandırmaların Aranma Sırası Araç aşağıdaki sırayla arar: 1. Belirtilen tam yol 2. `./configs/` (mevcut dizin) 3. `~/.config/skill-seekers/configs/` (kullanıcı yapılandırma dizini) 4. SkillSeekersWeb.com API (ön ayar yapılandırmaları) --- ## 📊 Oluşturulan İçerik ``` output/ ├── godot_data/ # Taranan ham veriler │ ├── pages/ # JSON dosyaları (sayfa başına bir tane) │ └── summary.json # Genel bakış │ └── godot/ # Yetenek ├── SKILL.md # Gerçek örneklerle zenginleştirilmiş ├── references/ # Kategorize edilmiş dokümantasyon │ ├── index.md │ ├── getting_started.md │ ├── scripting.md │ └── ... ├── scripts/ # Boş (kendinizinkini ekleyin) └── assets/ # Boş (kendinizinkini ekleyin) ``` --- ## 🐛 Sorun Giderme ### İçerik Çıkarılmadı mı? - `main_content` seçicinizi kontrol edin - Deneyin: `article`, `main`, `div[role="main"]` ### Veri Var Ama Kullanılmıyor mu? ```bash # Yeniden taramaya zorla rm -rf output/myframework_data/ skill-seekers scrape --config configs/myframework.json ``` ### Kategoriler İyi Değil mi? Yapılandırmadaki `categories` bölümünü daha iyi anahtar kelimelerle düzenleyin. ### Dokümantasyonu Güncellemek mi İstiyorsunuz? ```bash # Eski verileri sil ve yeniden tara rm -rf output/godot_data/ skill-seekers scrape --config configs/godot.json ``` ### Zenginleştirme Çalışmıyor mu? ```bash # API anahtarının ayarlanıp ayarlanmadığını kontrol edin echo $ANTHROPIC_API_KEY # Bunun yerine LOCAL modunu deneyin (Claude Code Max kullanır, API anahtarı gerekmez) skill-seekers enhance output/react/ --mode LOCAL # Arka plan zenginleştirme durumunu izleyin skill-seekers enhance-status output/react/ --watch ``` ### GitHub Hız Limiti Sorunları mı? ```bash # GitHub token ayarlayın (anonim 60/saat yerine 5000 istek/saat) export GITHUB_TOKEN=ghp_your_token_here # Veya birden fazla profil yapılandırın skill-seekers config --github ``` --- ## 📈 Performans | Görev | Süre | Notlar | |-------|------|--------| | Tarama (senkron) | 15-45 dk | Yalnızca ilk seferinde, iş parçacığı tabanlı | | Tarama (asenkron) | 5-15 dk | `--async` bayrağı ile 2-3 kat daha hızlı | | Derleme | 1-3 dk | Önbellekten hızlı yeniden derleme | | Yeniden derleme | <1 dk | `--skip-scrape` ile | | Zenginleştirme (LOCAL) | 30-60 sn | Claude Code Max kullanır | | Zenginleştirme (API) | 20-40 sn | API anahtarı gerektirir | | Video (altyazı) | 1-3 dk | YouTube/yerel, yalnızca altyazı | | Video (görsel) | 5-15 dk | + OCR kare çıkarma | | Paketleme | 5-10 sn | Son .zip oluşturma | --- ## 📚 Dokümantasyon ### Başlarken - **[BULLETPROOF_QUICKSTART.md](BULLETPROOF_QUICKSTART.md)** - 🎯 Yeniyseniz **BURADAN BAŞLAYIN!** - **[QUICKSTART.md](QUICKSTART.md)** - Deneyimli kullanıcılar için hızlı başlangıç - **[TROUBLESHOOTING.md](TROUBLESHOOTING.md)** - Yaygın sorunlar ve çözümler - **[docs/QUICK_REFERENCE.md](docs/QUICK_REFERENCE.md)** - Tek sayfalık hızlı referans ### Kılavuzlar - **[docs/LARGE_DOCUMENTATION.md](docs/LARGE_DOCUMENTATION.md)** - 10K-40K+ sayfalık dokümantasyonu işleme - **[ASYNC_SUPPORT.md](ASYNC_SUPPORT.md)** - Asenkron mod kılavuzu (2-3 kat daha hızlı tarama) - **[docs/ENHANCEMENT_MODES.md](docs/ENHANCEMENT_MODES.md)** - AI zenginleştirme modları kılavuzu - **[docs/MCP_SETUP.md](docs/MCP_SETUP.md)** - MCP entegrasyon kurulumu - **[docs/UNIFIED_SCRAPING.md](docs/UNIFIED_SCRAPING.md)** - Çoklu kaynak tarama - **[docs/VIDEO_GUIDE.md](docs/VIDEO_GUIDE.md)** - Video çıkarma kılavuzu ### Entegrasyon Kılavuzları - **[docs/integrations/LANGCHAIN.md](docs/integrations/LANGCHAIN.md)** - LangChain RAG - **[docs/integrations/CURSOR.md](docs/integrations/CURSOR.md)** - Cursor IDE - **[docs/integrations/WINDSURF.md](docs/integrations/WINDSURF.md)** - Windsurf IDE - **[docs/integrations/CLINE.md](docs/integrations/CLINE.md)** - Cline (VS Code) - **[docs/integrations/RAG_PIPELINES.md](docs/integrations/RAG_PIPELINES.md)** - Tüm RAG hatları --- ## 📝 Lisans MIT Lisansı - ayrıntılar için [LICENSE](LICENSE) dosyasına bakın --- Keyifli yetenek oluşturmalar! 🚀 --- ## 🔒 Güvenlik [](https://mseep.ai/app/yusufkaraaslan-skill-seekers)