跳到正文
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(原文)

安装前可以查看交给 AI 代理的指令内容。

<!-- 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 / 1000 字

此表单受 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-kit952026年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-kit952026年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-kit952026年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-kit952026年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-kit952026年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-kit952026年6月4日 更新

查看 omergocmen 的全部技能

报告此技能的问题