Files
everything-claude-code/docs/ja-JP/rules/common/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

2.0 KiB
Raw Blame History

パフォーマンス最適化

モデル選択戦略

Haiku 4.5Sonnet 機能の 90%、コスト 3 分の 1:

  • 頻繁に呼び出される軽量 agent
  • ペアプログラミングとコード生成
  • マルチ agent システムのワーカー agent

Sonnet 4.6(最高のコーディングモデル):

  • メイン開発作業
  • マルチ agent ワークフローのオーケストレーション
  • 複雑なコーディングタスク

Opus 4.6(最も深い推論):

  • 複雑なアーキテクチャの意思決定
  • 最大限の推論要件
  • 調査と分析タスク

コンテキストウィンドウ管理

次の場合はコンテキストウィンドウの最後の 20% を避ける:

  • 大規模なリファクタリング
  • 複数ファイルにまたがる機能実装
  • 複雑な相互作用のデバッグ

コンテキスト感度の低いタスク:

  • 単一ファイルの編集
  • 独立したユーティリティの作成
  • ドキュメントの更新
  • 単純なバグ修正

拡張思考 + プランモード

拡張思考はデフォルトで有効で、内部推論用に最大 31,999 トークンを予約します。

拡張思考の制御:

  • トグル: Option+TmacOS/ Alt+TWindows/Linux
  • 設定: ~/.claude/settings.jsonalwaysThinkingEnabled を設定
  • 予算上限: export MAX_THINKING_TOKENS=10000bashまたは $env:MAX_THINKING_TOKENS = "10000"PowerShell
  • 詳細モード: Ctrl+O で思考出力を表示

深い推論を必要とする複雑なタスクの場合:

  1. 拡張思考が有効であることを確認(デフォルトで有効)
  2. 構造化されたアプローチのために プランモード を有効化
  3. 徹底的な分析のために複数の批評ラウンドを使用
  4. 多様な視点のために役割分担したサブ agent を使用

ビルドトラブルシューティング

ビルドが失敗した場合:

  1. build-error-resolver agent を使用
  2. エラーメッセージを分析
  3. 段階的に修正
  4. 各修正後に検証