AppDeploy スキル

概要

この公開取り込みコピーは、https://github.com/sickn33/antigravity-awesome-skills から plugins/antigravity-awesome-skills/skills/appdeploy をパッケージ化して、出所を隠さずに native Omni Skills 編集形式に変換しています。

オペレーターが上流ワークフロー、サポートファイル、リポジトリコンテキストを保持したまま、公開バリデーター と非公開エンハンサーが通常のダウンストリームフローを続行する必要があるときに使用してください。

この取り込みではコピーされた上流ファイルを保持し、metadata.json の external_source ブロックと ORIGIN.md を出所情報の根拠として使用します。

AppDeploy スキル HTTP API 経由で AppDeploy にウェブアプリをデプロイ

取り込まれたソースセクションのうち、公開見出しに明確にマッピングされなかったものは、以下またはサポートファイルに保持されています。注目すべき取り込まれたセクション：利用可能なツール、制限事項。

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

このセクションをトリガーフィルターとして使用してください。オペレーターがファイルを読み込む、コマンドを実行する、またはプルリクエストを開く前に、活性化の境界を明確にすべきです。

• アプリとウェブアプリを計画または構築する場合に使用
• アプリを公開 URL にデプロイする場合に使用
• ウェブサイトまたはウェブアプリを公開する場合に使用
• ユーザーが「これをデプロイして」「これを公開して」または「URL をちょうだい」と言う場合に使用
• すでにデプロイされたアプリを更新する場合に使用
• リクエストが取り込まれたソースの意図と明確に一致する場合に使用：バックエンド API、データベース、ファイルストレージを備えたウェブアプリをデプロイ。ウェブサイトやウェブアプリをデプロイまたは公開したい場合、および公開 URL が必要な場合に使用。curl 経由で HTTP API を使用します。

操作テーブル

状況	ここから開始	重要な理由
初回使用	metadata.json	コピーされたワークフローに触れる前に、external_source ブロック経由でリポジトリ、ブランチ、コミット、取り込まれたパスを確認
出所レビュー	ORIGIN.md	レビュアーに取り込まれたソースの平易言語による監査証跡を提供
ワークフロー実行	SKILL.md	実行を実質的に変える最小のコピーファイルから開始
サポートコンテキスト	SKILL.md	パッケージ全体を読み込まずに、次に関連する最小限のコピーソースファイルを追加
引き継ぎの判断	## Related Skills	タスクが異なる方向にズレたときに、オペレーターがより強力な native スキルに切り替えるのに役立つ

ワークフロー

このワークフローは意図的に編集的かつ運用的です。取り込まれたソースをオペレーターにとって有用に保ちながら、ダウンストリームエンハンサーフローを供給する公開取り込み基準を満たしています。

1. 既存の API キーを確認：
2. プロジェクトルートの .appdeploy ファイルを探す
3. ファイルが存在し有効な api_key を含む場合は、使用方法までスキップ
4. API キーが存在しない場合は、登録して取得：
5. 認証情報を .appdeploy に保存：
6. まず、デプロイ手順を取得：
7. アプリテンプレートを取得：

取り込まれたワークフロー注記

取り込み：セットアップ（初回のみ）

1. 既存の API キーを確認：

   • プロジェクトルートの .appdeploy ファイルを探す
   • ファイルが存在し有効な api_key を含む場合は、使用方法までスキップ

2. API キーが存在しない場合は、登録して取得：

   curl -X POST https://api-v2.appdeploy.ai/mcp/api-key \
     -H "Content-Type: application/json" \
     -d '{"client_name": "claude-code"}'
   

   レスポンス：

   {
     "api_key": "ak_...",
     "user_id": "agent-claude-code-a1b2c3d4",
     "created_at": 1234567890,
     "message": "Save this key securely - it cannot be retrieved later"
   }
   

3. 認証情報を .appdeploy に保存：

   {
     "api_key": "ak_...",
     "endpoint": "https://api-v2.appdeploy.ai/mcp"
   }
   

   .appdeploy をまだ .gitignore に追加していない場合は追加します。

取り込み：ワークフロー

1. まず、デプロイ手順を取得： get_deploy_instructions を呼び出して、制約と要件を理解します。

2. アプリテンプレートを取得： 選択した app_type と frontend_template で get_app_template を呼び出します。

3. アプリをデプロイ： アプリファイルで deploy_app を呼び出します。新規アプリの場合、app_id を null に設定します。

