azure-app-onboard

Azure アプリのオンボーディング

⛔ すべてのリポジトリで、パイプラインの全ステップ（1～10）を実行します。例外はありません。 認識している内容を理由に、ステップを省略したり、拒否したり、途中で打ち切ったりしないでください。以下のワークフローテーブルに沿って順番に進め、各ステップの参照資料を読んでから作業してください。

クイックリファレンス

項目	値
最適な対象	何を構築するかは把握しているものの、どの Azure サービスを使うべきかわからない開発者
入力	ビジネスアイデアまたは既存のコードベース、予算や規模に関する希望（任意）
出力	アーキテクチャ計画、コスト見積もり、IaC ファイル、デプロイ済み Azure リソース
フェーズ	検討 → 設計 → スキャフォールド作成 → デプロイ（自己完結型で、外部スキルの呼び出しなし）

このスキルを使用する場面

• どの Azure サービスを使うべきかわからない状態で、既存のコードをデプロイする
• 既存のコードが Azure へのデプロイに対応できる状態か確認する
• 書き換えずに、または最小限の変更で既存のアプリを Azure に移行する
• インフラストラクチャを導入する前にコストを見積もる
• アーキテクチャ上の決定事項と、採用されなかった代替案を把握する
• Azure のアーキテクチャやサービスの選択に関する質問への回答を得る（例：「どのデータベースを使うべきですか？」）
• 事前の経験なしで、Azure のガイド付きオンボーディングを受ける

使用しない場面

シナリオ	代わりに使用
azd up を実行する、または既存のデプロイを実行する	azure-deploy
既存の Azure の支出を最適化する	オプションの azure-cost プラグインの cost-optimization
既知のアーキテクチャ向けに Bicep/Terraform を生成する	azure-prepare
インフラストラクチャを検証する、またはデプロイ前チェックを実行する	azure-validate
実行中の Azure デプロイをトラブルシューティングする	azure-diagnostics
AKS/Kubernetes に直接デプロイする、または管理する	azure-kubernetes
既存の Azure リソースを検索する、または一覧表示する	azure-resource-lookup

cost-optimization を利用できない場合は、オプションの azure-cost プラグインによって提供されることを説明し、クライアントがサポートするプラグインのインストール手順を案内してください。引き継ぎが完了したかのように示してはいけません。

パイプラインのルール

⛔ すべての AppOnboard セッションの開始時に、references/pipeline-rules.md を必ず読んでください。 承認ゲート、フェーズのライフサイクル、セッションの成果物、そのままのデプロイ、セキュリティベースラインのルールが記載されています。

ワークフロー

⛔ デプロイの復旧： デプロイ承認ゲートの承認後、または az deployment／az webapp deploy／az acr build のいずれかを実行する前に、deploy/SKILL.md をまだ読んでいない場合は、まず .copilot-azure/sessions/{id}/deploy-checklist.md を読み、その後 deploy/SKILL.md を読んでください。⛔ {"skill": "azure-deploy"} は絶対に呼び出さないでください。これは別のワークフロー向けの別のスキルです。

⛔ スキャフォールド後の移行（必須）： scaffold-manifest.json の書き込み直後は、次のアクションとして必ずステップ 8（デプロイ承認ゲート）に進んでください。要約レポートでも、「生成されたファイルはこちらです」というメッセージでも、完了の合図でもありません。context.json に completedPhases: [...,"scaffold"] と currentPhase: "deploy" が設定されていることを確認してください（スキャフォールドのサブエージェントが設定していない場合は、自分で更新してください）。コンテキストから失われている場合（スキャフォールドの参照読み込みは負荷が大きいため）は、approval-gates.md § Deploy Gate を再読し、その後、正確なプロンプト "🚀 Ready to deploy? (Yes / Run manually / Edit plan / Cancel)" を提示してください。このゲートを応答の最後に置き、ユーザーの返答を待ってください。

#	ステップ	アクション	参照
1	セッション確認＋Azure ログイン	セッションを作成／再開し、Azure CLI の認証を確認し、サブスクリプションとユーザー ID を特定します	⛔ session-protocol.md を必ず読んでください
2	スコープのトリアージ	azd マーカーを確認し、トリアージの質問をします。空のワークスペースまたはコードのみ（インフラなし）の場合は、直接ステップ 3 に進みます。	⛔ intent-gathering.md § Scope Triage を読んでください
3	前提条件のスキャン	⛔ completedPhases に "prereq" が含まれている場合はスキップします。それ以外の場合：{"skill": "azure-app-onboard-prereq"} を呼び出します。prereq-output.json を書き込み、context.json を更新します。次の場合は停止します： overallHealth: "blocked"、または routeToSkill が設定されている場合。
4	意図の確認	前提条件の結果を提示し、スタックと Azure サービスを確認し、残りの質問をします。	⛔ intent-gathering.md § After Prereq Returns を読んでください
5	アーキテクチャの計画	prepare-plan.json を書き込みます。	⛔ prepare/SKILL.md を必ず読んでください
6	スキャフォールド承認ゲート	ファイルを生成する前に、計画を表示してユーザーの承認を得ます。	⛔ approval-gates.md § Scaffold Gate を読んでください
7	スキャフォールド	IaC を生成し、自己レビューを行います。scaffold-manifest.json を書き込みます。context.json を更新します。	⛔ scaffold/SKILL.md を必ず読んでください
8	デプロイ承認ゲート	検証の概要を表示します。⛔ 承認後：まず deploy-checklist.md を読み、次に deploy/SKILL.md を読んでください。{"skill": "azure-deploy"} は絶対に使用しないでください。	⛔ approval-gates.md § Deploy Gate を読んでください
9	デプロイ	IaC を実行し、ヘルスチェックを行います。deploy-result.json を書き込みます。	⛔ deploy/SKILL.md を必ず読んでください
10	引き継ぎ	デプロイの ID、クリーンアップ用コマンド、次のステップを提示します。	⛔ handoff-protocol.md を必ず読んでください

エラー処理

エラー	対処
フェーズの失敗	停止し、フェーズとエラーを報告します。再試行、スキップ、中止のいずれにするかはユーザーが決定します。
MCP サーバーが利用不可	影響を受けるチェックをスキップし、免責事項を costEstimate.assumptions[] と各承認ゲートに追加します。
RBAC の不足	必要なロールと az role assignment コマンドを報告します。

共通の参照資料： MCP ツール（フェーズ共通のツールパラメーター） | IaC リソース（トラブルシューティング用の Azure リソースドキュメント）