algo-investor-skills: Dolandırıcılığa Karşı Dayanıklı Bir Yatırımcı Teklifi Oluşturan Claude Code Skill'leri

Dışarıdan sermaye toplamayı bir kez olsun denemiş her algotrader o duvarı bilir. İşe yarayan bir stratejiniz, kendi hesaplarınızda canlı bir performans geçmişiniz ve temiz bir özsermaye eğriniz var. Sonra yatırımcı belgesini yazmak için oturuyorsunuz — ve en zor kısmın strateji olmadığını keşfediyorsunuz. En zor kısım, sayılarla arası iyi, şüpheci bir profesyoneli bir dolandırıcı olmadığınıza ikna etmektir. Sözünüze inanmazlar. 2026'da gerçekte yaptıkları şey, ticari teklifinizi başka hiçbir bağlam vermeden bir LLM'e yapıştırıp şunu sormaktır: "bu gerçek mi, yoksa bir sahtekarlık mı?"

algo-investor-skills, tam da bu an için inşa edilmiş, hazır bir Claude Code skill setidir. Sizi ham strateji gerçeklerinden, tamamlanmış, denetlenmiş, çok dilli bir yatırımcı teklifine taşır — o düşmanca LLM yapıştır-test'inden sağ çıkan, güvenilir ve dürüstlük odaklı türden bir belge. Tüm tasarım, pazarlık konusu olmayan tek bir kurala dayanır: hiçbir zaman bir sayı uydurmaz.

Baştan bir not, deponun da ilk satırda belirttiği aynı not: kitin reference/ dizinindeki her şey anonimleştirilmiş bir uygulamalı örnektir. İsimler, işlem mekanları ve metrikler yer tutuculardır, gerçek rakamlar değildir. Skill'ler belgeleri kendi ölçülmüş geçmişinizden üretir — kimsenin gerçek rakamlarını içermezler ve sizinkileri de uydurmazlar.

Bunun neden bir skill seti olduğu, bir şablon olmadığı

Bir yatırımcı teklifini bir Word şablonundan yazabilirsiniz. İnsanlar bunu yapıyor ve belli oluyor. Statik bir şablon, kırk işlem eklediğinizde Sharpe'ınızı yeniden hesaplayamaz, en iyi kazançlılarınız çıkarıldığında üstünlüğünüze stres testi yapamaz ve kendi sunumunuzdaki zayıf noktaları bulmak için düşmanca bir tahsisçiyi taklit edemez. İşte algo-investor-skills'in doldurduğu boşluk budur.

Bunlar, .claude/skills/ altında bulunan sade Claude Code skill'leridir. Depoyu Claude Code'da açın, otomatik olarak yüklenirler. Sıradan skill'ler oldukları için, onları başka herhangi bir projeye de taşıyabilirsiniz — klasörleri proje-yerel bir .claude/skills/ içine kopyalayın ya da her yerde bulunmaları için kullanıcı-global ~/.claude/skills/ içine kopyalayın:

cp -r .claude/skills/* /path/to/your/project/.claude/skills/

cp -r .claude/skills/* ~/.claude/skills/

Finansal-modeller motoru, bir akıl sağlığı kontrolü olarak bağımsız bir şekilde, hiçbir bağımlılık olmadan bile çalışır:

node .claude/skills/algo-financial-models/models.mjs   # prints a worked demo

Altı skill

Kit, altı bileşik skill içerir. Biri orkestratördür; diğer beşinin her biri ardışık düzenin bir aşamasına sahiptir.

Ardışık düzen, baştan sona

Skill'ler rastgele seçtiğiniz bir menü değildir — sıralı bir ardışık düzen oluştururlar ve her aşama bir öncekine bağlı olduğu için investor-docs onları sırayla çalıştırır:

intake/intake-template.md   ← you fill in measured facts + labeled assumptions
        │
        ▼
algo-financial-models   →   honest numbers / tables
        │
        ▼
investor-proof-pack     →   transparency + verification package
        │
        ▼
investor-proposal-build →   full 14-section Markdown proposal
        │
        ▼
investor-doc-localize   →   language / market variants   (optional)
        │
        ▼
investor-proposal-audit →   skeptical-investor loop until it passes  (REQUIRED)

1. Intake — tek doğruluk kaynağı

Her şey intake/intake-template.md ile başlar. Strateji tezinizi, ölçülmüş geçmişinizi (örneklem büyüklüğü, kazanma oranı, ortalama işlem, Sharpe, Sortino, maksimum geri çekilme, tarih aralığı), işlem mekanlarınızı ve hesap mimarinizi ve ticari koşullarınızı doldurursunuz. Çok önemli olarak, her rakamı ya [real] (ölçülmüş) ya da açıkça etiketlenmiş bir ileriye dönük varsayım (kaldıraç, dilim sayısı, varsayılan derinlik, slippage, alpha azalması) olarak işaretlersiniz.

Tüm kiti güvenilir kılan kural burada yaşar: boş bıraktığınız her şey taslakta açık bir TODO yuvası olur, asla uydurulmuş bir sayı olmaz. Bir rakamı borsa dışa aktarımlarınızla destekleyemiyorsanız, onu boş bırakırsınız ve kit boşluğun üzerini örtmeyi reddeder.

2. algo-financial-models — dürüst sayılar

Bu skill, ölçülmüş girdilerinizi, her biri dürüst bir ya da iki satırlık başlıkla birlikte, doğrudan eklenebilir Markdown tabloları olarak çıkarılan altı niceliksel modele dönüştürür:

• Beklenti ve pozisyon büyüklüğü — beklenen değer, işlem başına sigma, kazanç oranı, kapasite, net üstünlük ve Kelly oranı.
• Getiri köprüsü — ham olay başına üstünlükten kapasiteye göre ayarlanmış, ücret sonrası, azalma sonrası rakama kadar dört basamak. Her zaman hem ham üstünlüğü hem de kapasiteye göre ayarlanmış üstünlüğü gösterir, çünkü ham olay başına sayı bir fon tarafından gerçekleştirilebilir bir getiri değildir ve aksini iddia etmek tam olarak kitin önlemek için var olduğu türden bir sahtekarlıktır.
• Yüksek-su-işareti (high-water-mark) ücret çizelgesi — yalnızca performans ücreti, yeni özsermaye zirvelerinde tahsil edilir.
• Quant metrikleri — ölçülmüş Sharpe ve Sortino'nuzun tam olarak yeniden üretilmesi için sigma ve aşağı yönlü sapmayı geriye doğru çözer. Bunlar olduğu gibi aktarılır; kit onları geçersiz kılmaz ya da süslemez.
• Monte-Carlo (GBM) — alpha azalması da dahil edilerek P5 / P50 / P95 yolları artı iflas olasılığı.
• Alpha dayanıklılığı + Wilson CI — azalan-üstünlük çizelgesi ve küçük-örneklem kazanma-oranı güven aralığı, böylece bir %62-of-80-trades rakamı asla bir doğa kanunuymuş gibi sunulmaz.

Gerçekten keskin bulduğum bir ayrıntı: etkin olay başına maruziyet leverage / tranches (L / N) olarak hesaplanır ve maruziyet-tarama tablosu Kelly'ye göre renk kodludur — yarım-Kelly'de veya altında yeşil, tam Kelly'ye kadar amber, üstünde kırmızı. Bu, "ne kadar bahis koymalıyım?" sorusunu bir histen, savunabileceğiniz bir tabloya dönüştürür.

3. investor-proof-pack — kontrol edilebilir hale getirilmiş dürüstlük

Şüphecilerin gerçekten önemsediği kısım budur. Kanıt paketi, gizli sosu sızdırmadan ve hiçbir şey uydurmadan canlı geçmişinizin gerçek olduğunu kanıtlayan bir şeffaflık paketi bir araya getirir:

• Pencere içindeki tüm işlemleri — kazançlıları ve zararlıları — listeleyen, sabit sütunlu (# | Venue | Pair | Date | Side | PnL % | Hold time | Status) bir açıklanmış-işlemler tablosu. Seçmece (cherry-picking) açıkça yasaktır. Yüzdeler ve tarihler gösterilir; dolar miktarları kasıtlı olarak gizli tutulur ve kit bu sınırı açık sözlerle belirtir.
• İki yolu birbiriyle uyuşmak zorunda olan bir bağımsız mutabakat metodolojisi: borsanın REST API'si üzerinden order-id mutabakatı (gerçekleşmiş P&L'i fill'lerden tam olarak yeniden hesaplayarak) ve borsanın resmi işlem-geçmişi dışa aktarımına karşı ekstre mutabakatı (sembol + zaman + işaret üzerinden, belirtilen bir tolerans dahilinde eşleştirilerek). Uyuşan iki bağımsız mutabakat, tek bir taneye göre sahtelemesi çok daha zordur.
• Bir salt-okunur "Adım 0" doğrulama önerisi: yatırımcının kendisinin oluşturduğu salt-okunur bir API anahtarına karşı kendisinin çalıştırdığı, açıklanmış işlemleri borsanın kendi verisiyle mutabık kılan bir betik — herhangi bir işlem-izni anahtarı vermeden önce.
• Grafikler — gerçek mum-mum grafiklerin yanında, mutabık kılınan fill'lere bağlı giriş/çıkış işaretçileriyle birlikte sentetik illüstrasyonlar (işlem mekaniğini öğretmek için açıkça etiketlenmiş).

Ve bunu bir sunum sunumundan (pitch deck) ayıran kısım: kanıt paketi kendi sınırını yüksek sesle belirtir. Mutabakat, geçmiş canlı işlemlerin gerçekliğini ve büyüklüğünü kanıtlar. Gelecekteki getirileri kanıtlamaz, üstünlüğün büyük ölçekte geçerli olduğunu kanıtlamaz ve tam bir denetim değildir. En güçlü kanıt, kitin açıkça söylediği gibi, yatırımcının kendi hesabında ileriye dönük bir pilot çalışmadır.

4. investor-proposal-build — 14 bölümlük yay

Bu skill, düşmanca bir yatırımcının bir LLM'e bütün halinde yapıştırıp parça parça inceleyebileceği tek, kendi kendine yeten bir Markdown belgesi bir araya getirir. Yapı, getirilerle değil, risk ve emanet (custody) ile başlayan kasıtlı bir 14 bölümlük yaydır:

1. Tez — en ilk paragrafta tek satırlık bir emanet çıpasıyla birlikte.
2. Üstünlüğün nereden geldiği — yapısal verimsizlik, harici çalışmaların operatörün kendi sonuçları olarak sunulmadığına dair dürüst bir uyarıyla.
3. Manşet metrikler — Sharpe / Sortino / maksimum geri çekilme, kaldıraçtan bağımsız oranlar olarak not edilmiş, Sortino öncülüğünde, küçük-örneklem uyarısı eklenmiş.
4. Emanet ve işletme modeli — yalnızca-işlem API anahtarları, çekim hakkı yok, "acil fren" olarak tek tıkla iptal, sunulan tek model olarak belirtilmiş.
5. Gerçek-işlemler şeffaflığı — adım 3'teki kanıt paketi.
6. Sermaye aşamaları — pilot (~50 bin $, ücret emanette, yüksek-su-işareti toparlanana kadar %0), ölçeklendirme, ardından hedef.
7. Ücret modeli — net karın yüzdesi olarak somut bir performans ücreti, bir yüksek-su-işaretiyle ve yönetim ücreti olmadan.
8. İki adlandırılmış risk — ölçekte test edilmemiş olma (çıkış-likiditesi) ve ultra-kısa tutma penceresi, çekince koymadan belirtilmiş.
9. Niceliksel bir başarısızlık-senaryoları tablosu — her senaryoda yatırımcının ne kaybettiği, N-dilim matematiğine bağlanmış.
10. Sorumluluk ve risk tahsisi — dürüst tüzel-kişilik-yok / sınırlı-rücu uyarısı dahil.
11. N ayrı üst-düzey hesap arasında sermaye bölünmesi (bir donma durumunda kademeli olarak yayılabilen alt hesaplar değil), işlem mekanı başına bir üst sınırla.
12. Alpha dayanıklılığı — açık azalma varsayımı ve kapasite tavanı, ileriye dönük bir varsayım olarak çerçevelenmiş.
13. Operatör — bir kişi, sıkacak tek bir boğaz, hem bir uyum (alignment) özelliği hem de bir kilit-kişi riski olarak belirtilmiş.
14. Yol haritası — açıkça "vaat değildir" olarak etiketlenmiş.

Bütünü, yapısı gereği düşük-abartılıdır. Bir cümle bir sunum sunumu gibi geliyorsa, skill onu keser. Emanet ve acil fren, herhangi bir getiri rakamından önce gelir ve bir övünme gibi okunabilecek her bölüm, aynı nefeste karşılık gelen riskle dengelenir.

5. investor-doc-localize — kayma olmadan çeviri

İsteğe bağlı, ama iyi tasarlanmış. Tamamlanmış ana belgeyi en / ru / zh / ko dillerine (genişletilebilir) yerelleştirir ve hatta pazara özgü varyantlar üretir — örneğin, işlem mekanını ilk elden anlayan bir kitle için yapısal üstünlüğü öne çıkaran izole-pazar varyantına karşı, arındırılmış bir kamuya açık varyant. Karşı koruduğu büyük günah: bir sayının kaymasına ya da bir uyarının yumuşamasına, başka bir dilde "daha iyi okunduğu" için izin vermek. Her ücret yüzdesi, her emanet koşulu, her başarısızlık senaryosu diller arasında aynı şekilde işlenir; emanet, ücret ve sorumluluk bölümlerinde bir geri-çeviri nokta kontrolüyle.

6. investor-proposal-audit — zorunlu kapı

Bu, kiti bir belge üreticisinden daha fazlası yapan skill'dir. Ciddi bir yatırımcının yaptığı tam kontrolü simüle eder: taze, yalnızca-belge bir AI-yatırımcı — kod yok, performans geçmişi yok, şüpheden yararlandırma yok — teklifi okur ve yapılandırılmış bir karar döndürür: satisfaction (0–100), wouldInvest, scamRisk (low / medium / high), başlıca endişeler, eksik bilgi, kırmızı bayraklar ve güçlü yönler. Ardından bir revizör ajan, şüphecinin işaretlediği şeyleri dürüstçe düzeltir ve döngü tekrarlanır.

Değerlendirme ölçütü varsayılan olarak şüpheciliğe ayarlıdır. Dürüst sınırlamaları, somut doğrulama mekanizmalarını, açık ücret ve emanet koşullarını ve niceliksel aşağı yönlü riski ödüllendirir. Sert bir şekilde cezalandırır: pazarlama sıfatlarını, gizli sayılarla "bize güvenin" demeyi, para konusunda belirsizliği, doğrulanamaz iddiaları ve iç çelişkileri — klasik olanı, olay başına kapasitenin minik olduğunu kabul ederken büyük bir miktar istemektir.

Revizörün kuralları tüm kitin ahlaki çekirdeğidir. Asla bir metriği şişirmez, asla bir uyarıyı silmez, asla bir performans geçmişi uydurmaz. "Doğrulanamaz"ı düzeltmenin yolu önerilebilir kanıt eklemektir — salt-okunur API erişimi, borsa-dışa-aktarımı ekstreler, küçük ücretli bir pilot, performans-ücreti emaneti — abartmak değil. Bir belge yalnızca satisfaction >= 88 ve scamRisk high değilse, en az iki yinelemeden sonra "bitmiş" olur. Bu denetimden geçmemiş bir teklif, tanımı gereği bir taslaktır ve bir teslimat değildir.

Tasarım ilkeleri (ve bunların bir tahsisçi için neden önemli olduğu)

Depo, pazarlık konusu olmayan dört ilke belirtir ve bunlar dürüst sermaye toplamaya yönelik bir manifesto olarak okunmaya değer:

• Asla uydurma. Her sayı, ölçülmüş veriye ya da açıkça etiketlenmiş bir ileriye dönük varsayıma kadar izlenir. Eksik gerçekler, uydurulmuş rakamlar değil, görünür TODO yuvaları olur.
• Dürüstlük odaklı, düşük abartılı. Risk ve emanet ile başla. Sınırlamaları adlandır. Güven istemek yerine doğrulama sun.
• Emanet yapısaldır, vaat edilmiş değil. Yatırımcıya ait hesaplarda yalnızca-işlem API anahtarları, çekim hakkı yok, tek tıkla iptal edilebilir.
• Denetim kapısı zorunludur. Şüpheci-yatırımcı döngüsü geçene kadar bir belge bitmiş değildir.

Hiç bir algotrading sunumu okuyup şüpheciliğinizin her üstünlük sıfatıyla yükseldiğini hissettiyseniz, bu ters çevirmenin neden işe yaradığını anlarsınız. Güven, daha fazlasını iddia ederek inşa edilmez; tam olarak kanıtlayabileceğinizi iddia ederek ve okuyucuya bunu kendisinin kontrol etmesi için araçları vererek inşa edilir.

Bir algo yatırımcının onu gerçekte nasıl kullandığı

Pratikte iş akışı kısadır:

1. Skill'lerin otomatik yüklenmesi için depoyu Claude Code'da açın.
2. Intake şablonunu kopyalayın ve onu ölçülmüş geçmişiniz ve açıkça etiketlenmiş ileriye dönük varsayımlarınızla doldurun, veriniz olmayan yerleri boş bırakın.
3. Claude'a sorun: "Stratejim için bir yatırımcı belgesi hazırla." Bu, ardışık düzeni baştan sona çalıştıran investor-docs orkestratörünü tetikler.
4. Denetim kapısı en son çalışır ve memnuniyet yeterince yüksek olana ve dolandırıcılık riski artık high olmayana kadar döngüye girer.

Çıktı olarak tek bir Markdown dosyası alırsınız: taşınabilir, kendi kendine yeten ve gerçek bir tahsisçinin onu zaten maruz bırakacağı LLM yapıştır-test'inden sağ çıkmak için inşa edilmiş.

Marketmaker / AI-ajan ekosistemine nereye oturduğu

Bu blogda işlem kararları veren AI ajanları hakkında çok şey yazdık — çok-ajanlı fonlar, LLM analist komiteleri, pekiştirmeli-öğrenme ekosistemleri. algo-investor-skills bir katman daha dışarıda, bu projelerin çoğunlukla görmezden geldiği bir sorun üzerinde oturur: otomatik bir strateji bir kez işe yaradığında, onu sermayeye nasıl güvenilir bir şekilde iletirsiniz? Bu, sinyal üretimine değil, yatırımcı ilişkilerine ve durum tespitine yönlendirilmiş ajansal-AI desenidir. Orkestratör-artı-uzmanlar biçimi — sıralayan bir skill, her biri bir aşamaya sahip birkaç skill — kazandığını sürekli gördüğümüz aynı bileşik-ajan mimarisidir, burada bir emir defterine değil bir belgeleme ve doğrulama ardışık düzenine uygulanmış.

Ciddi bir algotrader için bu, anlamlı bir altyapı parçasıdır. Strateji sizin üstünlüğünüzdür; denetlenmiş, dürüstlük odaklı teklif ise, bir pazarlamacıya dönüşmek ya da güvenilirliğinizden ödün vermek zorunda kalmadan o üstünlüğün sermaye çekmesini sağlayan şeydir. Kitin duruşu — güven yerine doğrulama, getirilerden önce risk, asla uydurulmuş sayı yok — tam olarak profesyonel bir tahsisçiyle temasından sağ çıkan duruştur.

Dürüst çekinceler

Bu, erken-aşama, tek-bakıcılı bir projedir ve depo da bunu söylüyor. Referans teklif ve modeller anonimleştirilmiş açıklayıcı örneklerdir, gerçek rakamlar değildir — kitin değeri herhangi bir sevkedilmiş sayıda değil, süreçte ve disiplindedir. Denetim döngüsü, onu çalıştıran model kadar iyidir ve kağıt üzerinde geçen bir puan hala bir kağıt puanıdır: kitin kendisinin ısrarla belirttiği gibi, en güçlü kanıt her zaman yatırımcının kendi hesabında ileriye dönük bir pilot çalışmadır. Kit belgeler üretir; finansal, yasal ya da vergi tavsiyesi vermez ve geçmiş ya da backtest edilmiş sonuçlar gelecekteki sonuçları garanti etmez.

Bunların hiçbiri temel fikri zayıflatmaz. Yatırımcı belgeleri hazırlamanın zor, dürüst işi — yeniden üretilebilir sayıları hesaplamak, kontrol edilebilir bir kanıt paketi oluşturmak, riskle başlamak ve düşmanca bir gözden geçirmeden sağ çıkmak — tam olarak bu kitin sistemleştirdiği iştir.

Bağlantılar

• GitHub: suenot/algo-investor-skills

Sonuç

algo-investor-skills, alışılmadık derecede disiplinli bir teze sahip küçük bir depodur: bir algotrading stratejisi için sermaye toplamanın yolu daha sert sunum yapmak değil, kontrol edilebilir şekilde dürüst olmaktır. Altı Claude Code skill'i bu tezi bir ardışık düzene dönüştürür — ölçülmüş gerçekler girer, yeniden üretilebilir sayılar, doğrulanabilir bir kanıt paketi, 14 bölümlük risk-öncelikli bir teklif, isteğe bağlı sadık yerelleştirme ve zayıflıkları abartarak değil kanıt ekleyerek düzelten zorunlu bir şüpheci-yatırımcı denetimi.

Gerçek bir strateji yürütüyorsanız ve hiç yatırımcı-belgesi duvarında takıldıysanız, bu bir öğleden sonraya değer. Intake'i doldurun, orkestratörü çalıştırın, şüphecinin taslağınızı parçalamasına izin verin ve tam olarak kanıtlayabileceğinizi söyleyen — ve okuyucuya bunu doğrulama araçlarını veren — bir belge sevk edin.