mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-06-12 03:03:23 +08:00
8b24f63ede
Several published examples contained APIs that no longer exist, code that does not run, or model versions that drifted from reality: - agents/performance-optimizer.md used the web-vitals v3 API (getCLS/getFID/getLCP/getFCP/getTTFB) and reported FID. web-vitals v4 renamed the imports to onCLS/onINP/onLCP/onFCP/onTTFB and FID was replaced by INP (target < 200ms) - rules/common/performance.md pinned stale model versions in the model-selection guidance; refresh to the versions the repo itself uses (agent.yaml pins claude-opus-4-6) and add the PowerShell variant for MAX_THINKING_TOKENS next to the bash export - skills/python-patterns/SKILL.md: both get_value examples referenced default_value without declaring the parameter (NameError); add default_value: Any = None to the EAFP and LBYL signatures - skills/frontend-patterns/SKILL.md: the custom useQuery example rebuilt refetch whenever callers passed inline fetchers/options, re-triggering the effect after every state update (infinite fetch loop). Keep the latest fetcher/options in refs so refetch stays referentially stable. The PASS-labelled useMemo example mutated its input with in-place sort; copy before sorting - skills/coding-standards/SKILL.md repeated the same PASS-labelled in-place-sort-in-useMemo example; same fix - rules/typescript/security.md used a vendor-specific OPENAI_API_KEY in generic guidance; switch to a neutral API_KEY Every hand-maintained copy of the affected content is synced in the same change: locale mirrors (ja-JP, ko-KR, pt-BR, tr, zh-CN, zh-TW - each only where it carries the affected file) and the .agents/.kiro/.cursor harness mirrors. Two structural divergences are left alone and noted here: .kiro/steering/performance.md has no extended-thinking control list to carry the PowerShell variant, and docs/zh-TW/rules/performance.md keeps an older condensed thinking section without the budget-cap line. rules/zh/performance.md is intentionally untouched - the rules/zh tree is being retired in a separate change
56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
# Performans Optimizasyonu
|
||
|
||
## Model Seçim Stratejisi
|
||
|
||
**Haiku 4.5** (Sonnet kapasitesinin %90'ı, 3x maliyet tasarrufu):
|
||
- Sık çağrılan hafif agent'lar
|
||
- Pair programming ve kod üretimi
|
||
- Multi-agent sistemlerinde worker agent'lar
|
||
|
||
**Sonnet 4.6** (En iyi kodlama modeli):
|
||
- Ana geliştirme çalışması
|
||
- Multi-agent iş akışlarını orkestrasyon
|
||
- Karmaşık kodlama görevleri
|
||
|
||
**Opus 4.6** (En derin akıl yürütme):
|
||
- Karmaşık mimari kararlar
|
||
- Maksimum akıl yürütme gereksinimleri
|
||
- Araştırma ve analiz görevleri
|
||
|
||
## Context Window Yönetimi
|
||
|
||
Context window'un son %20'sinden kaçın:
|
||
- Büyük ölçekli refactoring
|
||
- Birden fazla dosyaya yayılan özellik implementasyonu
|
||
- Karmaşık etkileşimleri debug etme
|
||
|
||
Daha düşük context hassasiyeti olan görevler:
|
||
- Tek dosya düzenlemeleri
|
||
- Bağımsız utility oluşturma
|
||
- Dokümantasyon güncellemeleri
|
||
- Basit hata düzeltmeleri
|
||
|
||
## Extended Thinking + Plan Mode
|
||
|
||
Extended thinking varsayılan olarak etkindir ve dahili akıl yürütme için 31,999 token'a kadar ayırır.
|
||
|
||
Extended thinking kontrolü:
|
||
- **Toggle**: Option+T (macOS) / Alt+T (Windows/Linux)
|
||
- **Config**: `~/.claude/settings.json` içinde `alwaysThinkingEnabled` ayarla
|
||
- **Budget cap**: `export MAX_THINKING_TOKENS=10000` (bash) veya `$env:MAX_THINKING_TOKENS = "10000"` (PowerShell)
|
||
- **Verbose mode**: Thinking çıktısını görmek için Ctrl+O
|
||
|
||
Derin akıl yürütme gerektiren karmaşık görevler için:
|
||
1. Extended thinking'in etkin olduğundan emin ol (varsayılan olarak açık)
|
||
2. Yapılandırılmış yaklaşım için **Plan Mode**'u etkinleştir
|
||
3. Kapsamlı analiz için birden fazla kritik tur kullan
|
||
4. Çeşitli perspektifler için split role sub-agent'lar kullan
|
||
|
||
## Build Sorun Giderme
|
||
|
||
Build başarısız olursa:
|
||
1. **build-error-resolver** agent kullan
|
||
2. Hata mesajlarını analiz et
|
||
3. Aşamalı olarak düzelt
|
||
4. Her düzeltmeden sonra doğrula
|