🌊

Amazon Q Developer完全ガイド：全機能解説

2025/06/28に公開

はじめに

「AWS開発をもっと効率化したい」「CloudFormationテンプレートの作成に時間がかかりすぎる」「セキュリティベストプラクティスを自動適用したい」

このような課題を抱えるAWS開発者にとって「Amazon Q Developer」は選択肢の１つと考えられますが、実際のところどうなの？他のツールとの違いは？　を明らかにすべく、AWS特化の生成AIアシスタントの全機能を確認しました。

Amazon Q Developerとは

基本情報

Amazon Q Developerは、AWSが提供するAWS開発に特化した生成AIアシスタントです。2024年4月にAWS CodeWhispererの後継として正式リリースされ、AWS Well-Architected Frameworkに基づいた最適な構成提案、セキュリティベストプラクティスの自動適用、コスト最適化提案など、従来の汎用AIツールでは実現できない高度な機能を提供します。

設計思想

1. AWS特化設計

AWSサービスの深い理解に基づく提案
Well-Architected Framework準拠の自動チェック
AWSの最新サービス・機能への対応

2. 開発ライフサイクル全体のサポート

要件定義からアーキテクチャ設計
IaC実装からテスト・デプロイ
運用・監視・最適化まで

3. 実用性重視

実際に動作するコードの生成
エラーハンドリングの考慮
運用性を重視した設計提案

Amazon Q Developerの主要機能

1. Infrastructure as Code（IaC）支援

CloudFormationテンプレート生成

機能概要:
- 要件に基づく完全なテンプレート生成
- パラメータ化・モジュール化の自動適用
- Cross-Stack参照とExport/ImportValueの適切な設定
- ベストプラクティスに準拠した構造

AWS CDK支援

機能概要:
- 対応言語: TypeScript/JavaScript, Python, Java, C#/.NET, Go
- Constructの自動生成
- 型安全性を考慮したコード生成
- テストコードの同時生成

特徴:
- 言語固有のベストプラクティス適用
- AWS SDK統合の最適化
- デプロイメント戦略の提案

Terraform支援

機能概要:
- HCL構文での設定生成
- モジュール化の提案
- State管理の考慮
- マルチクラウド対応

2. AWS特化最適化機能

コスト最適化

リアルタイム分析:
- 現在のリソース使用状況分析
- 過剰プロビジョニングの検出
- 未使用リソースの特定

最適化提案:
- Reserved Instance推奨
- Spot Instance活用提案
- 適切なインスタンスサイズ提案
- サービス代替案の検討

セキュリティ最適化

自動チェック項目:
- IAMポリシーの最小権限確認
- セキュリティグループの過度な開放検出
- 暗号化設定の確認
- パブリックアクセスの検証

準拠フレームワーク:
- AWS Well-Architected Security Pillar
- CIS Benchmarks
- SOC 2 Type II
- PCI DSS

実装支援:
- セキュリティ設定の自動生成
- 脆弱性対策の提案
- コンプライアンス要件への対応

パフォーマンス最適化

分析対象:
- レスポンス時間の改善
- スループットの向上
- リソース使用効率の最適化

提案内容:
- キャッシュ戦略の最適化
- データベースパフォーマンス改善
- ネットワーク最適化
- Auto Scaling設定の調整

3. 開発ライフサイクル統合

要件定義・設計支援

機能:
- 曖昧な要件の整理・具体化
- 技術選定の支援
- アーキテクチャパターンの提案
- 非機能要件の考慮

コードレビュー・品質管理

自動チェック:
- コーディング規約の確認
- セキュリティ脆弱性の検出
- パフォーマンス問題の特定
- ベストプラクティス適用状況

改善提案:
- 具体的な修正方法の提示
- 代替実装の提案
- 学習リソースの紹介

デバッグ・トラブルシューティング

対応範囲:
- CloudFormationデプロイエラー
- ECS/Lambda実行時エラー
- ネットワーク接続問題
- パフォーマンス問題

支援内容:
- エラーログの分析
- 原因の特定と解決策提示
- 予防策の提案
- 監視設定の改善提案

4. AWS統合機能

AWS連携機能

主な連携機能:
- AWS Management Consoleとの連携
- CloudFormation/CDKテンプレートの直接実行
- AWS CLIコマンドの生成と実行支援
- AWSサービスドキュメントとの連携

注意事項:
- リアルタイムでのAWSリソース状況取得は制限あり
- 主にコード生成と設計支援に特化

AWS CLI/SDK統合

機能:
- 適切なCLIコマンドの生成
- SDK使用例の提供
- エラーハンドリングの実装
- 認証・権限設定の支援

対応言語:
- Python (boto3)
- JavaScript/TypeScript (AWS SDK)
- Java (AWS SDK)
- .NET (AWS SDK)
- Go (AWS SDK)

5. Amazon Q Developer Agent機能

Agent概要

