arge-tesvik-skills

Bu depo, self-listing bir marketplace üzerinden iki bağımsız Claude Code eklentisi sağlar:

• arge-tesvik — Türkiye'deki Ar-Ge teşvik süreçlerini (TÜBİTAK TEYDEB/ARDEB, patent, 5746 mevzuatı) yürüten bir Ar-Ge Teşvik & Proje Uzmanı'nın işini destekler. Bu araç TÜBİTAK ile ilişkili değildir. Resmi kaynak: tubitak.gov.tr
• akademik-arastirma — Türkçe akademik araştırma sürecini (literatür taraması, makale/tez yapısı planlama, hakem simülasyonu, atıf/bütünlük kontrolü) destekler. Detaylar ve kurulum için akademik-arastirma/README.md'ye bakın.

Bu bölümün geri kalanı arge-tesvik eklentisini anlatır.

Ne işe yarar

Eklenti sekiz skill ve yedi slash komutu içerir:

Slash komutları ilgili skill'i doğrudan tetikler:

• /arge-tesvik:uret → fikir-uretimi
• /arge-tesvik:degerlendir → hakem-simulasyonu
• /arge-tesvik:gider → gider-kalemi-kontrolu
• /arge-tesvik:tara → cagri-tarama
• /arge-tesvik:rapor → donem-raporu-kontrolu
• /arge-tesvik:tutarlilik → proje-tutarlilik-kontrolu
• /arge-tesvik:itiraz → itiraz-hazirlik

Claude Code'da plugin komutları <plugin-adı>:<komut-adı> şeklinde adlandırılır, bu yüzden tam komut isimleri yukarıdaki gibidir. Başka bir eklentiyle çakışmadığı sürece kısaca /degerlendir ya da /tara yazmak da çalışır.

Gereksinimler

Her skill'in çalışması için sohbette paylaşmanız gereken en az bir girdi vardır; bazı skill'ler ayrıca daha doğru sonuç için references/ klasörüne eklenmiş resmi bir belgeye ihtiyaç duyar. Bu belgeler zorunlu değildir — eksikse skill veriyi uydurmak yerine ilgili bilgiyi "bilinmiyor" (UNKNOWN) olarak işaretler (bkz. docs/evidence-protokolu.md) — ama olmadan sonuç eksik kalır.

references/ klasörüne eklenecek belgelerin tam listesi, her birinin ne işe yaradığı ve nereden indirileceği için references/README.md'ye bakın. Tüm belgeler TÜBİTAK'ın resmi sitesinden (tubitak.gov.tr) indirilir; telif hakkı nedeniyle bu depoda yeniden dağıtılmazlar, bu yüzden ilgili belgeyi güncel haliyle siz eklemelisiniz.

Kurulum

Bu depo kendi kendini listeleyen bir marketplace (.claude-plugin/marketplace.json) içerir ve bu marketplace üzerinden arge-tesvik ve akademik-arastirma olmak üzere iki bağımsız plugin sunar, bu yüzden ek bir marketplace deposuna ihtiyaç yoktur. Marketplace'i bir kere ekledikten sonra istediğiniz plugin'i (veya ikisini birden) kurabilirsiniz.

Claude Code kurulu olan normal bir terminalde şu komutları çalıştırın:

claude plugin marketplace add ibrahim-isikli/arge-tesvik-skills
claude plugin install arge-tesvik@arge-tesvik-skills

akademik-arastirma eklentisini kurmak isterseniz (kurulum ve kullanım detayları için akademik-arastirma/README.md):

claude plugin install akademik-arastirma@arge-tesvik-skills

Bundan sonra claude yazıp yeni bir oturum açtığınızda eklenti hazır olur — ayrıca bir "reload" adımına gerek yoktur, çünkü her yeni claude oturumu kurulu plugin'leri zaten yükler. Deneme için: /arge-tesvik:degerlendir yazın ya da bir taslak paylaşıp "hakem ne der?" deyin.

Adımların terminalde tam olarak nasıl göründüğü:

Zaten açık bir Claude Code oturumundaysanız aynı işlemi oturumun kendi komut satırına /plugin marketplace add ... ve /plugin install ... yazarak da yapabilirsiniz. Bu durumda kurulum özeti "Run /reload-plugins to activate." derse /reload-plugins çalıştırmanız gerekir.

Yerelde geliştirirken/denerken (marketplace/install adımları olmadan, doğrudan klasörden):

claude --plugin-dir /path/to/arge-tesvik-skills

Kullanım örneği

fikir-uretimi

