amplicode-install

amplicode-install

ユーザーが選択した、ローカルにインストール済みのすべての IntelliJ IDEA（Ultimate／Community）および GigaIDE に Amplicode IntelliJ プラグインをインストールします。

このスキルでできること

1. プラットフォーム固有の検出スクリプトを実行し、マシンにインストールされている IntelliJ ベースの IDE を検出します。
2. IDEA Ultimate（IU）、IDEA Community（IC）、および GigaIDE に絞り込みます。それ以外はすべて除外します。
3. Amplicode がすでにインストールされている IDE を除外します。
4. 候補が複数残っている場合、どの IDE にインストールするかをユーザーに尋ねます。
5. 標準の JetBrains CLI を実行します：<ide-binary> installPlugins com.haulmont.amplicode https://amplicode.ru/marketplace。IDE 自体が適切なバージョンを選び、ZIP をダウンロードして、適切なプラグインディレクトリに展開します。
6. IDE を起動して任意のプロジェクトを開き、Amplicode のウェルカム画面にある 「Настроить Spring Agent」ボタンをクリックするようユーザーに案内します。このボタンをクリックすることで（このボタンのみが対象です）、MCP の自動設定と spring-skills のインストールが実行されます。

このスキルでできないこと

• MCP クライアントの設定は書き込みません。Amplicode プラグインがポートを認識するには、IDE 内で MCP サーバーが実行されている必要があります。サポート対象のエージェントの設定を入力できるのはプラグイン自体のみです。これは、ユーザーがウェルカム画面の「Настроить Spring Agent」をクリックしたときに行われます（IDE の起動時に自動で行われるものではありません）。
• spring-skills やエージェント側のスキルパッケージはインストールしません。これらもウェルカム画面のボタンからインストールされます。
• プラグイン ZIP を手動でダウンロードしたり、展開したりしません。JetBrains の installPlugins CLI が、取得、IDE ビルドとのバージョン照合、展開を処理します。

手順

1. 検出スクリプトを実行する

スクリプトは、この SKILL.md と同じ階層の scripts/ にあります。ユーザーの OS に合ったスクリプトを実行し、標準出力を JSON 配列として解析します。スクリプトはすでに対応 IDE（IDEA Ultimate／Community／GigaIDE）に絞り込むため、エージェントが各要素から取得する必要があるフィールドは amplicodeInstalled、name、running、pid、hostsCurrentProcess、dataDirectoryName、exePath、appBundle のみです。

• macOS／Linux： bash scripts/detect-ides.sh
• Windows： pwsh scripts/detect-ides.ps1（pwsh が利用できない場合は powershell）

JSON 配列が空の場合は、対応する IDE が見つからなかったことをユーザーに伝え、処理を終了します。

2. 絞り込む

• amplicodeInstalled: true のエントリを除外します。再インストールはせず、確認もしません。
• 残りがない場合は、対応するすべての IDE に Amplicode がすでにインストールされていることをユーザーに伝え、処理を終了します。

3. インストール先を選ぶ

• 候補がちょうど 1 つの場合： 確認せずにその IDE にインストールします。使用する IDE をユーザーに伝えます。
• 候補が 2 つ以上の場合： クライアントが提供するインタラクティブなプロンプトツールを使い、複数選択の質問をします。選択肢は各 IDE（ラベルは name）です。「すべて」を別の選択肢として追加しないでください。複数選択で対応できます。すべて選択することを推奨しますが、最終的な判断はユーザーに委ねます。

3a. 実行中の IDE を処理する（自動再起動フロー）

選択した IDE ごとに、検出 JSON の running フラグを確認してください。その値を信頼してください。独自に pgrep で確認してはいけません。pgrep は長い JVM コマンドラインを切り詰め、誤検出を招きます。 running: true の場合、JetBrains CLI は「Only one instance of IDEA can be run at a time」というエラーで失敗します。

セルフホストの確認（最初に行ってください）。 選択した IDE のうち running: true のものについて、hostsCurrentProcess を確認してください。true の場合、あなたはその IDE のターミナル内で実行されています。IDE に SIGTERM を送ると、installPlugins が実行される前にあなたも終了し、IDE が閉じたままプラグインがインストールされません。そのような IDE では、自動再起動を決して提案しないでください。 その IDE については以下の質問を省略し、「ユーザーが 2 つ目の選択肢を選んだ場合」の後に記載されている手動の手順に進んでください。その際、IDE 自身の exePath を使用します。理由をユーザーの言語で最初に伝えてください。「この IDE 内で実行されています。IDE を閉じると私も一緒に終了し、インストール手順が実行されません。そのため、この作業はご自身で行っていただく必要があります。」

選択した IDE のうち、running: true かつ hostsCurrentProcess: false のものが 1 つ以上ある場合、それらの IDE について自動再起動フローを提案してください。ユーザーに見せる質問は、ユーザーの言語で表現してください（ユーザーが会話で使用している言語に合わせてください）。以下の文言は英語の基準例です。

「 は現在実行中です。安全に終了してプラグインをインストールし、再起動できます。IDE に未保存の変更がある場合は保存ダイアログが表示され、終了できません。その場合は処理を中止し、手動で対応していただきます。よろしいですか？」

次の 2 つの選択肢から 1 つを選ぶ質問をしてください。

• 「はい。終了して、インストールし、再起動する」（推奨）
• 「自分で行う」