基本機能:
- 特定タスク向けの専用AIアシスタント
- カスタム知識ベースとの連携
- 組織固有のベストプラクティス適用
- 反復的タスクの自動化

活用シナリオ:
- セキュリティレビューAgent
- コスト最適化Agent
- アーキテクチャ設計Agent
- トラブルシューティングAgent

カスタムAgent作成

作成ステップ:
- 専門知識の定義
- 参照ドキュメントの登録
- 応答スタイルの設定
- アクセス権限の管理

カスタマイズ要素:
- 組織固有のポリシー適用
- 部門別の専門知識
- プロジェクト固有の制約条件

6. IDE統合と開発環境

対応IDE

- Visual Studio Code (Amazon Q extension)
- JetBrains製品群 (IntelliJ IDEA, PyCharm, WebStorm等)
- Visual Studio (Amazon Q extension)
- AWS Cloud9
- コマンドライン (AWS CLI統合)

主要機能

コーディング支援:
- インラインコード提案
- 関数全体の自動生成
- リファクタリング提案
- ドキュメント自動生成

ナビゲーション:
- コンテキスト認識検索
- 関連コード参照
- AWS リソース直接参照

効果的なプロンプトテクニック

基本原則

1. 具体性

なぜ具体性が重要なのか？
Amazon Q Developerは、提供された情報の詳細度に応じて回答の精度が大きく変わります。曖昧な要求では汎用的な回答しか得られませんが、具体的な要件を提示することで、実際のプロジェクトで使用可能な詳細な提案を受けることができます。

❌ 悪い例:
「Webアプリを作りたい」
→ 汎用的すぎて、実用的でない回答になりがち

✅ 良い例:
「Node.js Express APIサーバーを構築したい
- 想定ユーザー: 1万人/日
- 主要機能: ユーザー認証、商品管理、注文処理
- 非機能要件: 可用性99.9%、レスポンス時間<500ms
- 予算制約: 月額$300以下」
→ 具体的な数値により、適切なAWSサービス選択と構成提案が可能

具体性を高めるポイント:

数値で表現できる要件は必ず数値化（ユーザー数、レスポンス時間、予算など）
技術スタックを明確に指定
ビジネス要件と技術要件を分けて記述
制約条件を明確に提示

2. コンテキストの提供

コンテキストが重要な理由
Amazon Q Developerは、プロジェクトの背景や制約を理解することで、より実践的で適切な提案を行います。単発の質問よりも、全体像を把握した上での回答の方が実用性が高くなります。

効果的なプロンプト構成:
1. 背景・目的の説明
   → なぜこのシステムが必要なのか
2. 技術的制約・要件
   → 使用可能な技術、既存システムとの連携
3. 非機能要件
   → 性能、可用性、セキュリティレベル
4. 期待する出力形式
   → コード、図表、手順書など

例:
「ECサイトのバックエンドAPIとして、以下の要件でECS Fargateを構築したいです。
現在オンプレミスで運用中のシステムをクラウド移行する際に、
既存のPostgreSQLデータベースとの連携を維持しつつ、
将来的なマイクロサービス化も考慮した設計を希望します...」

コンテキスト提供のベストプラクティス:

プロジェクトの全体像を最初に説明
既存システムとの関係性を明確化
将来の拡張性要件も含める
組織の技術的制約（使用禁止技術など）も記載

3. 段階的な詳細化

段階的アプローチの利点
複雑なシステムを一度に設計しようとすると、重要な要素が抜け落ちたり、過度に複雑な提案になる可能性があります。段階的に詳細化することで、各段階で確認・修正を行いながら、最適な解決策に到達できます。

Step 1: 基本構成の確認
「3層Webアプリの基本構成を提案してください」
→ 全体のアーキテクチャパターンを確定

Step 2: 詳細要件の追加
「上記構成にセキュリティ要件を追加してください
- WAF設定
- VPC設計
- IAM権限設計」
→ セキュリティ観点での詳細化

Step 3: 最適化の依頼
「コスト最適化の観点で改善提案をお願いします
- Reserved Instance活用
- Auto Scaling設定
- 不要リソースの削減」
→ 運用面での最適化

段階的詳細化のコツ:

各段階で1つの観点に集中
前の段階の回答を次の質問で参照
段階ごとに確認・承認を行う
必要に応じて前の段階に戻って修正

用途別プロンプトパターン

アーキテクチャ設計

使用場面: 新規システムの設計、既存システムの改善、技術選定の検討

テンプレート:
「[システム種別]の[規模]システムを構築したいです。

【背景・目的】
- ビジネス目的: [具体的な目的]
- 解決したい課題: [現在の問題点]

【要件詳細】
- 機能要件: [具体的な機能リスト]
- 非機能要件: [性能、可用性、セキュリティ]
- 制約条件: [予算、技術、期限]
- 既存環境: [既存システムとの関係]

【期待する出力】
- アーキテクチャ図
- 使用AWSサービス一覧
- 概算コスト
- 実装優先順位

