Files
everything-claude-code/docs/zh-TW/rules/performance.md
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.1 KiB
Raw Blame History

效能優化

模型選擇策略

Haiku 4.5Sonnet 90% 能力3 倍成本節省):

  • 頻繁呼叫的輕量 agents
  • 配對程式設計和程式碼產生
  • 多 agent 系統中的 worker agents

Sonnet 4.6(最佳程式碼模型):

  • 主要開發工作
  • 協調多 agent 工作流程
  • 複雜程式碼任務

Opus 4.6(最深度推理):

  • 複雜架構決策
  • 最大推理需求
  • 研究和分析任務

上下文視窗管理

避免在上下文視窗的最後 20% 進行:

  • 大規模重構
  • 跨多個檔案的功能實作
  • 除錯複雜互動

較低上下文敏感度任務:

  • 單檔案編輯
  • 獨立工具建立
  • 文件更新
  • 簡單 Bug 修復

Ultrathink + Plan 模式

對於需要深度推理的複雜任務:

  1. 使用 ultrathink 增強思考
  2. 啟用 Plan 模式 以結構化方法
  3. 用多輪批評「預熱引擎」
  4. 使用分角色子 agents 進行多元分析

建置疑難排解

如果建置失敗:

  1. 使用 build-error-resolver Agent
  2. 分析錯誤訊息
  3. 增量修復
  4. 每次修復後驗證