Skills For Real Engineers Tam Kılavuz: Matt Pocock'un AI Agent Beceri Kütüphanesi

Skills For Real Engineers nedir

Tek cümleyle: Skills For Real Engineers (repo adı Matt Pocock Skills), Matt Pocock'un profesyonel mühendisler için hazırladığı, günlük .claude dizini pratiğinden çıkan bir AI Agent beceri kütüphanesidir.

Konumlandırması nettir; vibe coding oyuncağı değil, “gerçek mühendislik yapmak” için günlük bir araç kutusudur. Yazarın kendi ifadesiyle bu beceriler, Claude Code, Codex gibi kodlama agent'larında tekrar tekrar gördüğü yaygın başarısızlık kalıplarını düzeltmek için üretilmiştir.

GSD ve BMAD'den farkı

GSD, BMAD, Spec-Kit gibi yöntemler süreci “devralmaya” çalışır. Devralırken kontrolü de elinizden alır; süreçte bir sorun çıktığında yerini bulmak zorlaşır. Skills For Real Engineers tam tersi bir yol izler:

• Küçük ve yalın: Her beceri bağımsız çalışır; her şeyi kapsayan tek bir çerçeve yoktur.
• Kompoze edilebilir: İhtiyaca göre seçilir, serbestçe kırpılır ve kendi reponuza uyarlanır.
• Hacklenebilir: Beceriler reponuzdaki sıradan dosyalardır; anlamadığınız yeri değiştirirsiniz.
• Modelden bağımsız: Belli bir modele bağlı değildir; Claude, Codex, Cursor gibi araçlarla kullanılabilir.
• Mühendislik doğalı: Prompt hilesi yığını yerine The Pragmatic Programmer, Domain-Driven Design gibi klasik mühendislik ilkelerine dayanır.

Ürün konumlandırması

Gerçek mühendislik alışkanlığı olan geliştiricilere yöneliktir: statik tipler, otomatik testler, kırmızı-yeşil-refactor gibi gerçek geri bildirimlerle agent'ı kısıtlar ve “körlemesine uçmaktan” uzak tutar. Beceri kütüphanesi barındırma hizmeti sunmaz ve mimariyi sizin yerinize seçmez; yalnızca yeniden kullanılabilir diyalog ve süreç arayüzleri sağlar.

Temel işlevler

Beceriler, agent'a eğik çizgi komutları biçiminde sunulur; birkaç gruba ayrılır.

Gereksinim hizalama

• /grill-me: Yüksek yoğunluklu soru oturumuyla kodlamadan önce gereksinimleri ve karar dallarını tamamen netleştirir; kod dışı senaryolarda da kullanılabilir.
• /grill-with-docs: Grilling temelinde proje paylaşılan dilini ve mimari karar kayıtlarını (ADR) birlikte oluşturur.
• /zoom-out: Agent'ın yerel koddan çıkıp sistemi bütünsel bakışla açıklamasını ister.

Geliştirme ve doğrulama

• /tdd: Agent'ı kırmızı-yeşil-refactor döngüsünde çalıştırır; özellikleri veya hata düzeltmelerini dikey dilimlerle adım adım inşa eder.
• /diagnose: Standartlaştırılmış tanılama döngüsü: yeniden üret → minimize et → hipotez kur → enstrümante et → düzelt → regresyon testi yap.
• /prototype: Tasarımı doğrulamak için hızlıca çalışan bir terminal prototipi veya birden çok UI varyantı oluşturur.

Görev ve planlama

• /triage: Durum makinesiyle Issue'ları önceliklendirip atar; özel etiket sözlüğünü destekler.
• /to-prd: Geçerli konuşma bağlamını otomatik olarak PRD'ye dönüştürür ve GitHub Issue olarak gönderir.
• /to-issues: Planı veya PRD'yi bağımsız olarak sahiplenilebilen dikey dilim görevlerine böler.

Mimari ve iş birliği

• /improve-codebase-architecture: CONTEXT.md ve ADR'ye dayanarak modül derinleştirme fırsatlarını tespit eder, mimari çamur yumağını yönetir.
• /caveman: Aşırı sıkıştırılmış iletişim modudur; teknik hassasiyeti korurken yaklaşık %75 token tüketimini azaltır.
• /handoff: Geçerli oturumu devir belgesine sıkıştırır; başka agent'lar kesintisiz devam edebilir.
• /teach: Geçerli dizini durum bilgisine sahip bir öğretim alanı olarak kullanır; yeni becerileri veya kavramları birden çok oturumda öğretir.
• /write-a-skill: Belirli bir yapıya göre yeni beceri oluşturur; kademeli açıklamayı ve kaynak paketlemeyi destekler.

Paylaşılan dil mekanizması

