본문으로 건너뛰기
cccskills
무료GitHub에 공개

code-review

Systematic code review skill covering both requesting a review (pre-commit checklist) and receiving and responding to review feedback. Checks code quality, security, test coverage, architectural alignment, and documentation before any code is committed.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(1)

  • SKILL.md6.0 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

<!-- TÜRKÇE AÇIKLAMA ─────────────── Bu skill, yazılan kodun commit'lenmeden veya push'lanmadan önce sistematik biçimde incelenmesini sağlar. Hem "review isteği hazırlama" (requesting) hem de "review feedback'ini yanıtlama" (receiving) süreçlerini kapsar. Kod kalitesi, güvenlik, test coverage, mimari uyum ve dokümantasyon kontrol edilir. NE ZAMAN: Commit öncesi (kendi kendine review), PR açmadan önce, büyük değişikliklerde. ÇIKTI: Review checklist raporu, yanıtlanmış feedback listesi, düzeltilmiş kod. -->

Code Review Skill

İki Mod

Bu skill iki farklı durumda devreye girer:

ModNe ZamanNe Yapar
A — Pre-Commit ReviewCommit öncesi, kendi kendinleChecklist çalıştır, commit'e hazır mı karar ver
B — Feedback ResponseBaşkası review yaptı, feedback geldiHer yorumu sınıflandır, yanıtla, düzelt

MOD A: Pre-Commit Review (Kendi Kendine)

1. Diff'i Çek ve Analiz Et

git diff HEAD          # staged olmayan değişiklikler
git diff --staged      # staged değişiklikler
git diff main...HEAD   # branch'in tüm değişiklikleri

Her değişen dosyayı gözden geçir. PR'da yorum almak istemediğin şeyleri şimdi düzelt.


2. Checklist — Sırayla Uygula

🔴 Kritik (bunlar varsa commit yok)

  • Hardcoded secret, API key, password var mı?
    git grep -i "password\|secret\|api_key\|token" -- '*.ts' '*.js' '*.py' '*.env'
    
  • SQL injection vektörü var mı? (raw query + user input)
  • Authentication veya authorization bypass riski var mı?
  • Testler geçiyor mu?
    npm test
    
  • Build kırılıyor mu?
    npm run build
    
  • Başka modülleri kıran breaking change var mı? (notify et)

🟡 Önemli (bunlar varsa ya düzelt ya bilinçli geç)

  • Yeni public fonksiyon/endpoint'in JSDoc veya tipi var mı?
  • Hata yönetimi yapıldı mı? (try-catch, error boundary, 404/500 handling)
  • Konsola debug log bırakıldı mı? (console.log, print, debugger)
  • Yeni env variable varsa .env.example'a eklendi mi?
  • Herhangi bir TODO veya FIXME bırakıldı mı? (bilinçliyse ticket numarası ekle)
  • Code coverage düştü mü?
    npm test -- --coverage
    
  • Yeni bağımlılık eklendiyse güvenlik kontrolü yapıldı mı?
    npm audit
    

