--- name: pilot-1-code-formatter description: Automatically format code files using the appropriate formatter based on file type, providing clear feedback on changes made allowed-tools: Read, Write, Edit, Bash, Glob, Grep, Task, TodoWrite x- : null --- ## Kanitsal Cerceve (Evidential Frame Activation) Kaynak dogrulama modu etkin. --- --- beceri_adi: "code-formatter", kategori: "foundry", surum: "1.0.0", katman: "L1", pilot_id: "PILOT-CF-001" --- --- cerceve: "Compositional", kaynak: "German", bilissel_zorlama: "Build from primitives?" --- --- anahtar_kelimeler: ["code-formatter", "format code", "prettier", "black", "rustfmt"], baglamlar: ["user needs code formatting", "pre-commit formatting", "style consistency"] anti_kaliplar: ["linting only", "syntax checking without format", "compile errors"], alternatif_beceriler: ["linter", "syntax-checker", "compiler-diagnostics"] --- --- # Kod Formatlayici (Code Formatter) ## Genel Bakis (Overview) ## Ne Zaman Kullanilmali (When to Use) - Commit oncesi kod formatlama gerektiginde - Projeler arasi tutarli stil saglanmasi gerektiginde - Dil-spesifik formatlama standartlari otomatik uygulanmak istendiginde ## Ne Zaman KULLANILMAMALI (When NOT to Use) - Sadece linting gerektiginde -> linter becerisi kullanin - Syntax hatalari duzeltilecekse -> syntax-checker kullanin - Derleme hatalari varsa -> once hatalari duzeltin --- --- ## Adim 1: Girdi Dosyasini Dogrula (Validate Input File) **Eylem**: Belirtilen dosyanin var oldugunu ve erisilebilir oldugunu dogrula. ```bash # Dosya var mi kontrol et if [ ! -f "$FILE_PATH" ]; then echo "Hata: Dosya '$FILE_PATH' bulunamadi. Yolu kontrol edip tekrar deneyin." exit 1 fi # Dosya okunabilir mi kontrol et if [ ! -r "$FILE_PATH" ]; then echo "Hata: '$FILE_PATH' okunamiyor. Duzeltmek icin: chmod +r '$FILE_PATH'" exit 2 fi # Dosya boyutu kontrol et (max 10MB) file_size=$(stat -c%s "$FILE_PATH" 2>/dev/null || stat -f%z "$FILE_PATH") if [ $file_size -gt 10485760 ]; then echo "Uyari: Dosya $(($file_size / 1024 / 1024))MB (max: 10MB). Devam edilsin mi? (y/n)" read -r response if [[ "$response" != "y" ]]; then exit 0 fi fi ``` **Basari Kriterleri**: **Hata Yonetimi**: - Dosya bulunamadi (exit 1) -> Yol ile hata goster, iptal et - Izin reddedildi (exit 2) -> chmod onerisi ile hata goster, iptal et - Dosya cok buyuk -> Kullaniciyi uyar, devam veya iptal izni ver --- ## Adim 2: Dosya Dilini ve Formatlayiciyi Tespit Et (Detect Language and Formatter) **Eylem**: Dosya uzantisindan programlama dilini belirle ve uygun formatlayiciyi sec. ```bash # Uzantiya gore dili tespit et case "$FILE_PATH" in *.js|*.jsx|*.ts|*.tsx|*.json) FORMATTER="prettier" FORMATTER_CMD="prettier --write" CHECK_CMD="prettier --check" ;; *.py) FORMATTER="black" FORMATTER_CMD="black" CHECK_CMD="black --check" ;; *.rs) FORMATTER="rustfmt" FORMATTER_CMD="rustfmt" CHECK_CMD="rustfmt --check" ;; *) echo "Hata: Desteklenmeyen dosya tipi '${FILE_PATH##*.}'" echo "Desteklenenler: .js, .jsx, .ts, .tsx, .json (Prettier), .py (Black), .rs (rustfmt)" exit 3 ;; esac echo "Tespit edilen dil: ${FILE_PATH##*.} -> $FORMATTER kullaniliyor" ``` --- ## Adim 3: Formatlayici Kurulumunu Kontrol Et (Check Formatter Installation) **Eylem**: Gerekli formatlayicinin kurulu oldugunu dogrula. ```bash # Formatlayici var mi kontrol et if ! command -v $FORMATTER &> /dev/null; then echo "Hata: $FORMATTER kurulu degil." # Kurulum talimatlari sagla case "$FORMATTER" in prettier) echo "Kurmak icin: npm install -g prettier" ;; black) echo "Kurmak icin: pip install black" ;; rustfmt) echo "Kurmak icin: rustup component add rustfmt" ;; esac exit 4 fi ``` --- ## Adim 4: Syntax Hatalari Kontrol Et (Check for Syntax Errors) **Eylem**: Dosyayi degistirmeden once syntax hatalarini tespit etmek icin kontrol modunda calistir. ```bash # Kontrol oncesi yedek al cp "$FILE_PATH" "${FILE_PATH}.backup" # Syntax hatalari kontrol et $CHECK_CMD "$FILE_PATH" > /tmp/format-check.txt 2>&1 check_exit=$? if [ $check_exit -ne 0 ]; then echo "Syntax hatalari tespit edildi:" cat /tmp/format-check.txt echo "" echo "Once syntax hatalarini duzeltin mi? (y/n)" read -r response if [[ "$response" != "y" ]]; then rm "${FILE_PATH}.backup" exit 0 else rm "${FILE_PATH}.backup" exit 5 fi fi ``` --- ## Adim 5: Formatlayiciyi Calistir ve Degisiklikleri Raporla (Run Formatter and Report) **Eylem**: Formatlayiciyi zaman asimi ile calistir ve nelerin degistigini raporla. ```bash # Formatlayiciyi 60s zaman asimi ile calistir timeout 60s $FORMATTER_CMD "$FILE_PATH" > /tmp/format-output.txt 2>&1 exit_code=$? if [ $exit_code -eq 124 ]; then echo "Hata: Formatlayici 60 saniye sonra zaman asimina ugradi." mv "${FILE_PATH}.backup" "$FILE_PATH" # Yedegi geri yukle exit 6 elif [ $exit_code -ne 0 ]; then echo "Hata: Formatlayici cikis kodu $exit_code ile basarisiz oldu" cat /tmp/format-output.txt mv "${FILE_PATH}.backup" "$FILE_PATH" # Yedegi geri yukle exit 7 fi # Degisiklikleri hesapla changes=$(diff -u "${FILE_PATH}.backup" "$FILE_PATH" | wc -l) # Sonuclari raporla if [ $changes -eq 0 ]; then echo "Formatlama degisikligi gerekmiyor: $FILE_PATH" else echo "Formatlandi: $FILE_PATH ($FORMATTER ile)" echo " Degisiklikler: $(($changes / 2)) satir degistirildi" echo " Yedek: ${FILE_PATH}.backup" fi # Temizlik rm -f /tmp/format-check.txt /tmp/format-output.txt exit 0 ``` --- --- birincil: "Formatlama basariyla tamamlandi", kalite: "Cikti dil stil kilavuzuna uygun", dogrulama: "Yedek olusturuldu ve degisiklik sayisi raporlandi" ## Hata Kodlari ve Kurtarma (Error Codes & Recovery) | Kod | Hata | Kullanici Mesaji | Kurtarma Stratejisi | |-----|------|------------------|---------------------| | 1 | Dosya bulunamadi | "Hata: Dosya '[YOL]' bulunamadi." | Yolu kontrol et, tekrar dene | | 2 | Izin reddedildi | "Hata: '[YOL]' okunamiyor. chmod +r ile duzelt" | Izinleri duzelt, tekrar dene | | 3 | Desteklenmeyen tip | "Hata: Desteklenmeyen dosya tipi '.ext'" | Desteklenen tip kullan | | 4 | Formatlayici kurulu degil | "Hata: [FORMATLAYICI] kurulu degil" | Formatlayiciyi kur, tekrar dene | | 5 | Syntax hatasi | "Syntax hatalari tespit edildi: [HATALAR]" | Syntax duzelt, tekrar dene | | 6 | Zaman asimi | "Hata: Formatlayici 60s sonra zaman asimina ugradi" | Kucuk dosya kullan | | 7 | Formatlayici hatasi | "Hata: Formatlayici basarisiz: [CIKTI]" | Logları kontrol et | --- --- memory_mcp: "Yurutme sonuclarini ve kaliplari sakla", araclar: ["mcp__memory-mcp__memory_store", "mcp__memory-mcp__vector_search"] --- --- kalip: "skills/foundry/code-formatter/{project}/{timestamp}", sakla: ["executions", "decisions", "patterns"], getir: ["similar_tasks", "proven_patterns"] KIM: "code-formatter-{session_id}", NE_ZAMAN: "ISO8601_timestamp", PROJE: "{project_name}", NEDEN: "skill-execution" --- --- agent_olusturma: "Task() ile agent olustur", kayit_dogrulama: "Sadece kayitli agentlari kullan", todowrite_cagrildi: "TodoWrite ile ilerleme takip et", is_delegasyonu: "Uzman agentlara delege et" --- --- --- ---