dx-lifecycle-center

ライフサイクルセンター：組織を接続してメタデータをデプロイする

このスキルでは、ユーザーがデプロイできる組織を管理し、そこへデプロイします。すべての操作はソース組織から実行されます。ソース組織とは、ユーザーが構築した組織で、DX Inspector が実行される場所です。すべての接続と環境は、ソース組織に保存されます。

操作

操作	名前	内容	詳細
A	組織を一覧表示	DX Inspector に接続されている組織（デプロイ先）、または現在の組織の詳細を表示します。ユーザーが指定したデプロイ先も解決します。	references/list-orgs.md
B	組織を接続	新しい Sandbox、スクラッチ組織、本番組織、または OrgFarm 組織をデプロイ先として接続するか、途中まで完了した接続を修復します。ユーザーはリンクからサインインします。	references/connect-org.md
C	ライフサイクルセンターの組織	ライフサイクルセンターの組織（認証情報 ALMDevOpsCenterHub）を接続、修復、または確認します。	references/hub-org.md
D	デプロイ	ソース組織から接続済みのデプロイ先へコンポーネントをデプロイ、検証、またはクイックデプロイし、完了するまでポーリングします。	references/deploy.md

接続（B）とデプロイまたはクイックデプロイ（D）は組織を変更するため、先にユーザーの確認を待ちます。一覧表示、ステータス確認、検証の実行、ポーリングでは、デプロイ先の組織は変更されません。

重要な用語

用語	意味
ソース組織	ユーザーが構築した組織です。ユーザーが指定したエイリアスを使用し、指定がない場合は sf org display --json のデフォルト組織を使用します。コンポーネントはすでにその組織に存在している必要があります。
DX Inspector 環境	Named Credential を持つ、ソース組織内の DevopsEnvironment レコードです。デプロイ先はこれらのレコードのみです。
デプロイ先	状態が selectable の環境です。expired または unauthenticated の環境はデプロイ先ではありません。
ライフサイクルセンターの組織	ライフサイクルセンターのハブです。デプロイ先になることはない、別の接続です。

ルーティング（決定的）

スクリプトとリファレンスは、このスキルのフォルダー（このファイルがあるフォルダー）内のパスです。このスキルは、以下のすべてのリクエストを担当します。次のルールに順番どおりに従い、最初に一致したルールを適用してください。これらのリクエストを別のスキルに渡したり、一般知識に基づいて回答したりしないでください。

#	リクエスト	操作
1	リクエスト内でライフサイクルセンターの組織に言及している場合。表記は問いません：「Lifecycle Center」、「lifecyclecenter」、「lifecycle-center」、「lifecycle_center」（references/hub-org.md の一致ルールに従います）	C
2	組織、URL、組織 ID、エイリアス、または環境名を指定して、コンポーネントをデプロイ、検証、クイックデプロイ、またはプッシュするリクエスト。または requestId もしくは検証 ID が指定されている場合	D
3	接続済みの組織または環境の表示、一覧表示、選択。「デプロイできる組織はどれか」という質問、または現在の組織の詳細	A
4	組織またはその認証情報の接続、追加、ログイン、再接続、または修復	B
5	接続済みの組織または DX Inspector 環境に関するその他の内容	A

ライフサイクルセンターの組織に関するルール（1）には、2 つの除外事項があります。「Dev Hub」はライフサイクルセンターの組織ではありません。また、「DevOps Center orgs」、「DX Inspector orgs」、「environments」、「orgs connected to DX Inspector」などの複数形の表現も、ライフサイクルセンターの組織ではありません。これらはルール 2～5 に従ってルーティングしてください。詳細：references/hub-org.md。

表現の読み取り。 ルールを適用する前に、リクエストを正規化します。小文字に変換し、ハイフン、アンダースコア、余分なスペースはすべて 1 つのスペースとして扱い、句読点、5 文字以上の単語にある 1 文字の誤字、「please」、「can you」、「I want to」などの前置きは無視します。（ルール 1 では、references/hub-org.md に記載された 2 つの形式も使用します。）その後、以下のグループにある単語が 1 つでも含まれていれば一致とします。完全に同じフレーズである必要はありません。

操作	アクションを表す語（あらゆる形：「deploy」、「deploying」、「deployment」）	対象を表す語
D	deploy、deployment、validate、validation、check only、dry run、quick deploy、quickdeploy、push、send、ship、move、copy、release、追加またはインストール（対象がコンポーネントの場合）	コンポーネント、メタデータ、クラス、フロー、オブジェクト、または送信先として指定された組織（「to」、「into」、「onto」）
B	接続、connection、追加、リンク、接続、hookup、認可、認証、ログイン、login、サインイン、セットアップ、setup、登録、オンボード、再接続、修復、修正、更新	org、環境、env、sandbox、scratch、production、prod、orgfarm、org farm
A	表示、一覧表示、見る、閲覧、表示、どの、何、選択、選ぶ、利用可能	orgs、environments、envs、targets、connections、「どこにデプロイできますか」

D のアクション語と送信先を含むリクエスト、または動詞にかかわらずコンポーネントと送信先を指定するリクエスト（「AccountService を QA sandbox に追加」など）は、B の語も含まれていても D です。対象が組織または環境である B のアクション語を含むリクエストは、「connected」や「linked」などの語も含まれていても B です（「sandbox を再接続してください。接続されていないと表示されます」など）。B の語だけを含むリクエストは B です。A の語だけを含むリクエスト、または何が接続されているかについての質問は A です。単独の requestId、または「デプロイのステータス」は D です。どのグループにも該当しない場合は、以下の曖昧なプロンプトの表を使用してください。

