AWS環境定義をXML×YAMLで構造化するシステムプロンプト設計術 ― インフラ情報をAIに正確に伝える方法
出典: Daichi Ito
AWS環境の複雑な構成情報をAIに正確に伝えるには、構造化されたプロンプト設計が不可欠です。Daichi Itoさんが公開したXMLとYAMLを組み合わせた「AWS環境定義システムプロンプトテンプレート」は、EC2インスタンスのOS・ミドルウェア情報まで含めた詳細な環境定義を可能にします。
インフラ情報をAIに伝える難しさ
AWSのようなクラウドインフラをAIに説明する際、自然言語だけでは情報が曖昧になり、AIが誤解したり重要な設定を見落としたりするリスクがあります。特にEC2インスタンスのOS、ミドルウェアのバージョン、EOL（サポート終了）情報、設定ファイルパスといった詳細情報を正確に伝えることは、インフラコード生成やトラブルシューティングにおいて極めて重要です。
Daichi Itoさんが2026年6月に公開した「AWS環境定義 システムプロンプト テンプレート v2.1」は、XMLとYAMLを組み合わせることで、この課題に対する実践的な解決策を提示しています。
XML×YAML方式の構造化プロンプトとは
このテンプレートの特徴は、**XMLで全体構造を定義し、YAML形式で属性や変数を記述する**ハイブリッドアプローチです。
v2.1での主な進化ポイント
最新のv2.1では、EC2インスタンスに関する以下のスキーマが追加されました：
これにより、単なるインスタンスタイプやネットワーク構成だけでなく、**運用上の実態**までAIに伝達できるようになりました。
なぜXMLとYAMLの組み合わせなのか
この2つを組み合わせることで、「構造の明確さ」と「記述の簡潔さ」を両立させています。
編集部の視点
従来のインフラ定義方法との比較
**Terraform/CloudFormationとの違い**
TerraformやCloudFormationは「実際にインフラを構築するコード」ですが、このテンプレートは「AIにインフラを説明するためのプロンプト」です。つまり、AIがTerraformコードを生成する前段階で使用する情報整理フレームワークと言えます。
**自然言語プロンプトとの比較**
「EC2インスタンスでNginxを動かしています」という自然言語プロンプトと比較すると、このテンプレートは：
これらの情報により、AIは「バージョンアップを考慮したコード」「セキュリティ対策を含む提案」を行えるようになります。
メリットと注意点
**メリット**
1. **再現性の高さ**: 同じテンプレートを使えば、誰が入力しても一貫した情報をAIに伝えられる
2. **保守性**: インフラ変更時に該当箇所だけ更新すればよい
3. **ドキュメント代替**: そのままインフラドキュメントとしても機能する
4. **AIの精度向上**: 構造化データはAIの理解精度を大幅に向上させる
**注意点**
1. **初期コスト**: 最初にテンプレートを埋める作業が必要
2. **更新の手間**: インフラ変更のたびにテンプレートも更新する運用が必要
3. **過剰な情報**: 小規模プロジェクトでは構造化が過剰になる可能性がある
どんな人・場面に向いているか
**最適な利用シーン**
**向いている人**
今日から試せるアクション
アクション1: 既存の1つのEC2環境をテンプレート化する
まずは本番環境ではなく、開発環境の1つのEC2インスタンスから始めましょう。
ec2:
instance_id: i-0123456789abcdef0
os:
type: Ubuntu
version: 22.04 LTS
eol: 2027-04
middleware:
- name: Nginx
version: 1.24.0
config_path: /etc/nginx/nginx.conf
eol: 2024-04
concerns: "OpenSSL 1.1.1系への依存あり"この形式で情報を整理し、Claude CodeやChatGPTに「このEC2環境のセキュリティチェックをして」と依頼してみてください。AIの回答精度の違いを実感できます。
アクション2: EOL情報を一覧化する
テンプレート作成の過程で、各ミドルウェアのEOL情報を調べることになります。これ自体が「気づかなかったセキュリティリスク」の発見につながります。GoogleスプレッドシートやNotionで管理し、定期的にレビューする習慣をつけましょう。
アクション3: AIにTerraformコードを生成させる
完成したテンプレートをプロンプトに含めて、「このAWS環境をTerraformコードで再現してください」と依頼します。手動で書くより高速で、しかも設定の抜け漏れが少ないコードが生成されます。生成されたコードはレビュー必須ですが、作業時間は大幅に短縮できます。
まとめ
XML×YAMLによる構造化プロンプトは、AIにインフラ情報を正確に伝えるための強力な手法です。特にv2.1で追加されたOS・ミドルウェアスキーマは、運用上の実態をAIに理解させる上で大きな前進と言えます。
初期コストはかかりますが、一度テンプレート化すれば、ドキュメント・AI入力・チーム共有の3つの目的を同時に達成できる「一石三鳥」のアプローチです。まずは小さく始めて、効果を実感しながら展開していくことをお勧めします。
この情報は @Daichi Ito さんの投稿を参考にしています。
出典: Daichi Ito
