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