Bir slash komutu yazmanıza gerek yok — "akıllı ev enerji yönetimi alanında TÜBİTAK'a proje fikri üretir misin?" demeniz fikir-uretimi skill'ini tetiklemeye yeter (ya da doğrudan /arge-tesvik:uret akıllı ev enerji yönetimi). Skill 3-5 aday üretir, her birini 4 unsura göre eler, hayatta kalanlar için çağrı uygunluğu ve patent ön taraması çalıştırıp sonucu Proje Fikri Öneri Formu formatında sunar — üretilen içerik sadece sohbette kalır, hiçbir yere otomatik yazılmaz (bkz. Sınırlamalar).

hakem-simulasyonu

Kurulumdan sonra herhangi bir slash komutu yazmanıza da gerek yok — bir proje önerisi taslağı paylaşıp "hakem ne der?" demeniz hakem-simulasyonu skill'ini tetiklemeye yeter. Aşağıda gerçek bir taslakla alınan çıktının ilk kısmı var; raporun tamamı üç boyutu, düzeltme önerilerini ve ÜYZ/beyan hatırlatmalarını da içerecek şekilde devam eder:

cagri-tarama

Aynı şekilde, "TÜBİTAK'ın açık çağrıları neler, 1501 ve 1507'nin son başvuru tarihi ne zaman?" demeniz yeterli. Aşağıdaki GIF'te tam tablo (1001, 1505, 1707, 1511, 3001 dahil) dar terminal genişliğine sığması için liste düzeninde gösterildi:

Önemli: GIF'teki tarihler 6 Ağustos 2026'da yapılan bir taramaya ait, örnek olsun diye burada donmuş durumda — canlı/güncel değil. Skill her çalıştığında yeniden tarama yapar; kendi sorgunuzda güncel tarihleri göreceksiniz.

markapatent-mcp bağlantısı (opsiyonel)