ユーザーが 2 つ目の選択肢を選んだ場合、何も言わずに停止したり、単に「このスキルを再実行してください」と伝えたりしないでください。ユーザーがまさにその IDE 内からあなたを実行している場合、IDE を閉じた後にスキルを再実行することはできません。その代わり、ユーザーが自分で実行するための正確なコマンドと、インストール後の手順を提示してください。ユーザーの言語で次のように伝えます。

IDE を自分で閉じてから、ターミナルで次のコマンドを実行してください。

"<exePath>" installPlugins com.haulmont.amplicode https://amplicode.ru/marketplace

<exePath> は検出 JSON にある IDE のランチャーパスに置き換えてください（通常はスペースが含まれるため、引用符で囲んでください）。処理が完了するまで待ってください。終了コード 0 はプラグインがインストールされたことを意味します。

次に IDE を再度開いてください。開いているプロジェクトで、次の操作を行います。

1. Amplicode のウェルカム画面が表示された場合は、Настроить Spring Agent をクリックします。
2. 表示されない場合は、Find Action（macOS では Cmd+Shift+A、Windows/Linux では Ctrl+Shift+A）から手動で開き、Spring Agent Toolkit と入力して Enter キーを押し、Настроить Spring Agent をクリックします。
3. その後、新しい MCP サーバー設定を読み込ませるため、使用中の MCP クライアントを再起動してください。

その後、スキルを停止してください。

ユーザーが自動再起動に同意した場合、実行中の選択済み IDE ごとに、正常終了 → 待機 → インストール → 再起動の順で行います。

終了（SIGTERM。SIGKILL は決して使用しないでください）：

• macOS / Linux：kill -TERM <pid>
• Windows：taskkill /PID <pid>（/F は付けません）

検出スクリプトを再実行し、同じ dataDirectoryName を確認しながらポーリングして、終了を待ちます。running: false（.pid ファイルが削除されている状態）になれば IDE は完全に終了しています。5 秒ごとに、最大 30 秒間ポーリングしてください。1 秒ごとのポーリングは単なるノイズになるため、行わないでください。

30 秒後も実行中の場合は停止してください。ユーザーの言語で次のように伝えます。「IDE は 30 秒以内に終了しませんでした。未保存の変更を確認するダイアログが開いている可能性があります。保存して手動で終了してから、このスキルを再実行してください。」再試行や強制終了はしないでください。

インストールは手順 4 の説明に従ってください。

再起動：

• macOS：open -a "<appBundle>"（appBundle はこの用途に使います。設定されていない場合は open -a "<exePath>" にフォールバックします。）
• Linux：nohup "<exePath>" >/dev/null 2>&1 &（エージェントのプロセスグループから切り離します。）
• Windows：PowerShell では Start-Process -FilePath "<exePath>"、cmd では start "" "<exePath>" を実行します。

4. インストール

選択した IDE ごとに、次を実行します。

"<exePath>" installPlugins com.haulmont.amplicode https://amplicode.ru/marketplace

注意：

• 通常の Bash 呼び出しとして実行します。exePath は必ず引用符で囲んでください。パスには空白が含まれていることがよくあります。
• ユーザーがその IDE を開いている間は実行しないでください。JetBrains の CLI は、実行中のインスタンスがあると予期しない動作をする場合があります。IDE が実行中と思われる場合は、まず閉じるようユーザーに依頼してください。
• 対象が複数ある場合は、並列ではなく順番に実行します。呼び出しごとに、その IDE のプラグインディレクトリに書き込む必要があります。
• 終了コードが 0 以外の場合、その IDE のインストールは失敗と見なします。ユーザーに stderr を表示し、残りの IDE の処理を続けます。

5. 完了

次の内容をユーザーに伝えます（ユーザーの言語に翻訳し、会話で使用している言語に合わせてください）。

Amplicode プラグインを次の IDE にインストールしました：。

次の手順：

1. IDE で任意のプロジェクトを開きます。Amplicode のウェルカム画面が自動的に表示されます。 表示されない場合は、手動で開きます：Find Action（macOS では Cmd+Shift+A、Windows/Linux では Ctrl+Shift+A）→ Spring Agent Toolkit と入力 → Enter。
2. その画面で「Настроить Spring Agent」ボタンをクリックしてください。 その後、プラグインが対応エージェントの設定に Amplicode MCP サーバーを書き込み、spring-skills をインストールします。このボタンをクリックしないと、MCP は設定されません。ウェルカム画面は、IDE のスタート画面ではなく、プロジェクトを開いたときにのみ表示されます。
3. 現在使用している MCP クライアントを再起動してください。 ほとんどのクライアントは起動時にのみ MCP 設定を読み込むため、新しく追加した amplicode サーバーは現在のセッションには表示されません。再起動後、クライアントの MCP サーバー一覧を確認してください。

翻訳後のメッセージでも Настроить Spring Agent と Spring Agent Toolkit はそのまま使用してください。これらは IDE の UI に表示される実際のラベルであり、翻訳する文字列ではありません。

6. 手順 5 の失敗を検出する（任意。クライアントの MCP サーバー一覧を確認できる場合）

ユーザーが MCP クライアントを再起動して会話を続けた後、設定済み MCP サーバーの一覧を確認でき、amplicode が存在しない場合は、ユーザーがウェルカム画面のボタンを押し忘れた可能性が高いです。ユーザーの言語で次のように伝えてください。

amplicode MCP サーバーが接続されていないようです。ウェルカム画面のボタンがまだ押されていない可能性があります。IDE で任意のプロジェクトを開き、Find Action（Cmd+Shift+A / Ctrl+Shift+A）→ Spring Agent Toolkit と進み、表示された画面で Настроить Spring Agent をクリックしてください。その後、このクライアントをもう一度再起動してください。