agent-skills - Yapay zeka kodlama ajanları için prodüksiyon düzeyi mühendislik becerileri koleksiyonu

• Yapay zeka kodlama ajanlarının spesifikasyon, test ve güvenlik incelemesini atlama sorununu çözmek için, Google Cloud AI direktörü Addy Osmani’nin kıdemli mühendis seviyesindeki iş akışlarını yapılandırılmış beceriler halinde paketlediği açık kaynak proje
• Geliştirme yaşam döngüsünün tamamını (tanımla→planla→inşa et→doğrula→incele→dağıt) kapsayan 7 slash komutu ve 19 beceriden oluşuyor
  • /spec ne yapılacağını tanımlar: "Koddan önce spesifikasyon"
  • /plan nasıl uygulanacağını planlar: "Küçük atomik görevlere böl"
  • /build kademeli uygulama: "Her seferinde yalnızca tek bir dilim"
  • /test çalıştığını kanıtlama: "Test kanıttır"
  • /review merge öncesi kalite kapısı: "Kod sağlığını iyileştir"
  • /code-simplify kod sadeleştirme: "Kurnazlıktan çok açıklık"
  • /ship prodüksiyona dağıtım: "Ne kadar hızlıysa o kadar güvenli"
• Duruma göre uygun beceri otomatik olarak etkinleşir. Örn. API tasarımında api-and-interface-design, UI uygulamasında frontend-ui-engineering gibi
• Google mühendislik kültürünün temel ilkeleri (Hyrum's Law, Beyonce Rule, Chesterton's Fence, Shift Left vb.) aşamalı iş akışlarına doğrudan gömülü

19 becerinin tam listesi

• Define (ne yapılacağını netleştirme)

  • idea-refine: Iraksak/yakınsak düşünmeyi yapılandırarak belirsiz fikirleri somut önerilere dönüştürür
  • spec-driven-development: Kod yazmadan önce hedefleri, komutları, yapıyı, kod stilini, testleri ve sınırları kapsayan bir PRD hazırlar

• Plan (parçalama)

  • planning-and-task-breakdown: Spesifikasyonu kabul kriterleri ve bağımlılık sırasına sahip küçük, doğrulanabilir görevlere böler

• Build (kod yazımı)

  • incremental-implementation: İnce dikey dilimler yaklaşımıyla uygula, test et, doğrula ve commit et; feature flag ve rollback dostu değişiklikleri destekler
  • test-driven-development: Red-Green-Refactor, test piramidi (80/15/5), DRY yerine DAMP ve Beyonce Rule uygular
  • context-engineering: Doğru bilgiyi doğru zamanda ajana sağlar (rules dosyaları, context packing, MCP entegrasyonu)
  • frontend-ui-engineering: Bileşen mimarisi, tasarım sistemi, durum yönetimi, responsive tasarım, WCAG 2.1 AA erişilebilirlik
  • api-and-interface-design: Sözleşme öncelikli tasarım, Hyrum's Law, One-Version Rule, hata semantiği, sınır doğrulaması

• Verify (çalıştığını kanıtlama)

  • browser-testing-with-devtools: Chrome DevTools MCP üzerinden gerçek zamanlı çalışma verileri (DOM inceleme, konsol logları, ağ izleri, performans profilleme)
  • debugging-and-error-recovery: 5 adımlı triyaj (yeniden üret→yerelleştir→daralt→düzelt→savun), stop-the-line kuralı

• Review (birleştirme öncesi kalite kapısı)

  • code-review-and-quality: 5 eksenli inceleme, değişiklik boyutu (~100 satır), önem derecesi etiketleri (Nit/Optional/FYI), inceleme hızı standartları
  • code-simplification: Chesterton's Fence, Rule of 500, doğru davranışı korurken karmaşıklığı azaltma
  • security-and-hardening: OWASP Top 10 önleme, kimlik doğrulama desenleri, secret yönetimi, bağımlılık denetimi, 3 katmanlı sınır sistemi
  • performance-optimization: Önce ölçüm yaklaşımı, Core Web Vitals hedefleri, profilleme iş akışı, bundle analizi

• Ship (dağıtım)

  • git-workflow-and-versioning: Trunk-based development, atomik commit'ler, değişiklik boyutu (~100 satır), commit-as-savepoint deseni
  • ci-cd-and-automation: Shift Left, Faster is Safer, feature flag'ler, kalite kapısı pipeline'ı
  • deprecation-and-migration: Code-as-debt zihniyeti, zorunlu/önerilen kullanımdan kaldırma yöntemleri, zombi kod temizliği
  • documentation-and-adrs: Architecture Decision Records, API dokümantasyonu, satır içi dokümantasyon standartları ('neden'i dokümante etme)
  • shipping-and-launch: Yayın öncesi kontrol listesi, feature flag yaşam döngüsü, aşamalı rollout, rollback prosedürleri, izleme kurulumu