4. デプロイステータスを確認： get_app_status を呼び出してビルドが成功したかどうかを確認します。

5. アプリを表示/管理： get_apps を使用してデプロイしたアプリをリストアップします。

取り込み：利用可能なツール

get_deploy_instructions

deploy_app を呼び出す直前にこれを使用して、デプロイの制約とハードルールを取得します。このツールを呼び出す前に、コード生成を開始してはいけません。このツールは手順のみを返し、デプロイは実行しません。

パラメーター：

deploy_app

ユーザーがウェブサイトまたはウェブアプリをデプロイまたは公開したい場合、および公開 URL が必要な場合に使用します。 ファイルを生成またはこのツールを呼び出す前に、get_deploy_instructions を呼び出してその制約に従う必要があります。

パラメーター：

• app_id: any (必須) - 更新する既存アプリ ID、または新規アプリの場合は null
• app_type: string (必須) - アプリアーキテクチャ：frontend-only または frontend+backend
• app_name: string (必須) - 短い表示名
• description: string (オプション) - アプリが行うことの簡単な説明
• frontend_template: any (オプション) - app_id が null の場合は必須。以下のいずれか：'html-static'（シンプルなサイト）、'react-vite'（SPA、ゲーム）、'nextjs-static'（マルチページ）。テンプレートファイルは自動的に含まれます。
• files: array (オプション) - 書き込むファイル。新規アプリ：カスタムファイル + テンプレートファイルへの差分のみ。更新：diffs[] を使用して変更されたファイルのみ。files[] または deletePaths[] の少なくとも 1 つが必須。
• deletePaths: array (オプション) - 削除するパス。更新のみ（app_id 必須）。package.json またはフレームワークエントリーポイントは削除できません。
• model: string (必須) - このデプロイに使用したコーディングエージェントモデル（最良の理解による）。例：'codex-5.3'、'chatgpt'、'opus 4.6'、'claude-sonnet-4-5'、'gemini-2.5-pro'
• intent: string (必須) - このデプロイの意図。ユーザー起動の例：'initial app deploy'、'bugfix - ui is too noisy'。エージェント起動の例：'agent fixing deployment error'、'agent retry after lint failure'

get_app_template

まず get_deploy_instructions を呼び出します。その後、app_type と frontend_template を決定したら、これを 1 回呼び出します。ベースアプリテンプレートと SDK タイプを返します。テンプレートファイルは deploy_app に自動的に含まれます。

パラメーター：

• app_type: string (必須)
• frontend_template: string (必須) - フロントエンドフレームワーク：'html-static' - シンプルなサイト、最小限のフレームワーク；'react-vite' - React SPA、ダッシュボード、ゲーム；'nextjs-static' - マルチページアプリ、SSG

get_app_status

deploy_app ツール呼び出しが返されたときまたはユーザーがアプリのデプロイステータスを確認するよう要求したときに使用します。または、アプリにエラーがあるか期待どおりに機能していないとレポートされたときに使用します。デプロイステータス（進行中：'deploying'/'deleting'、終端：'ready'/'failed'/'deleted'）、QA スナップショット（フロントエンド/ネットワークエラー）、およびライブフロントエンド/バックエンドエラーログを返します。

パラメーター：

• app_id: string (必須) - ターゲットアプリ ID
• since: integer (オプション) - エポックミリ秒単位のオプションタイムスタンプでエラーをフィルター。指定されると、そのタイムスタンプ以降のエラーのみを返します。

delete_app

アプリを永久に削除する場合に使用します。明示的なユーザーリクエストに対してのみ使用してください。これは取り消し不可です。削除後、ステータスチェックは見つかりませんを返します。

パラメーター：

• app_id: string (必須) - ターゲットアプリ ID

get_app_versions

既存アプリのデプロイ可能なバージョンをリストします。app_id が必須です。最新優先の {name, version, timestamp} アイテムを返します。ユーザーに 'name' を表示します。'version' 値をユーザーに表示しないでください。タイムスタンプ値はユーザーのローカルタイムに変換する必須です。

パラメーター：

• app_id: string (必須) - ターゲットアプリ ID

apply_app_version

既存アプリを特定のバージョンでデプロイ開始します。get_app_versions から 'version' 値（'name' ではない）を使用します。受け入れられたかつデプロイが開始された場合は true を返します；get_app_status を使用して完了を監視します。

パラメーター：