CONTEXT.md ile proje terim sistemi kurmak, bu beceri setinde yazarın en çok önemsediği hamledir. Yazarın gözlemi şudur: Agent genellikle doğrudan projeye bırakılır, ilerledikçe sektör jargonunu tahmin etmeye çalışır; böylece 1 kelimeyle anlatılabilecek bir şeyi 20 kelimeyle ifade eder.

Örnek: “Bir kursun bir section'ındaki bir lesson'ın 'gerçek' yapılmasıyla ilgili sorun” ifadesini “materialization cascade'te sorun var” biçimine dönüştürmek, tek cümleyle büyük bir açıklama maliyetini ortadan kaldırır ve bu yalınlık oturumdan oturuma bileşik kazanç sağlar. Paylaşılan dil ayrıca şunları getirir: değişken, fonksiyon ve dosya adları tutarlı olur; kod tabanı agent için daha kolay gezinilir; agent düşünürken daha az token harcar.

Skills For Real Engineers nasıl kullanılır

İki giriş yolu vardır; bunlar iki felsefeye karşılık gelir ve yalnızca biri seçilmelidir.

Yol 1: Claude Code eklentisi

• Tüm beceri seti, yönetilen salt-okunur bir paket olarak kurulur; yazar sürüm yayınladığında otomatik güncellenir, yani fork yerine “abonelik” gibidir.
• Claude Code resmi marketinde mevcuttur; önce kaynak eklemeye gerek yoktur, güncellemeler kendiliğinden gelir.
• Yerel Codex eklentisi yol haritasındadır (bkz. .agents/adr/0002-ship-as-a-claude-code-plugin.md).

Yol 2: skills yükleyicisi

npx skills@latest add mattpocock/skills komutunu çalıştırın, hedef agent'ı seçin ve /setup-matt-pocock-skills öğesini işaretleyin. Yükleyici becerileri ve hangi kodlama agent'larına kurulacağını seçmenize olanak tanır; beceriler reponuza sıradan dosyalar olarak yazılır, size aittir ve düzenlenebilir, arka planda kendiliğinden güncellenmez; istediğinizde npx skills update ile son değişiklikleri çekersiniz.

Not: Her iki yolu aynı anda kurmak her becerinin iki kopya olmasına yol açar.

Başlatma ve günlük ritim

1. Agent içinde /setup-matt-pocock-skills komutunu her repo için bir kez çalıştırın. Size şunları sorar: hangi Issue izleyiciyi kullanacağınız (GitHub, Linear veya yerel dosyalar); triage sırasında biletlere hangi etiketleri uygulayacağınız (/triage bu etiketlere bağlıdır); oluşturulan belgeleri nereye kaydedeceğiniz.
2. Her değişiklikten önce /grill-me veya /grill-with-docs ile gereksinimleri hizalayın.
3. Geliştirme sırasında kaliteyi güvence altına almak için /tdd kullanın.
4. Hata ile karşılaştığınızda /diagnose ile standart tanılamayı başlatın.
5. Mimari bakımda, kod çürümesini önlemek için düzenli olarak /improve-codebase-architecture çalıştırın.

Tüm kurulum ve yapılandırma yaklaşık 30 saniyede tamamlanabilir; GitHub, Linear veya yerel dosyalar Issue izleyici olarak desteklenir.

Kullanım senaryoları

• Gereksinim hizalama ve planlama: Proje başlangıcında veya işlev değişikliğinden önce /grill-me veya /grill-with-docs ile agent'la yüksek yoğunluklu soru oturumu yaparak gereksinimler, karar dalları ve alan terimleri üzerinde tam mutabakat sağlayın.
• Test güdümlü geliştirme: Kod kalitesinin kritik olduğu senaryolarda /tdd ile agent'ı kırmızı-yeşil-refactor döngüsünde çalıştırın; özellikleri veya hata düzeltmelerini dikey dilimlerle adım adım inşa edin, böylece her değişiklik otomatik testlerle korunur.
• Karmaşık hata tanılama: Yeniden üretilmesi zor performans gerilemeleri veya mantık hatalarında /diagnose ile tam tanılama döngüsünü işletin.
• Sürekli mimari yönetişim: Büyük ve uzun ömürlü kod tabanlarında düzenli olarak /improve-codebase-architecture çalıştırın; CONTEXT.md ve ADR'ye dayanarak modül derinleştirme fırsatlarını tespit edin, agent'ın çürümeyi hızlandırmasını önleyin.
• Oturumlar arası iş birliği: /handoff ile oturumu sıkıştırın, /caveman ile token tüketimini düşürün; uzun görevler ve çok kişili/çok agent'lı devirler için uygundur.

Avantajlar