Ajan personeleri

• Hedefli inceleme için 3 uzman persona önceden yapılandırılmış
  • code-reviewer: Kıdemli staff engineer bakış açısı; "Bir staff engineer'in onaylayacağı seviyede mi?" ölçütüyle 5 eksenli kod incelemesi
  • test-engineer: QA uzmanı bakış açısı, test stratejisi, kapsam analizi, Prove-It deseni
  • security-auditor: Güvenlik mühendisi bakış açısı, zafiyet tespiti, tehdit modelleme, OWASP değerlendirmesi

Referans kontrol listeleri

• Beceri gerektiğinde başvurduğu 4 hızlı referans materyali
  • testing-patterns.md: Test yapısı, adlandırma, mocking, React/API/E2E örnekleri, anti-pattern'ler
  • security-checklist.md: Commit öncesi kontrol, kimlik doğrulama, girdi doğrulama, header'lar, CORS, OWASP Top 10
  • performance-checklist.md: Core Web Vitals hedefleri, frontend/backend kontrol listeleri, ölçüm komutları
  • accessibility-checklist.md: Klavye navigasyonu, ekran okuyucu, görsel tasarım, ARIA, test araçları

Beceri tasarım ilkeleri

• Süreç, düzyazı değil: Beceriler ajanın izleyeceği iş akışlarıdır; adımlar, kontrol noktaları ve bitiş kriterleri içerir, referans dokümanı değildir
• Rasyonalizasyonu önleme: Her beceriye, ajanın adımları atlamak için kullandığı yaygın bahaneler ("Testleri sonra eklerim") ve bunlara karşı argümanlar gömülüdür
• Doğrulama pazarlığa kapalıdır: Tüm beceriler kanıt gereksinimleriyle (test geçişi, build çıktısı, çalışma zamanı verileri) tamamlanır; "çalışıyor gibi görünüyor" yeterli değildir
• Kademeli açığa çıkarma: SKILL.md giriş noktasıdır ve destekleyici referanslar yalnızca gerektiğinde yüklenerek token kullanımını en aza indirir

Kurulum yöntemleri (desteklenen araçlar)

• Claude Code (önerilen): /plugin marketplace add addyosmani/agent-skills ardından /plugin install agent-skills@addy-agent-skills
  • Yerel geliştirme: git clone sonrası claude --plugin-dir /path/to/agent-skills
• Cursor: Herhangi bir SKILL.md dosyasını .cursor/rules/ içine kopyalayın veya skills/ dizininin tamamına referans verin
• Gemini CLI: gemini skills install https://github.com/addyosmani/agent-skills.git
• Windsurf: Beceri içeriğini Windsurf rules ayarlarına ekleyin
• GitHub Copilot: agents/ içindeki ajan tanımlarını Copilot personası olarak, beceri içeriğini ise .github/copilot-instructions.md içinde kullanın
• Codex ve diğer ajanlar: Beceriler düz Markdown olduğundan, sistem prompt'u veya instruction dosyalarını destekleyen tüm ajanlarla uyumludur

[xguru]

Bu aralar herkesin kendi skill set’lerini paylaşması moda olmuş gibi görünüyor.

Nasıl olsa bir Markdown dosyası, bu yüzden hepsini olduğu gibi almak zorunda değilsiniz.
Ne kadar çoğalırsa token tüketimi de o kadar artıyor.
Ajanıma "bunu analiz et ve sadece gerekenleri alalım" demek daha iyi.

Böyle böyle kendi harness’inizi oluşturuyorsunuz.

[thestackai]

Evet. Bana göre hızla çoğalan açık kaynaklara ayak uydurmanın en iyi yolu bu.

[yangeok]

Sanırım speckit gibi bir şey.

[blacksocks]

Şirket içinde sadece vibe coding ile geliştirme yapmamız yönünde talimat gelince ben de çeşitli şeyler denedim; ama işin içine girince, üstün geliştirme becerilerinin tek başına yüksek kaliteyi garanti etmediğini gördüm..
Aksine, asıl önemli olanın yapay zekanın ürettiği kodu inceleyip anlama becerisi olduğunu düşünüyorum. Araçlar ne kadar iyi hale gelirse, “okuyup değerlendirme gücü”nün o kadar daha önemli olması biraz ironik.

[ragingwind]

Google Chrome ekibinin lideri Addy Osmani, Director, Google Cloud AI pozisyonuna geçti.

[xguru]

Aa, ne zaman taşındı ki. Ben de hep öyle biliyordum. Düzelttim.

[ragingwind]

Benim de artık Chrome ekibinde tanıdığım tek kişi Paul Kinlan (Chrome DevRel lideri). Zaman gerçekten akıp gidiyor.