smart-loader

スマートコンテキストローダー

ユーザーが新しいタスクを始めたり、何かに取り組むよう依頼したりしたときは、必要になりそうなファイルを示す過去のパターンがあるか確認します。

有効にするタイミング

• ユーザーが新しいタスク（バグ修正、機能追加、リファクタリング、レビュー）を説明する
• ユーザーが「〜に取り組みましょう」や「〜を修正する必要があります」と言う
• セッションが始まったばかりで、ユーザーがやりたいことを説明している
• ユーザーが「これにはどのファイルが必要ですか？」と尋ねる

使い方

1. タスクの種類に合致する既存のテンプレートを確認します：Glob ~/.claude-context-optimizer/templates/*.json.

2. 現在のディレクトリの過去のパターンを確認します：

node ${CLAUDE_PLUGIN_ROOT}/src/tracker.js suggest "$(pwd)"

3. タスクの説明と履歴データに基づいて、次のように対応します：
   • 一致するテンプレートがある場合は、「「{name}」テンプレートがあるようです。このコンテキストを読み込みますか？」と伝えます。
   • 過去のパターンから必要なファイルが示されている場合は、「過去のセッションに基づくと、この種類のタスクでは通常、次のファイルが必要です：...」と伝えます。
   • 避けるべきファイルがパターンから分かる場合は、「ヒント：[file] は過去のセッションで一貫して使われていません。今回は読み飛ばします。」と伝えます。
   • 該当するものがない場合は、通常どおり進めます。

自動最適化のヒント

トークンを無駄にするパターンを検出した場合は、改善策を先回りして提案します：

• 大きなファイル（300 行以上）をすべて読み込もうとしている場合：「関連する箇所だけを読むため、offset/limit を使います」
• 過去 2 回以上のセッションでファイルが無駄になっていた場合：何も言わずに読み飛ばすか、その理由を伝えます
• ユーザーのタスクが既知のテンプレートに合致する場合：適用することを提案します

重要

• ユーザーの確認なしにファイルを自動で読み込まないでください
• 提案だけにとどめ、コンテキストの読み込みを強制しないでください
• 提案は簡潔にし、ファイルは最大 3〜5 件までにしてください
• まだ追跡データがない場合は、何も言わずにスキップし、オプティマイザーについて触れないでください
• 役に立つ対応を心がけ、煩わしくならないようにしてください。タスク開始時の提案は最大 1 件です