• app_id: string (必須) - ターゲットアプリ ID
• version: string (必須) - 適用するバージョン ID

src_glob

アプリのソーススナップショット内のファイルを発見する必要があるときに使用します。グロブパターンに一致するファイルパスを返します（コンテンツなし）。プロジェクト構造を読み込みまたは検索ファイルの前に探索するのに便利です。

パラメーター：

• app_id: string (必須) - ターゲットアプリ ID
• version: string (オプション) - 検査するバージョン（デフォルトは適用バージョン）
• path: string (オプション) - 検索するディレクトリパス
• glob: string (オプション) - ファイルに一致するグロブパターン（デフォルト：**/*)
• include_dirs: boolean (オプション) - 結果にディレクトリパスを含める
• continuation_token: string (オプション) - ページネーション用の前のレスポンスからのトークン

src_grep

アプリのソースコード内でパターンを検索する必要があるときに使用します。オプションのコンテキスト付きで一致行を返します。正規表現パターン、グロブフィルター、複数の出力モードをサポートします。

パラメーター：

• app_id: string (必須) - ターゲットアプリ ID
• version: string (オプション) - 検索するバージョン（デフォルトは適用バージョン）
• pattern: string (必須) - 検索する正規表現パターン（最大 500 文字）
• path: string (オプション) - 検索するディレクトリパス
• glob: string (オプション) - ファイルをフィルターするグロブパターン（例：'*.ts'）
• case_insensitive: boolean (オプション) - 大文字小文字を区別しないマッチングを有効化
• output_mode: string (オプション) - content=一致行、files_with_matches=ファイルパスのみ、count=ファイルごとのマッチ数
• before_context: integer (オプション) - 各マッチの前に表示する行（0-20）
• after_context: integer (オプション) - 各マッチの後に表示する行（0-20）
• context: integer (オプション) - 前後の行（before_context/after_context をオーバーライド）
• line_numbers: boolean (オプション) - 出力に行番号を含める
• max_file_size: integer (オプション) - スキャンするファイルの最大サイズ（バイト単位、デフォルト 10MB）
• continuation_token: string (オプション) - ページネーション用の前のレスポンスからのトークン

src_read

アプリのソーススナップショットから特定のファイルを読む必要があるときに使用します。行ベースのページネーション（オフセット/リミット）でファイルコンテンツを返します。テキストとバイナリファイル両方を処理します。

パラメーター：

• app_id: string (必須) - ターゲットアプリ ID
• version: string (オプション) - 読み込むバージョン（デフォルトは適用バージョン）
• file_path: string (必須) - 読み込むファイルのパス
• offset: integer (オプション) - 読み込みを開始する行オフセット（0 インデックス）
• limit: integer (オプション) - 返す行数（最大 2000）

get_apps

現在のユーザーが所有するアプリをリストする必要があるときに使用します。ユーザープレゼンテーション用の表示フィールドとツールチェーン用のデータフィールド付きでアプリ詳細を返します。

パラメーター：

• continuation_token: string (オプション) - ページネーション用のトークン

---

scripts/generate-appdeploy-skill.ts によって生成

例

例 1：上流ワークフローを直接要求する

@appdeploy-v2 を使用して <タスク> を処理してください。コピーされた上流ワークフローから開始し、結果を変える最小限のファイルのみを読み込み、回答で出所情報を可視に保ってください。

説明： これはオペレーターがインポートされたワークフローを必要とするが、リポジトリ全体は不要な場合の最も安全な出発点です。

例 2：出所情報に基づいたレビューを要求する

@appdeploy-v2 を metadata.json と ORIGIN.md に対してレビューしてから、どのコピーされた上流ファイルをまず読み込むか、そしてなぜかを説明してください。

説明： レビューまたはトラブルシューティング前に、出所と ファイル選択の正確で監査可能な説明が必要な場合はこれを使用します。

例 3：実行前にコピーされたサポートファイルを絞る

@appdeploy-v2 を <タスク> に使用してください。結果を変えるコピーされた参照、例、またはスクリプトのみを読み込み、進行する前にファイルを明示的に名前付けしてください。

説明： これにより、デフォルトでコピーされたパッケージ全体を読み込むのではなく、スキルを段階的な情報公開に合わせて保ちます。

例 4：レビュアーパケットを構築する

@appdeploy-v2 をコピーされた上流ファイルと出所情報を使用してレビューしてから、マージ前のギャップをまとめてください。

説明： これは PR が人間レビューを待機しており、反復可能な監査パケットが必要な場合に便利です。

取り込まれた使用方法注記

取り込み：使用方法

MCP エンドポイントに JSON-RPC 呼び出しを行います：

curl -X POST {endpoint} \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "{tool_name}",
      "arguments": { ... }
    }
  }'

ベストプラクティス

生成された公開スキルを上流リポジトリの周囲の可視化パッケージングレイヤーとして扱います。目標は出所情報を明示的に保ち、実行を実質的に改善するコピーされたソース資料のみを読み込むことです。

• インポートされたスキルを上流リポジトリに根ざしておき、ソース資料がサポートできない手順を発明しないでください。
• ワークフローが監査可能で高速にレビュー可能なように、サポートファイルの最小限の有用なセットを優先させてください。
• 出所情報、ソースコミット、およびインポートされたファイルパスをノートと PR 説明で可視に保ってください。
• ジェネリックレビュー定型文に依存するのではなく、ワークフローを正当化するコピーされた上流ファイルを直接ポイントしてください。
• 生成された例をスカフォールディングとして扱い、実行する前に具体的なタスクに適応させてください。
• アーキテクチャ、デバッグ、設計、またはセキュリティの懸念が支配的になったときに、より強力な native スキルにルーティングしてください。

トラブルシューティング

問題：オペレーターがインポートされたコンテキストをスキップして、ジェネリックに答えた

症状： 結果が plugins/antigravity-awesome-skills/skills/appdeploy の上流ワークフローを無視し、出所情報に言及せず、コピーされたソースファイルを一切使用しません。 解決策： metadata.json、ORIGIN.md、および最も関連する取り込まれた上流ファイルを再度開きます。最初に external_source ブロックをチェックしてから、続行する前に出所情報を改めて述べます。

問題：取り込まれたワークフローがレビュー中に不完全に感じる

症状： レビュアーは生成された SKILL.md を見ることができますが、現在のタスクに対してどの参照、例、またはスクリプトが重要かをすばやく判断できません。 解決策： 使用したパスを正当化するコピーされた参照、例、スクリプト、またはアセットを正確にポイントしてください。ギャップがまだ現実的な場合は、それを非表示にするのではなく PR に記録してください。

問題：タスクが異なる特化に漂流した

症状： インポートされたスキルは正しい場所から開始しますが、作業が native スキルがより良く処理するデバッグ、アーキテクチャ、設計、セキュリティ、またはリリースオーケストレーションに変わります。 解決策： 関連スキルセクションを使用して意図的に引き継ぎます。インポートされた出所情報を可視に保つので、次のスキルは盲目的に開始する代わりに適切なコンテキストを継承します。

関連スキル

• @00-andruia-consultant - このインポートされたスキルがコンテキストを確立した後、その native 特化によって作業がより良く処理される場合に使用します。
• @00-andruia-consultant-v2 - このインポートされたスキルがコンテキストを確立した後、その native 特化によって作業がより良く処理される場合に使用します。
• @10-andruia-skill-smith - このインポートされたスキルがコンテキストを確立した後、その native 特化によって作業がより良く処理される場合に使用します。
• @10-andruia-skill-smith-v2 - このインポートされたスキルがコンテキストを確立した後、その native 特化によって作業がより良く処理される場合に使用します。

追加リソース

このサポートマトリックスと以下のリンクされたファイルをこのインポートされたスキルのオペレーターパケットとして使用してください。ジェネリック定型文ではなく、実際にコピーされたソース資料を反映する必要があります。

リソースファミリー	レビュアーに提供するもの	パス例
references	上流からコピーされた参照ノート、ガイド、または背景資料	references/n/a
examples	上流からコピーされた工作例または再利用可能なプロンプト	examples/n/a
scripts	実行またはバリデーションを変える上流ヘルパースクリプト	scripts/n/a
agents	インポートされたパッケージの一部である、ルーティングまたは委譲ノート	agents/n/a
assets	ソースパッケージからコピーされたサポートアセットまたはスキーマ	assets/n/a

取り込まれた参照ノート

取り込み：制限事項

• このスキルは、上記で説明されているスコープと明確に一致するタスクに対してのみ使用してください。
• 出力を環境固有バリデーション、テスト、またはエキスパートレビューの代替として扱わないでください。
• 必須入力、パーミッション、セキュリティ境界、または成功基準が不足している場合は、中止して説明を求めてください。