• Hafif ve kompoze edilebilir: Ağır çerçeveleri reddeder; her beceri bağımsız çalışır, serbestçe kırpılıp uyarlanabilir.
• Modelden bağımsız: Claude, Codex, Cursor gibi araçlarla kullanılabilir.
• Mühendislik doğalı: Prompt hilelerinden değil, klasik mühendislik ilkelerinden beslenir.
• Paylaşılan dil mekanizması: CONTEXT.md, agent iletişim maliyetini ve token tüketimini belirgin biçimde azaltır.
• Geri bildirim döngüsü: Statik tipler, otomatik testler, kırmızı-yeşil-refactor gibi gerçek geri bildirimleri vurgular.
• Kolay uyarlanır: skills yolunda beceriler, reponuzdaki düzenlenebilir dosyalardır.

Sınırlamalar

• Bir beceri setidir, uçtan uca süreç yöneticisi değildir; paylaşılan dil ve ADR disiplini olmayan ekipler CONTEXT.md ile karar kayıtlarını kendileri sürdürmelidir.
• /triage etiket sistemi, başlatma sırasındaki yapılandırmaya bağlıdır; yanlış yapılandırma önceliklendirme sonuçlarını etkileyebilir.
• İki kurulum yolu birbirini dışlar; karışık kurulum yinelenen becerilere yol açar.
• Yerel Codex eklentisi henüz yol haritasındadır; Codex kullanıcıları şu anda beceri dosyası kurulum yolunu kullanır.
• Belirli destek kapsamı, komut ayrıntıları ve güncelleme temposu değişebilir.

Fiyat ve kullanılabilirlik doğrulama notu

Bu olgu setinde herhangi bir fiyat, abonelik ücreti veya lisans koşulu bilgisi verilmediğinden tahmin yürütmüyoruz. Ücretli olup olmadığı, lisans biçimi, kullanılabilir kurulum kanalları ve güncel sürüm durumu için karar vermeden önce lütfen doğrudan ürün resmi sayfası https://github.com/mattpocock/skills ile kullandığınız agent'ın resmi eklenti marketi sayfasını kontrol edin.

Sık sorulan sorular (SSS)

Belirli bir modele bağlı mı?

Hayır. Resmî ifade modelden bağımsız olduğu yönündedir; Claude, Codex, Cursor gibi araçlarla kullanılabilir.

Kurulumdan hemen sonra kullanılabilir mi?

Hayır, başlatma gerekir. Lütfen agent içinde /setup-matt-pocock-skills komutunu bir kez çalıştırın; Issue izleyiciyi, önceliklendirme etiketlerini ve belge dizinini yapılandırın. Ardından /triage gibi beceriler sizin kurallarınıza göre çalışabilir.

Eklentiyi mi yoksa yükleyiciyi mi seçmeliyim?

Yazarın güncellemelerini takip etmek ve salt-okunur yönetilen paketi kabul etmek istiyorsanız Claude Code eklentisini seçin; dosyaların sahibi olup düzenlemek ve güncelleme zamanlamasını kendiniz belirlemek istiyorsanız npx skills@latest add mattpocock/skills kullanın. İkisini aynı anda kurmayın.

GSD ve BMAD ile çakışır mı?

Yazarın tasarım niyeti alternatif bir düşünce sunmaktır: GSD, BMAD, Spec-Kit süreci devralarak yardımcı olur, dolayısıyla kontrolü de elinizden alır ve süreç içindeki sorunları çözmeyi zorlaştırır; bu beceri seti ise küçük, kompoze edilebilir ve hacklenebilir kalmayı seçer. Birlikte kullanılıp kullanılmayacağı ekibinizin disiplinine bağlıdır.

İlk olarak hangi beceriyi denemek en mantıklı?

Yazar, /grill-with-docs öğesinin muhtemelen tüm repodaki en güçlü teknik olduğunu düşünüyor: hem soru oturumu yapar, hem sizinle birlikte paylaşılan dil kurar, hem de açıklanması zor kararları ADR'ye yazar.

Alternatifler

• GSD, BMAD, Spec-Kit: Geliştirme sürecini devralmaya çalışan ağır çerçeveler; daha az kontrol sağlar ve süreç sorunlarının yerini bulmak daha zordur.
• “一泽 Eze”nin açık kaynak Agent Skill'i: “İnternete nasıl erişileceğini düşünmeye” odaklanır.
• Jesse Vincent'ın açık kaynak Agentic beceri çerçevesi ve yazılım geliştirme yöntemi eklentisi.
• AI kodlama asistanları için tasarlanmış açık kaynak AI tasarım Skill'i.
• Genel yaklaşım: kendi .claude veya proje düzeyinde beceri dosyalarınızı sürdürüp ekip alışkanlıklarına göre birleştirmek.

Birincil kaynaklar

• Ürün resmi sayfası ve reposu: https://github.com/mattpocock/skills

Bu beceri setindeki değişiklikleri ve yazarın yeni becerilerini takip etmek isterseniz, yaklaşık 60.000 geliştiricinin abone olduğu bültenine katılabilirsiniz.