Matt Pocock's Becerilerini Kur

Mühendislik becerilerinin varsaydığı repo başına konfigürasyonu hazırla:

• Issue tracker — sorunların yaşadığı yer (varsayılan olarak GitHub; yerel markdown da kutudan çıktığı gibi desteklenir)
• Triage labels — beş kanonik triage rolü için kullanılan stringler
• Domain docs — CONTEXT.md ve ADR'lerin yaşadığı yer ve onları okumak için tüketici kuralları

Bu, deterministik bir script değil, prompt güdümlü bir beceridir. Keşfet, bulduklarını sun, kullanıcıya onayla, sonra yaz.

Süreç

1. Keşfet

Başlangıç durumunu anlamak için mevcut repo'ya bak. Var olanları oku; varsayımda bulunma:

• git remote -v ve .git/config — bu bir GitHub repo'su mu? Hangisi?
• AGENTS.md ve CLAUDE.md repo kökünde — biri var mı? ## Agent skills bölümü zaten var mı?
• CONTEXT.md ve CONTEXT-MAP.md repo kökünde
• docs/adr/ ve src/*/docs/adr/ dizinleri
• docs/agents/ — bu becerinin önceki çıktısı zaten var mı?
• .scratch/ — yerel markdown issue tracker kuralının zaten kullanımda olduğunun işareti

2. Bulguları sun ve sor

Neyin mevcut olduğunu ve neyin eksik olduğunu özetle. Sonra kullanıcıyı üç karardan birer birer yönlendir — bir bölüm sun, kullanıcının cevabını al, sonra sıradakine geç. Her üçünü birden dökme.

Kullanıcının bu terimlerin anlamını bilmediğini varsay. Her bölüm kısa bir açıklamayla başlar (nedir, neden bu beceriler buna ihtiyaç duyar, farklı seçim yaparsanız ne değişir). Sonra seçenekleri ve varsayılanı göster.

Bölüm A — Issue tracker.

Açıklama: "Issue tracker", bu repo için sorunların yaşadığı yerdir. to-issues, triage, to-prd ve qa gibi beceriler buradan okur ve buraya yazarlar — gh issue create mi çağıracaklarını, markdown dosyasını .scratch/ altına mı yazacaklarını yoksa tanımladığınız başka bir workflow'u mu izleyeceklerini bilmeleri gerekir. Bu repo için çalışmayı takip ettiğiniz yeri seçin.

Varsayılan tutum: bu beceriler GitHub için tasarlanmıştır. Eğer bir git remote GitHub'a işaret ediyorsa, onu öneri olarak sun. Eğer git remote GitLab'a işaret ediyorsa (gitlab.com veya self-hosted host), GitLab'ı öneri olarak sun. Aksi halde (veya kullanıcı tercih ederse), şu seçenekleri sun:

• GitHub — sorunlar repo'nun GitHub Issues'inde yaşar (gh CLI kullanır)
• GitLab — sorunlar repo'nun GitLab Issues'inde yaşar (glab CLI kullanır)
• Local markdown — sorunlar bu repo'da .scratch/<feature>/ altında dosya olarak yaşar (solo projeler veya remote'u olmayan repo'lar için iyidir)
• Other (Jira, Linear, vb.) — kullanıcıdan workflow'u bir paragrafta açıklamasını isteyin; beceri bunu serbest metin olarak kaydedecektir

Bölüm B — Triage label vocabulary.

Açıklama: triage becerisi gelen bir issue'yu işlediğinde, onu bir state machine'de hareket ettirir — değerlendirmeye ihtiyaç duyar, rapor veren için bekler, bir AFK ajanının alması için hazır, insan için hazır veya düzeltilmeyecek. Bunu yapmak için, gerçekten yapılandırdığınız stringlerle eşleşen label'ları (veya issue tracker'ınızdaki eşdeğerini) uygulaması gerekir. Eğer repo'nuz zaten farklı label adları kullanıyorsa (ör. needs-triage yerine bug:triage), bunları harita yapın, böylece beceri doğru olanları uygulayabilir ve kopyalar oluşturmaz.

Beş kanonik rol:

• needs-triage — bakıcı değerlendirmeye ihtiyaç duyar
• needs-info — rapor veren için bekler
• ready-for-agent — tam belirtilmiş, AFK-hazır (bir ajan bunu insan bağlamı olmadan alabilir)
• ready-for-human — insan uygulamasına ihtiyaç duyar
• wontfix — işlem yapılmayacak

Varsayılan: her rol'ün stringi adına eşittir. Kullanıcıya herhangi birini geçersiz kılmak isteyip istemediğini sorun. Eğer issue tracker'larında mevcut label yoksa, varsayılanlar iyidir.

Bölüm C — Domain docs.

Açıklama: Bazı beceriler (improve-codebase-architecture, diagnose, tdd) proje'nin domain dilini öğrenmek için CONTEXT.md dosyasını ve geçmiş mimari kararları için docs/adr/ dosyasını okurlar. Repo'nun bir global context'i mi yoksa birden fazla context'i mi olduğunu (ör. ayrı frontend/backend context'leri olan bir monorepo) bilmeleri gerekir, böylece doğru yerde bakarlar.

Layout'ı onayla:

• Single-context — repo kökünde bir CONTEXT.md + docs/adr/. Çoğu repo'su budur.
• Multi-context — kök'te CONTEXT-MAP.md işaret eden per-context CONTEXT.md dosyaları (tipik olarak monorepo).

3. Onayla ve düzenle

Kullanıcıya şunların taslağını göster:

• CLAUDE.md / AGENTS.md'den hangisinin düzenleneceğine eklenecek ## Agent skills bloğu (seçim kuralları için adım 4'e bak)
• docs/agents/issue-tracker.md, docs/agents/triage-labels.md, docs/agents/domain.md içerikleri

Yazmadan önce düzenlemesine izin ver.

4. Yaz

Düzenlenecek dosyayı seç:

• Eğer CLAUDE.md varsa, bunu düzenle.
• Aksi halde AGENTS.md varsa, bunu düzenle.
• İkisi de yoksa, kullanıcıya hangisini oluşturacağını sor — senin için seçim yapma.

CLAUDE.md zaten varken asla AGENTS.md oluşturma (veya tersi) — her zaman zaten orada olan biri'ni düzenle.

Eğer seçilen dosyada ## Agent skills bloğu zaten varsa, duplicate eklemek yerine içeriğini yerinde güncelle. Çevre bölümlerdeki kullanıcı düzenlemelerini üzerine yazma.

Blok:

## Agent skills

### Issue tracker

[sorunların takip edildiği yerin tek satır özeti]. `docs/agents/issue-tracker.md` bak.

### Triage labels

[label vocabulary'nin tek satır özeti]. `docs/agents/triage-labels.md` bak.

### Domain docs

[layout'ın tek satır özeti — "single-context" veya "multi-context"]. `docs/agents/domain.md` bak.

Sonra bu skill klasöründeki seed template'lerini başlangıç noktası olarak kullanarak üç docs dosyasını yaz:

• issue-tracker-github.md — GitHub issue tracker
• issue-tracker-gitlab.md — GitLab issue tracker
• issue-tracker-local.md — local-markdown issue tracker
• triage-labels.md — label mapping
• domain.md — domain doc consumer kuralları + layout

"Other" issue tracker'ları için, kullanıcının açıklamasını kullanarak docs/agents/issue-tracker.md dosyasını sıfırdan yaz.

5. Bitti

Kullanıcıya kurulumun tamamlandığını ve hangi mühendislik becerilerinin artık bu dosyalardan okuyacağını söyle. docs/agents/*.md dosyalarını doğrudan daha sonra düzenleyebileceklerini belirt — bu beceriyi yeniden çalıştırmak sadece issue tracker'ları değiştirmek veya sıfırdan başlamak isterlerse gereklidir.