コンテキストエンジニアリング は何をしますか?
コンテキストエンジニアリングは、LLMタスクに対して最小の高シグナルトークンセットを厳選します。目標は、トークン使用量を最小限に抑えながら推論品質を最大化することです。
アクティベーションが必要な場合
- エージェントシステムの設計/デバッグ
- コンテキスト制限がパフォーマンスを制約している場合
- コスト/レイテンシの最適化
- マルチエージェント連携の構築
- メモリシステムの実装
- エージェントパフォーマンスの評価
- LLM駆動パイプラインの開発
コア原則
- コンテキストの質 > 量 - 高シグナルトークンは網羅的なコンテンツに勝る
- 注意は有限 - U字曲線は先頭/末尾の位置を優先する
- 段階的開示 - 情報をジャストインタイムで読み込む
- 分離による劣化防止 - サブエージェント間で作業を分割する
- 最適化前に測定する - ベースラインを把握する
重要:
- 簡潔さのために文法を犠牲にすること
- 高品質を維持しながらトークン効率を確保すること
- これらのルールをサブエージェントに引き継ぐこと
クイックリファレンス
| トピック | 使用タイミング | リファレンス |
|---|---|---|
| 基礎 | コンテキスト構造、注意メカニズムの理解 | context-fundamentals.md |
| 劣化 | 障害デバッグ、Lost-in-the-Middle、ポイズニング | context-degradation.md |
| 最適化 | コンパクション、マスキング、キャッシング、パーティショニング | context-optimization.md |
| 圧縮 | 長期セッション、要約戦略 | context-compression.md |
| メモリ | セッション間永続化、ナレッジグラフ | memory-systems.md |
| マルチエージェント | 連携パターン、コンテキスト分離 | multi-agent-patterns.md |
| 評価 | エージェントテスト、LLM-as-Judge、メトリクス | evaluation.md |
| ツール設計 | ツール統合、説明エンジニアリング | tool-design.md |
| パイプライン | プロジェクト開発、バッチ処理 | project-development.md |
| 実行時認識 | 使用制限、コンテキストウィンドウ監視 | runtime-awareness.md |
主要メトリクス
- トークン使用率: 警告70%、最適化トリガー80%
- トークンのばらつき: エージェントパフォーマンスのばらつきの80%を説明
- マルチエージェントコスト: シングルエージェントの約15倍
- コンパクション目標: 50-70%削減、品質損失5%未満
- キャッシュヒット目標: 安定したワークロードで70%以上
4バケット戦略
- 書き出す: コンテキストを外部に保存(スクラッチパッド、ファイル)
- 選択する: 関連コンテキストのみを取得(検索、フィルタリング)
- 圧縮する: 情報を保持しながらトークンを削減(要約)
- 分離する: サブエージェント間で分割(パーティショニング)
アンチパターン
- 厳選されたコンテキストではなく網羅的なコンテキスト
- 中間位置に重要な情報を配置
- 制限前にコンパクショントリガーがない
- 並列化可能なタスクに単一エージェント
- 明確な説明がないツール
ガイドライン
- 重要な情報はコンテキストの先頭/末尾に配置する
- 使用率70-80%でコンパクションを実行する
- コンテキスト分離にはロールプレイではなくサブエージェントを使用する
- ツールは4質問フレームワーク(何を、いつ、入力、戻り値)で設計する
- リクエストあたりのトークン数ではなく、タスクあたりのトークン数を最適化する
- プローブベースの評価で検証する
- 本番環境でKVキャッシュヒット率を監視する
- 最小限から始め、必要な場合のみ複雑性を追加する
実行時認識
システムはPostToolUseフックを介して使用状況認識を自動的に注入します:
<usage-awareness>
Claude Usage Limits: 5h=45%, 7d=32%
Context Window Usage: 67%
</usage-awareness>
閾値:
- 70%: 警告 - 最適化/コンパクションを検討
- 90%: 重大 - 即時対応が必要
データソース:
- 使用制限: Anthropic OAuth API (
https://api.anthropic.com/api/oauth/usage) - コンテキストウィンドウ: ステータスライン一時ファイル (
/tmp/ck-context-{session_id}.json)
スクリプト
- context_analyzer.py - コンテキスト健全性分析、劣化検出
- compression_evaluator.py - 圧縮品質評価