🔵 Kalite (mükemmel kod için)

  • Fonksiyon isimleri ne yaptıklarını anlatıyor mu?
  • Bir fonksiyon birden fazla şey yapıyor mu? (bölmeli)
  • Kod kopyalandı mı? (copy-paste → extract to function)
  • Magic number veya string var mı? (constant'a extract et)
  • Tip kullanımı yeterince katı mı? (any var mı?)

3. Review Kartı Oluştur

Commit mesajının yanına veya PR açıklamasına eklemek için:

## Self-Review Özeti

**Değişiklik:** <ne yaptım, neden>
**Test Durumu:** ✅ Tüm testler geçiyor / ⚠️ X test skip edildi (gerekçe: ...)
**Checklist:**
  - 🔴 Kritik: Temiz
  - 🟡 Önemli: [varsa not]
  - 🔵 Kalite: [varsa not]

**Özellikle dikkat çekilmek istenen:**
- <reviewer'ın bakmasını istediğin yer>

**Bilinçli atlanan kısayollar (deliberate shortcuts):**
- <varsa gerekçesiyle>

MOD B: Feedback Response (Başkasının Review'ı)

1. Her Yorumu Sınıflandır

Gelen her review yorumu için:

[KRITIK]  → Blokerlik eder, merge edilemez — hemen düzelt
[ÖNEMLI]  → Güçlü öneri, iyi gerekçen yoksa uygula
[ÖNERI]   → Takdire bağlı, açık tartışma gerekebilir
[SORU]    → Bilgi isteği — açıkla veya kod ile düzelt
[NIT]     → Küçük stil/isimlendirme, senin tercihine bağlı

2. Her Yorumu Yanıtla

Hiçbir yorum cevapsız bırakılmaz.

Yorum: "Bu fonksiyonun timeout'u yok, servis yanıt vermezse ne olur?"
→ Sınıf: [KRİTİK]
→ Cevap: "Haklısın. 5 saniyelik timeout + retry ekledim. T3 commit'inde görebilirsin."
→ Aksiyon: Düzeltildi ✅

Yorum: "Belki burada Map yerine Set kullanabilirsin"
→ Sınıf: [ÖNERİ]
→ Cevap: "Set burada doğru olur, key'e ihtiyacımız yok. Değiştirdim."
→ Aksiyon: Düzeltildi ✅

Yorum: "Bu isimlendirme bana semantik gelmiyor"
→ Sınıf: [NIT]
→ Cevap: "Anladım mantığını ama `processUserData` yerine `normalizeUserInput` daha açıklayıcı — değiştirdim."
→ Aksiyon: Düzeltildi ✅

3. Düzeltmeleri Grupla ve Commit At

Her düzeltme grubunu ayrı bir commit olarak at (github skill commit standardına göre):

# Her düzeltme ayrı commit
git commit -m "fix: add timeout and retry to userService.fetchProfile"
git commit -m "refactor: use Set instead of Map in deduplication logic"
git commit -m "refactor: rename processUserData to normalizeUserInput"

4. Re-Review İste

Tüm düzeltmeler tamamlandığında review'ı güncelle:

## Düzeltme Özeti

Toplam yorum: 8
- Düzeltildi: 7
- Reddedildi (gerekçeyle): 1 → "NIT yorumu: mevcut isimlendirme proje konvansiyonuyla uyumlu"

Önemli değişiklikler:
- Timeout + retry mekanizması eklendi (güvenlik açısından kritik)
- 2 refactor (netlik için)

Re-review için hazır.

Kurallar

  • Kırmızı item varsa commit yok. İstisna yok.
  • "Sonra düzeltilir" yasak. Ya şimdi düzelt ya da ticket aç, ticket numarasını koda ekle.
  • Her review yorumu yanıtlanır. "Tamam" veya sessizlik kabul edilmez — ya "düzelttim" ya "katılmıyorum, çünkü..."
  • Review kendini kandırmak için değil, kodu korumak için. Checklist'i hızlıca geçiştirme.
  • Gelen feedback kişisel değil. Yorum koda yapılıyor, sana değil.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Before committing to an implementation plan, run this skill to stress-test the proposed architecture. Catches over-engineering, circular dependencies, missing failure modes, security gaps, and scalability cliffs — before any code is written. Acts as a "second eye" on the plan.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

omergocmen/vibe-coder-kit942026년 6월 4일 업데이트

Periodically scan project dependencies for security vulnerabilities, outdated packages, and unused dependencies. Produces a prioritized action report. Run before every major release and at least once per month.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

omergocmen/vibe-coder-kit942026년 6월 4일 업데이트

After any significant code change — new feature, API modification, config change, or architectural refactor — run this skill to identify which documentation files are now stale and update them. Keeps docs and code from drifting apart.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

omergocmen/vibe-coder-kit942026년 6월 4일 업데이트

github

무료

Manages all git operations (commit, push, branch management, PR creation) in a standardized, safe, and consistent way. Automatically runs the code-review skill before any commit. Enforces Conventional Commits standard. Handles the full lifecycle: branch → review → commit → push → PR.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

omergocmen/vibe-coder-kit942026년 6월 4일 업데이트

When something breaks in production: triage the severity, gather evidence, identify root cause, deploy a fix or mitigation, and write a post-mortem. Provides a calm, structured process for high-stress moments.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

omergocmen/vibe-coder-kit942026년 6월 4일 업데이트

Use this skill whenever you learn something important during a conversation: a key architectural decision, a project-specific convention, a bug root-cause, a 3rd-party API quirk, or any fact that would help a future agent avoid re-doing the same research. Writes structured entries to the project's knowledge base so that context persists across conversations and agents.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

omergocmen/vibe-coder-kit942026년 6월 4일 업데이트

omergocmen의 스킬 모두 보기

이 스킬의 문제 신고