mirror of https://github.com/affaan-m/everything-claude-code.git synced 2026-06-11 02:33:10 +08:00

Files

konstapukarifastnetfi 8b24f63ede fix: refresh stale technical content in agents, rules, and skills (#2168 )

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

2026-06-07 13:26:01 +08:00

1.9 KiB

Raw Blame History

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:

Extended thinking'in etkin olduğundan emin ol (varsayılan olarak açık)
Yapılandırılmış yaklaşım için Plan Mode'u etkinleştir
Kapsamlı analiz için birden fazla kritik tur kullan
Çeşitli perspektifler için split role sub-agent'lar kullan

Build Sorun Giderme

Build başarısız olursa:

build-error-resolver agent kullan
Hata mesajlarını analiz et
Aşamalı olarak düzelt
Her düzeltmeden sonra doğrula

1.9 KiB Raw Blame History Unescape Escape