mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-06-11 18:53:11 +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
2.0 KiB
Markdown
56 lines
2.0 KiB
Markdown
# パフォーマンス最適化
|
||
|
||
## モデル選択戦略
|
||
|
||
**Haiku 4.5**（Sonnet 機能の 90%、コスト 3 分の 1）:
|
||
- 頻繁に呼び出される軽量 agent
|
||
- ペアプログラミングとコード生成
|
||
- マルチ agent システムのワーカー agent
|
||
|
||
**Sonnet 4.6**（最高のコーディングモデル）:
|
||
- メイン開発作業
|
||
- マルチ agent ワークフローのオーケストレーション
|
||
- 複雑なコーディングタスク
|
||
|
||
**Opus 4.6**（最も深い推論）:
|
||
- 複雑なアーキテクチャの意思決定
|
||
- 最大限の推論要件
|
||
- 調査と分析タスク
|
||
|
||
## コンテキストウィンドウ管理
|
||
|
||
次の場合はコンテキストウィンドウの最後の 20% を避ける:
|
||
- 大規模なリファクタリング
|
||
- 複数ファイルにまたがる機能実装
|
||
- 複雑な相互作用のデバッグ
|
||
|
||
コンテキスト感度の低いタスク:
|
||
- 単一ファイルの編集
|
||
- 独立したユーティリティの作成
|
||
- ドキュメントの更新
|
||
- 単純なバグ修正
|
||
|
||
## 拡張思考 + プランモード
|
||
|
||
拡張思考はデフォルトで有効で、内部推論用に最大 31,999 トークンを予約します。
|
||
|
||
拡張思考の制御:
|
||
- **トグル**: Option+T（macOS）/ Alt+T（Windows/Linux）
|
||
- **設定**: `~/.claude/settings.json` で `alwaysThinkingEnabled` を設定
|
||
- **予算上限**: `export MAX_THINKING_TOKENS=10000`（bash）または `$env:MAX_THINKING_TOKENS = "10000"`（PowerShell）
|
||
- **詳細モード**: Ctrl+O で思考出力を表示
|
||
|
||
深い推論を必要とする複雑なタスクの場合:
|
||
1. 拡張思考が有効であることを確認（デフォルトで有効）
|
||
2. 構造化されたアプローチのために **プランモード** を有効化
|
||
3. 徹底的な分析のために複数の批評ラウンドを使用
|
||
4. 多様な視点のために役割分担したサブ agent を使用
|
||
|
||
## ビルドトラブルシューティング
|
||
|
||
ビルドが失敗した場合:
|
||
1. **build-error-resolver** agent を使用
|
||
2. エラーメッセージを分析
|
||
3. 段階的に修正
|
||
4. 各修正後に検証
|