patent-on-arastirma skill'i varsayılan olarak hiçbir hesap/API key gerektirmeyen ücretsiz bir yöntem kullanır: WebSearch/WebFetch ile Google Patents/Espacenet üzerinde canlı patent araması. Bu, TÜRKPATENT'in yerini tutmaz (Türkiye'ye özel bazı başvuruları kaçırabilir, marka/tasarım kapsamaz) ama hiçbir kurulum gerektirmeden hemen çalışır.

plugin.json içinde tanımlı uzak bir HTTP MCP sunucusu (https://markapatent-mcp.fastmcp.app/mcp, markapatent-mcp) sadece siz açıkça TÜRKPATENT'e özel doğrulama veya marka/tasarım araması istediğinizde devreye girer — plugin etkinleştirildiğinde otomatik bağlanabilir (ilk kullanımda Claude Code onay isteyebilir), ama skill varsayılan akışta ona hiç dokunmaz. Sunucunun kendisi bu eklentinin bir parçası değildir, üçüncü taraf bir projedir (saidsurucu/markapatent-mcp) ve arkasında bir captcha-çözücü servise (Capsolver) bağımlıdır — bu servisin bakiyesi/erişilebilirliği bizim kontrolümüzde değildir. Bu bağımlılığı ortadan kaldırmak isterseniz, aynı repoyu kendi Capsolver key'inizle self-host edip plugin.json'daki URL'yi kendi adresinizle değiştirebilirsiniz (kod MIT lisanslı, Dockerfile hazır).

references/ klasörü

references/ klasörü kasıtlı olarak boş gelir. TÜBİTAK'ın uygulama esasları, AGY101/AGY301 şablonları ve güncel çağrı metinleri gibi belgeler sık güncellendiği ve bu depoda yeniden dağıtılması uygun olmadığı için, bu belgeleri tubitak.gov.tr'den indirip kendiniz eklemeniz gerekir. Hangi dosyaların nereden indirileceği için references/README.md'ye bakın.

İndirdiğiniz dosyaları klasöre taşımak, herhangi bir dosya yöneticisiyle ya da terminalde mv/sürükle-bırak ile yapılan sıradan bir işlemdir — örnek:

Evidence protokolü ve ortak kurallar

docs/evidence-protokolu.md, skill'lerin güncel/sayısal/hukuki iddialarda kullandığı ortak sınıflandırma modelini (FACT / INFERENCE / USER-PROVIDED / UNKNOWN / OUTDATED / CONFLICTING), kaynak güven hiyerarşisini ve her skill'in sonunda tekrarlanan zorunlu uyarı bloğunun kanonik metnini tek yerde toplar. Skill'lerdeki uyarı blokları bilinçli olarak kendi dosyalarında (inline) tutulur — bu dosya bir çalışma zamanı bağımlılığı değil, bakım/tutarlılık için tek doğru kaynaktır.

Doğrulama ve testler

• scripts/validate.py — bağımlılıksız (stdlib) bir statik doğrulama scripti: plugin.json/marketplace.json JSON geçerliliği, her skill'in SKILL.md frontmatter kısıtlarına (isim/karakter seti/uzunluk, açıklama uzunluğu) uyup uymadığı, slash komutlarının var olan bir skill'e referans verip vermediği ve plugin sürümüyle CHANGELOG'un eşleşip eşleşmediğini kontrol eder. Çalıştırmak için: python3 scripts/validate.py. Bu depoda otomatik bir CI workflow'u yok — commit öncesi elle çalıştırın.
• skills/gider-kalemi-kontrolu/scripts/check_table.py — o skill'in zorunlu çıktı tablosunun (5 kolon: Gider/Kategori Uygunluğu/Gerekçelendirme Yeterliliği/Kanıt Durumu/Risk) şemasını mekanik olarak kontrol eder; skill kendi çıktısını göndermeden önce bunu çalıştırması beklenir (garanti değil — bkz. Sınırlamalar).
• tests/ — her skill için LLM-graded manuel eval senaryoları (normal durum, eksik bilgi, hallucination tuzağı, çelişkili bilgi, güncelliğini yitirmiş bilgi, kötü niyetli girdi, belirsiz istek). Bunlar otomatik CI testi değildir; nasıl kullanılacağı için tests/README.md'ye bakın.
• tests/golden/ — çoklu belge/çoklu skill ve cross-skill tutarlılık regresyonu için yapılandırılmış bir çerçeve (henüz gerçek proje verisi yok, sadece şablon). Detaylar için tests/golden/README.md.

Sınırlamalar

• fikir-uretimi içerik üretir, diğer skill'ler gibi sadece mevcut bir belgeyi eleştirmez — bu yüzden ürettiği fikirler doğrulanmış bir şirket ihtiyacı değil, GENERATED (aksi belirtilmedikçe varsayımsal) olarak etiketlenir. Ayrıca üretilen fikir/form içeriğini hiçbir genel/paylaşılan depoya, sayfaya veya üçüncü tarafa otomatik göndermez/yazmaz — bir buluş fikrinin patent başvurusundan önce kamuya açık hale gelmesi, kendi başvurunuza karşı önceki teknik (prior art) sayılıp patentlenebilirliği düşürebilir. Bu skill'i otomatik/zamanlanmış çalıştırıyorsanız (bkz. "Otomatik çağrı takibi"), çıktının nereye gideceğine dikkat edin.
• Skill'ler birer LLM talimat kümesidir, deterministik doğrulayıcı değildir — çıktıları her zaman bir başlangıç noktasıdır, resmi karar/hukuki görüş yerine geçmez.
• cagri-tarama ve patent-on-arastirma canlı web erişimine bağımlıdır; ağ erişimi yoksa veya kaynak sayfa değişmişse sonuçlar eksik/hatalı olabilir (skill'ler bu durumu sessizce geçmemek üzere yazıldı, ama garantisi yoktur). patent-on-arastirma'nın varsayılan (Google Patents/Espacenet) yöntemi TÜRKPATENT'in yerini tutmaz ve marka/tasarım kapsamaz — bunlar için opsiyonel markapatent-mcp gerekir (bkz. "markapatent-mcp bağlantısı").
• references/ klasörü boş gelir; skill'ler güncel mevzuat/şablon metnini kendiliğinden "bilmez" — doğru çalışmaları için ilgili resmi belgeleri siz eklemelisiniz.
• Bu eklenti TÜBİTAK veya TÜRKPATENT ile resmi bir ilişki içinde değildir; hiçbir skill çıktısı resmi başvuru sonucu garantisi taşımaz.
• gider-kalemi-kontrolu'nun zorunlu 5 kolonlu çıktı tablosu (Gider/Kategori Uygunluğu/Gerekçelendirme Yeterliliği/Kanıt Durumu/Risk) gerçek runtime testlerinde içerik olarak her zaman doğru ama kolon başlıkları/şema olarak garanti edilemedi — model bazen farklı bir tablo yapısı üretebilir. Bu şema uyumsuzluğunu otomatik tespit etmek isterseniz skills/gider-kalemi-kontrolu/scripts/check_table.py'ı çıktıya karşı elle çalıştırabilirsiniz. Bilgi doğruluğunu etkilemez, sadece programatik ayrıştırma yapıyorsanız önemlidir.

Sorun giderme

• patent-on-arastirma sonuç vermiyor: Skill varsayılan olarak markapatent-mcp'ye hiç dokunmaz, doğrudan Google Patents/Espacenet üzerinde ücretsiz tarama yapar — bu yüzden normal kullanımda MCP hatasıyla karşılaşmamanız gerekir. Yine de sonuç alamıyorsanız WebSearch/WebFetch araçlarının bu oturumda bağlı olduğundan emin olun.
• TÜRKPATENT'e özel doğrulama veya marka/tasarım araması istediğimde hata alıyorum: Bu, markapatent-mcp sunucusunu devreye sokar — bu eklentiden bağımsız, üçüncü taraf bir uzak servistir (saidsurucu/markapatent-mcp, bu turda gerçek bir çalıştırmada sunucunun arkasındaki captcha-çözücü servisin — Capsolver — bakiyesi tükendiği tespit edildi; bu bizim kontrolümüzde değil). Bu durum sadece bu isteğe özel etkilidir — varsayılan (Google Patents) tarama ve diğer altı skill markapatent-mcp'ye bağımlı değildir, normal çalışmaya devam eder. Kalıcı bir çözüm için "markapatent-mcp bağlantısı" bölümündeki self-host seçeneğine bakın. Skill, MCP hatasını sessizce boş sonuç gibi sunmamalıdır; böyle davranmıyorsa bir hata olarak bildirin.
• Slash komutu görünmüyor: Eklentinin yüklendiğini (claude plugin list veya oturum başlangıcındaki plugin listesi) ve /reload-plugins gerekip gerekmediğini kontrol edin (bkz. Kurulum bölümü).
• Skill tetiklenmiyor ama slash komutu çalışıyor: Skill'in description alanı, Claude'un ne zaman tetikleyeceğine karar verdiği tetikleme kuralıdır; isteğinizde skill'in kapsadığı anahtar kelimelerden (örn. "hakem", "gider kalemi", "itiraz") biri geçmiyorsa ilgili slash komutunu doğrudan kullanmanız daha güvenilirdir.

Otomatik çağrı takibi (opsiyonel)

cagri-tarama her çalıştığında canlı tarama yapar, ama isterseniz Claude Code'un Routine (zamanlanmış tetikleyici) özelliğiyle bunu periyodik hale getirebilirsiniz — örneğin her Pazartesi /arge-tesvik:tara çalıştırıp yeni çağrı veya yaklaşan son başvuru tarihi varsa size haber vermesini isteyebilirsiniz. Bu, depoya gömülü bir özellik değil, Claude Code'un genel zamanlama mekanizmasının bu eklentiyle kullanımıdır; kurmak isterseniz Claude'a "her Pazartesi /arge-tesvik:tara çalıştır ve yeni çağrı varsa bana haber ver" demeniz yeterli.

Aynı mekanizmayla fikir-uretimi'ni de periyodik hale getirebilirsiniz (örn. "her hafta /arge-tesvik:uret [alanınız] çalıştır, sonucu bana bildir"). Bunu yaparken firmanıza özgü ürün/teknoloji alanı bilgisini Routine'in kendi prompt'una yazın, bu genel depoya değil — Routine prompt'u Claude Code platformunda saklanır, bu depoya commit edilmez. Ayrıca çıktının nereye gideceğine dikkat edin: Routine'i bu deponun kendisine yazacak (commit/PR açacak) şekilde kurmayın — üretilen fikirler sohbet/bildirim kanalında sizde kalmalı, herkese açık bu depoda değil (bkz. Sınırlamalar).

Sürüm geçmişi

Değişiklikler için CHANGELOG.md'ye bakın.

Katkıda bulunma

Yeni bir skill önermeden veya PR açmadan önce CONTRIBUTING.md'yi okuyun (zorunlu kurallar, test etme adımları, skill yazım kuralları). Katkı sağlarken CODE_OF_CONDUCT.md'ye uyulması beklenir.

Zorunlu kurallar (tüm skill'lerde geçerli)

Her skill, TÜBİTAK ÜYZ (üretken yapay zeka) Rehberi (Eylül 2025) kapsamında şu kurallara uyacak şekilde yazıldı:

• Gizlilik: Ciro, bütçe detayı, yayınlanmamış teknik bilgi gibi hassas/gizli firma verileri araca girilmemeli; skill'ler kullanıcıyı bu konuda uyarır ve placeholder mantığıyla çalışır.
• Beyan zorunluluğu: Proje önerisi hazırlanırken bir ÜYZ aracından önemli ölçüde faydalanıldıysa, bunun başvuruda beyan edilmesi gerektiğini her skill çıktısının sonunda hatırlatır.
• Nihai sorumluluk: Başvurunun içeriğinden ve doğruluğundan nihai olarak başvuru sahibi sorumludur; hiçbir skill bu sorumluluğu üstlenmez.

İlgili eklenti

5746 sayılı Kanun kapsamında bir Ar-Ge/Tasarım/Yenilik Merkezi kurmak veya sürdürmek istiyorsanız (TEYDEB/ARDEB proje hibesinden farklı, kurumsal/firma bazlı bir teşvik rejimi), aynı geliştiricinin arge-merkezi-uygunluk-kontrolu eklentisine bakın.