コンテキストエンジニアリング
コンテキストエンジニアリングは、LLMタスクのために最小の高シグナルトークンセットを厳選します。目標は、トークン使用量を最小限に抑えながら、推論品質を最大化することです。
アクティベーションのタイミング
- エージェントシステムの設計/デバッグ
- コンテキスト制限がパフォーマンスを制約している場合
- コスト/レイテンシの最適化
- マルチエージェント連携の構築
- メモリシステムの実装
- エージェントパフォーマンスの評価
- LLMベースのパイプライン開発
中核原則
- コンテキストの品質 > 量 - 高シグナルトークンは網羅的なコンテンツに勝る
- 注意は有限 - U字曲線は先頭/末尾の位置を優先する
- プログレッシブディスクロージャー - 情報をジャストインタイムで読み込む
- 分離による劣化防止 - 作業をサブエージェントに分割する
- 最適化前に計測 - ベースラインを把握する
重要:
- 簡潔さのために文法を犠牲にすること。
- 高品質を維持しながらトークン効率を確保すること。
- これらのルールをサブエージェントに引き継ぐこと。
クイックリファレンス
| トピック | 使用タイミング | リファレンス |
|---|---|---|
| 基礎 | コンテキスト構造、注意機構の理解 | context-fundamentals.md |
| 劣化 | 障害のデバッグ、中間の喪失、ポイズニング | 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 - 圧縮品質評価