AWS Well-Architected Frameworkに準拠した最適なアーキテクチャを提案してください。」

記入例:

「ECサイトの中規模システムを構築したいです。

【背景・目的】
- ビジネス目的: 月商1000万円のオンライン販売
- 解決したい課題: 既存システムの性能不足とメンテナンス性

【要件詳細】
- 機能要件: 商品管理、注文処理、決済、在庫管理
- 非機能要件: 同時接続1000ユーザー、可用性99.9%
- 制約条件: 初期費用500万円、6ヶ月での構築
- 既存環境: オンプレミスのMySQL、既存の基幹システム連携必須

【期待する出力】
- マイクロサービス構成のアーキテクチャ図
- 各サービスで使用するAWSサービス
- 月額運用コスト概算
- 段階的な移行計画

AWS Well-Architected Frameworkに準拠した最適なアーキテクチャを提案してください。」

IaC実装

使用場面: CloudFormation/CDKテンプレート作成、インフラの自動化、環境の標準化

テンプレート:
「[上記アーキテクチャ]をCloudFormationで実装してください。

【実装要件】
- 対象環境: [開発/ステージング/本番]
- パラメータ化: [環境別設定項目]
- セキュリティ: [具体的セキュリティ要件]
- 監視: [必要な監視項目とアラート設定]
- タグ付け: [組織のタグ付け規則]

【期待する出力】
- 完全なCloudFormationテンプレート
- パラメータファイル例
- デプロイ手順書
- 削除手順書

ベストプラクティスに準拠したテンプレートを生成してください。」

実装時の注意点:

環境ごとのパラメータ化を必ず含める
セキュリティ設定は最小権限の原則を適用
監視・ログ設定を忘れずに含める
タグ付けによるコスト管理を考慮

トラブルシューティング

使用場面: エラー解決、性能問題の調査、設定不備の特定

テンプレート:
「[具体的な問題]が発生しています。

【問題の詳細】
- 発生タイミング: [いつから、どのような操作で]
- エラー内容: [正確なエラーメッセージ]
- 影響範囲: [どの機能が使用不可か]

【環境情報】
- AWS環境: [リージョン、アカウント情報]
- 関連サービス: [使用中のAWSサービス]
- 設定情報: [関連する設定内容]

【実行手順】
- 問題発生前の作業: [直前に行った変更]
- 再現手順: [問題を再現する手順]
- 試行した対処: [既に試した解決策]

【期待する出力】
- 原因の特定
- 段階的な解決手順
- 再発防止策
- 監視強化の提案

原因分析と解決策を段階的に提示してください。」

トラブルシューティングのコツ:

エラーメッセージは正確にコピー&ペースト
問題発生前後の変更点を詳細に記録
関連するログやメトリクスも併せて提供
緊急度と影響度を明確に伝える

他ツールとの比較

使い分けの指針

Amazon Q Developerが最適な場面

✅ AWS環境でのインフラ構築・運用
✅ CloudFormation/CDKテンプレート作成
✅ AWS Well-Architected Framework準拠
✅ コスト・セキュリティ最適化
✅ AWS特有のトラブルシューティング
✅ 大規模なAWS環境の管理

他ツールとの併用パターン案

設計フェーズ: ChatGPT Enterprise
↓ (要件整理・技術選定)
構築フェーズ: Amazon Q Developer  
↓ (AWS インフラ構築)
開発フェーズ: GitHub Copilot
↓ (アプリケーション実装)
運用フェーズ: Amazon Q Developer
↓ (最適化・トラブルシューティング)

導入時の考慮事項

⚠️ 注意点・制限事項

技術的制限

- 生成されたコードの検証は必須
- 複雑な要件では段階的なアプローチが必要
- 最新AWSサービスへの対応にタイムラグがある場合がある
- 組織固有の要件は追加説明が必要
- インターネット接続が必要（オフライン利用不可）
- 一部の機能は有料プラン（Amazon Q Developer Pro）でのみ利用可能

🔒 セキュリティ上の重要な注意事項

必須遵守事項:
- 機密情報をプロンプトに含めない
- 生成されたIAMポリシーは必ず最小権限の原則で見直し
- 本番環境への適用前に必ずテスト環境での検証を実施
- 組織のセキュリティポリシーとの整合性確認
- アクセスキーやパスワードなどの認証情報をプロンプトに含めない

まとめ

要件定義から構築、テストまで開発全体をサポートしており、またAWSに特化したコスト最適化やセキュリティ最適化等のサポートを受けることができる点は、汎用的な生成AIツールと比較しAWS開発においては優位性がありそうです。
一方、机上の確認だけでは、Amazon Q Developerが実際の開発においてどの程度活用可能かは判断難しいですね。時間があれば実際の開発プロセス各フェーズでの具体的な活用方法を確認してみようと思います。

※この記事は2025年6月時点の情報に基づいています。最新の機能については、AWS公式サイトをご確認ください。

関連リンク