AgentSkillsCN

structured-thinking

为复杂决策与问题解决提供思维框架。在做决策或进行设计时,主动应用此框架。

SKILL.md
--- frontmatter
name: structured-thinking
description: "Karmaşık kararlar ve problem çözümü için düşünme framework'ü. KARAR ALIRKEN veya TASARIM yaparken uygula."
allowed-tools:
  - Read
  - Grep
  - Glob

Structured Thinking

Anthropic τ-Bench araştırmasına göre, yapılandırılmış düşünme %54 accuracy artışı sağlar.

Ne Zaman Kullan?

  • Mimari karar alırken
  • 2+ alternatif varken
  • Trade-off değerlendirmesi gerektiğinde
  • Security/performance impact analizi
  • Debugging (root cause analysis)

Düşünme Framework'ü

1. Durumu Özetle

code
🎯 HEDEF: [Ne başarmaya çalışıyorum?]
📍 MEVCUT: [Şu anki durum nedir?]
🚧 KISITLAR: [Sınırlamalar neler?]

2. Alternatifleri Listele

code
ALTERNATİF A: [Açıklama]
  ✅ Artılar: ...
  ❌ Eksiler: ...
  
ALTERNATİF B: [Açıklama]
  ✅ Artılar: ...
  ❌ Eksiler: ...

3. Değerlendir

code
| Kriter | A | B |
|--------|---|---|
| Complexity | ? | ? |
| Performance | ? | ? |
| Maintainability | ? | ? |
| Security | ? | ? |
| Time to implement | ? | ? |

4. Karar Ver ve Kaydet

code
📌 KARAR: [Seçilen alternatif]
📝 GEREKÇE: [Neden bu seçildi?]
⚠️ RİSKLER: [Dikkat edilmesi gerekenler]

Örnek: Database Seçimi

code
🎯 HEDEF: User authentication için storage
📍 MEVCUT: Henüz DB yok
🚧 KISITLAR: Startup, düşük bütçe, hızlı MVP

ALTERNATİF A: PostgreSQL
  ✅ Proven, ACID, free
  ❌ Self-managed, scaling effort

ALTERNATİF B: Supabase
  ✅ Managed, auth built-in, free tier
  ❌ Vendor lock-in, limited customization

| Kriter | PostgreSQL | Supabase |
|--------|------------|----------|
| Setup time | 2h | 15min |
| Long-term cost | $$ | $$$ |
| Flexibility | ⭐⭐⭐ | ⭐⭐ |

📌 KARAR: Supabase (MVP için)
📝 GEREKÇE: MVP hızı kritik, migration sonra yapılabilir
⚠️ RİSKLER: Custom auth flow'lar için sınırlı

Debugging İçin

Root Cause Analysis

code
🐛 SEMPTOM: [Ne oluyor?]
🔍 GÖZLEMLER:
  1. [Gözlem]
  2. [Gözlem]

❓ HİPOTEZLER:
  H1: [Olası sebep] → Test: [Nasıl doğrularım?]
  H2: [Olası sebep] → Test: [Nasıl doğrularım?]

✅ DOĞRULANAN: [Hangisi doğrulandı?]
🔧 ÇÖZÜM: [Ne yapacağım?]

Policy/Constraint Kontrolü

Karmaşık iş kuralları için:

code
📋 KONTROL LİSTESİ:
  [ ] User yetkili mi?
  [ ] Input validation geçti mi?
  [ ] Rate limit aşılmadı mı?
  [ ] Business rule X sağlanıyor mu?
  [ ] Side effect'ler handle edildi mi?

⚠️ VIOLATION: [Hangi kural ihlal edildi?]
🛑 ACTION: [Ne yapmalıyım?]

Anti-Patterns

YAPMA:

  • Düşünmeden hemen kod yazmaya başlama
  • Tek alternatifi değerlendirmeden seçme
  • Trade-off'ları göz ardı etme
  • Kararı kaydetmeden devam etme

YAP:

  • En az 2 alternatif düşün
  • Her birinin artı/eksilerini yaz
  • Kararı ve gerekçesini kaydet
  • Riskleri not et