複数の作業が混在するリクエスト（例：「sandbox に接続して、AccountService をそこにデプロイ」）は、最も番号の小さい該当グループに分類します。この場合は D となり、対象が未接続であれば B も実行されます。

曖昧なプロンプト。 メッセージが「deploy」、「変更を push」、「org に接続」などだけの場合は、推測したり、API を呼び出したりしないでください。最初に不足している入力を補う質問を1つだけしてください。

意図	次の順序で質問
デプロイ	1. どのコンポーネントですか？（references/deploy.md、ステップ1） 2. 対象の org はどれですか？
接続	1. 「sandbox または scratch org、production org、OrgFarm org のどれですか？」 2. 環境に付ける短い名前（英字のみ）は何ですか？
どちらか不明	「org に接続しますか、それともコンポーネントをデプロイしますか？」

DX Inspector のコンテキストがない単独の「deploy」は、デプロイではなく質問です。

常に適用されるルール

• 対象は、ソース org 内の DX Inspector 環境から取得してください。sf org list やローカルのエイリアスから取得してはいけません。
• selectable でない対象、ソース org、Lifecycle Center org にはデプロイしないでください。
• Lifecycle Center org は一覧に表示せず、一覧表示時に言及もしないでください。ユーザーから尋ねられた場合に限り、説明してください。
• org を変更するすべての呼び出しの前に確認を取ってください。接続（connect-org.md、ステップ1）とデプロイ（deploy.md、ステップ4）が該当します。確認が不要なのは validate モードだけです。
• デプロイの途中で開始した接続が完了したら、org が接続されたことと、デプロイを続行することをユーザーに伝え、その後デプロイの確認を求めてください。接続だけでデプロイが実行されることはありません。
• sandbox と scratch org は同じ種類（SANDBOX）です。URL も同様に扱ってください。
• API 呼び出しごとに試行は1回のみです。ループで再試行したり、タイムアウト後に再送信したり、ID、認証情報名、ステータスを捏造したりしないでください。
• アクセストークンを求めたり、表示したり、渡したりしないでください。行 ID や認証情報名も表示しないでください。
• ブラウザーを開いたと言わないでください。ログインリンクを提示し、ユーザーが done と返信するまで待ってください。
• 不足している入力を推測しないでください。最初に不足している入力について質問を1つしてください。
• URL のホストから決まらない org の種類は、ユーザーに確認してください。環境名から推測しないでください。

ユーザーに表示される内容

操作後	返信内容
A 一覧	テーブルと締めの文だけを表示します（list-orgs.md、セクション 4）。生の JSON や追加の案内は表示しません。
A が有効になっていない場合	list-orgs.md、セクション 2 の 1 文だけを表示します。それ以外は何も表示しません。
B 接続	ボタン風のリンクを含むサインインレイアウト（connect-org.md、ステップ 2）を表示し、完了後に接続済みレイアウトを表示します。環境名、組織ホスト、タイプ、ステータスを含みます（connect-org.md、ステップ 5）。
C	hub-org.md の文をそのまま表示します。接続時は、B と同じサインインレイアウトと接続済みレイアウトをハブ形式で表示します。
D	平易な言葉でレポートを表示します。デプロイされた内容、デプロイ元、デプロイ先、結果を含みます（deploy.md、ステップ 7）。生の JSON は表示しません。デプロイが約 2 分後も実行中の場合は、requestId と、処理中である旨、ステータスを確認するために ID を返信するよう依頼する文を表示します（deploy.md、ステップ 6）。

失敗した場合

失敗	確認先
一覧の取得またはターゲットの検索に失敗した	references/list-orgs.md、セクション 2
接続手順に失敗した	references/troubleshooting.md
デプロイまたは検証に失敗した	references/error-handling.md
ターゲットのログイン情報が古い	その環境に再接続し（references/connect-org.md、修復手順）、再試行の前に確認します

参照資料

• references/list-orgs.md：操作 A。リゾルバースクリプト、照合ステータス、一覧テーブル、有効になっていない場合の処理。
• references/connect-org.md：操作 B。モード、ステップ 0〜5、組織への接続ルール。
• references/hub-org.md：操作 C。Lifecycle Center 組織。ハブ名、返信、ルール。
• references/deploy.md：操作 D。デプロイ、検証、クイックデプロイ、ポーリングのステップ 1〜7。
• references/request-body.md：デプロイ、検証、クイックデプロイのリクエストボディとテストレベル。
• references/connect-api.md：環境 API と setupNamedCredential のリクエストおよびレスポンス形式、ステータス確認。
• references/troubleshooting.md：接続エラーコードと復旧方法。
• references/error-handling.md：デプロイエラーコード。
• examples/workflows.md：各操作のプロンプト例。
• scripts/resolve-environment.sh：読み取り専用の一覧表示と識別子リゾルバー。
• scripts/poll-deploy-status.sh：読み取り専用のステータスポーラー。Simple Deploy エンドポイントと DevopsRequestInfo を読み取り、失敗時にはコンポーネントエラーを報告します。