Skip to content

README.md

Latest commit

 

History

History
115 lines (78 loc) · 5.98 KB

README.md

File metadata and controls

115 lines (78 loc) · 5.98 KB
Raw

ホーム > ユーザーガイド > コンテキスト管理ガイド

コンテキスト管理

このガイドでは、Amazon Q Developer CLIのコンテキスト管理について、概念から実践まで包括的に解説します。

🚀 クイックアクセス

よく使う情報

🎯 なぜコンテキスト管理が重要なのか

AIの応答品質を決める最重要要素

Q CLIの応答品質は、コンテキスト管理で決まります。同じ質問でも、AIに提供するコンテキスト（背景情報）によって、回答の正確性が劇的に変わります。

例: コンテキストの有無による違い

❌ コンテキストなし:

あなた: このプロジェクトのREADMEを更新して
AI: どのプロジェクトですか？どのような内容を追加しますか？

✅ コンテキストあり（README.mdを読み込み済み）:

あなた: このプロジェクトのREADMEを更新して
AI: 了解しました。現在のREADMEには「インストール方法」と「基本的な使い方」が
    記載されていますね。「トラブルシューティング」セクションを追加しましょうか？

理解すべき3つのポイント

このガイドを通じて、以下を理解することでAIの回答正確性が向上します：

  1. コンテキストとは何か

    • AIが参照する「背景情報」の本質
    • なぜコンテキストが必要なのか

  2. どのように提供するか

    • 3つのアプローチ（Agent Resources / Session Context / Knowledge Bases）
    • それぞれの特徴と使い分け

  3. どう最適化するか

    • 適切なファイル選定
    • トークン制限内での効果的な設定
    • プロジェクトタイプ別のベストプラクティス

実例から学ぶ

AI駆動開発におけるコンテキストの実践事例: AI 駆動開発におけるコミュニティと AWS CDK の価値 (Kenji Kono)

詳細は 第1章: コンテキストの本質 の関連リソースをご覧ください。

💡 このガイドの目標: コンテキスト管理を理解し、Q CLIの応答品質を最大化すること

📚 ガイドの構成

# ドキュメント 対象 主な内容
1 コンテキストの本質 初級 コンテキストとは何か / Q CLIのコンテキストモデル / 3つのコンテキストアプローチ
2 コンテキストの仕組みと管理 初級〜中級 コンテキストのライフサイクル / トークン管理の詳細 / コンテキストの優先順位 / Q CLIでの管理方法
3 コンテキストの効果と特徴 初級〜中級 コンテキストがもたらす効果 / Agent Resources/Session Context/Knowledge Basesの特徴 / 制限事項と注意点 / 3つのアプローチの比較
4 ベストプラクティスの考え方 ⭐ 中級 コンテキスト設計の基本原則 / アプローチ選択の思考プロセス / ファイル選定の思考プロセス / パス指定の思考プロセス / パフォーマンス最適化の思考プロセス / セキュリティ設計の思考プロセス
5 実践ガイド 中級 基本設定の実装 / プロジェクトタイプ別実装 / 応用実装パターン / 実装時の注意点
6 トラブルシューティング 中級 問題の診断 / よくある問題と解決方法 / デバッグ手法
7 高度なトピック 上級 コンテキストの最適化戦略 / チーム開発での活用 / 実装の内部詳細
8 参考情報 中級〜上級 コマンドリファレンス / 設定リファレンス / 技術仕様 / 用語集 / FAQ
9 記憶管理ガイド ⭐ 初級 短期記憶と長期記憶の違い / /compactコマンドの使い方 / フォルダごとの記憶管理 / 保存場所の説明
10 ワークフロー自動化 中級〜上級 Agent Hooksによる自動化 / 実践的な自動化パターン / スクリプト作成方法 / パフォーマンス最適化

⭐ = 最重要章

🎯 読み方ガイド

初心者の方

  1. 第10章: 記憶管理ガイド ⭐ - Q CLIの記憶の仕組みを理解
  2. 第1章: コンテキストの本質 - コンテキストの基本
  3. 第2章: コンテキストの仕組みと管理 - 基本を理解
  4. 第5章: 実践ガイド - 実際に設定してみる

中級者の方

  1. 第4章: ベストプラクティスの考え方 - 考え方を学ぶ
  2. 第5章: 実践ガイド - プロジェクトに適用
  3. 第6章: トラブルシューティング - 問題解決

上級者の方

  1. 第4章: ベストプラクティスの考え方 - 深い理解
  2. 第7章: 高度なトピック - 最適化と内部詳細
  3. 第8章: 参考情報 - リファレンス

📖 関連ドキュメント

最終更新: 2025-10-27