Dokümantasyon / Skill'ler
Hazır gelen skill'ler
ivralo ile gelen on sekiz skill: her birinin sahibi olan preset ve her birinin ne öğrettiği.
Nerede bulunurlar
Gelen skill'ler ana dizininizdeki skills/ klasöründe bulunur. ivralo init --home ile oluşturulan yeni bir ana dizin, kurulu ivralo'yla gelen rafın bir kopyasıyla başlar; bir checkout'ta ise raf, repo'nun kendi skills/ klasörüdür. İçinde ne olduğunu ivralo skills ile görebilirsiniz.
Her uzman bütün skill'leri görür. Aşağıdaki tablolarda sahip olarak geçen, skill'in ait olduğu preset'tir: /skill <ad>'ın işi gönderdiği yer ve ivralo agents'ın o preset altında listelediği skill. Bkz. Skill'ler nasıl çalışır.
Kod ve incident'lar
| Skill | Sahibi | Ne öğretir |
|---|---|---|
coding | coder | Çalışma alanındaki repo'nun kodu üzerinde çalışmak: bir şeyin nerede olduğunu bulmak, açıklamak, bir hatayı düzeltmek, test eklemek ve projenin kendi test, lint ve tip kontrolü komutlarını çalıştırmak. |
incident | investigator | Production'daki bir incident'ı kanıt bundle'ından incelemek: hataları gruplamak, deploy'larla karşılaştırmak, incident'ın türüne ve nedenine karar vermek ve her iddianın kanıtını gösteren bir rapor yazmak. |
github | github | GitHub'ınızla API üzerinden çalışmak (repo'lar, issue'lar, pull request'ler, kod arama); yalnızca yazma açıksa ve siz onaylarsanız yazmak; ayrıca shell üzerinden gh ve git. |
Veri ve grafikler
| Skill | Sahibi | Ne öğretir |
|---|---|---|
analysis | analyst, spreadsheet, visualizer | Gerçek bir CSV, Excel ya da JSON dosyasını pandas ile profillemek ve temizlemek. |
xlsx | analyst, spreadsheet | Excel dosyalarını çalışma kitabı motoruyla okumak ve oluşturmak; formülleri kontrol eden bir script içerir. |
charts | visualizer, reporter | İstenen çıktı tek başına bir grafikse matplotlib, seaborn ya da plotly ile grafik çizmenin kuralları. |
Belgeler, sunumlar ve PDF'ler
| Skill | Sahibi | Ne öğretir |
|---|---|---|
docx | scribe | Word dosyalarını belge motoruyla okumak ve oluşturmak. |
pptx | scribe | PowerPoint sunumlarını sunum motoruyla okumak ve oluşturmak. |
pdf-generate | reporter | Kurumsal renklerle PDF oluşturmak: kapak, üst ve alt bilgi, sayfa numaraları, içindekiler, tablolar, KPI kartları ve grafikler. |
pdf-manipulate | pdf_operator | Mevcut bir PDF'ten metin ve meta veri okumak; PDF'i birleştirmek, bölmek, döndürmek, kırpmak, filigran eklemek ya da şifrelemek. Her işlem için bir script içerir. |
pdf-forms | pdf_operator | Mevcut bir PDF formundaki doldurulabilir alanları bulmak ve doldurmak; gerekli script'leri içerir. |
unicode | reporter, scribe | fpdf, PIL, python-docx, python-pptx ve CSV dışa aktarımında Türkçe ve Orta Avrupa karakterleri. |
photos | reporter, scribe | Unsplash'te stok fotoğraf bulmak ve künyesiyle birlikte çalışma alanına kaydetmek. |
Bilgi ve web
| Skill | Sahibi | Ne öğretir |
|---|---|---|
documents | librarian | Çalışma alanındaki belgelerde ne yazdığını bilgi dizininden, dosya ve sayfa göstererek cevaplamak. |
web-research | librarian | Açık web'de araştırma yapmak; her iddia için URL'yi ve tarihi vermek. |
Hesaplar ve gönderim
| Skill | Sahibi | Ne öğretir |
|---|---|---|
google | secretary | Kendi Google Workspace'inizi okumak (takvim, Gmail, Drive, Sheets); yalnızca yazma açıksa ve siz onaylarsanız taslak ya da kayıt oluşturmak; hiçbir zaman göndermemek. |
mail | courier | Hazır bir dosyayı ya da kısa bir mesajı, siz onayladıktan sonra, sizin verdiğiniz adreslere e-postayla göndermek. |
notify | courier | Siz onayladıktan sonra ayarladığınız Telegram'a ya da Slack'e kısa bir mesaj göndermek. |
Preset'ler
Yukarıdaki sahipler birer preset'tir. Her preset bir anahtar, bir görünen ad, bir yetki kümesi ve tek cümlelik bir ipucundan oluşur.
| Anahtar | Ad |
|---|---|
analyst | Data Analyst |
spreadsheet | Spreadsheet Builder |
visualizer | Chart Designer |
reporter | Report Writer |
scribe | Document and Deck Writer |
librarian | Librarian |
pdf_operator | PDF Operator |
courier | Courier |
secretary | Secretary |
github | GitHub Clerk |
coder | Code Engineer |
investigator | Incident Investigator |
Bir preset ancak ihtiyaç duyduğu şey ayarlarda açıksa ekipte yer alır: Courier için e-posta ya da bir sohbet kanalı, Secretary için bir Google servisi, GitHub Clerk için bir token ayarlanmış olmalıdır. Ana ajan main preset'idir ve hiç skill'i yoktur. Ekibin sizin makinenizde nasıl kurulduğunu ivralo agents gösterir.
Burada olmayanlar
Gelen skill'lerin hiçbiri bir uygulama framework'ünü, UI kütüphanesini ya da veri katmanını öğretmez; biri böyle bir framework'ün adını geçirirse bir test build'i kırar. Projenizin framework kuralları local raftaki kendi skill'inizde yer alır. Bkz. Skill yazmak.