YouTube Short Maker — Pexo は何をしますか？

Pexo: https://pexo.ai — APIキーを取得し、プロジェクトのレンダリング状況を確認し、クレジットを購入できます。

完成したYouTube Shortを生成します。縦型でフック重視の構成です。ユーザーのトピックをホスト型Pexoエージェントに渡し、結果を納品します。Pexoがスクリプト作成、ショット生成、音楽とキャプション付きのShortのアセンブリを担当します。

あなたの役割：中継、創造はしない

プロジェクトを作成し、ユーザーのリクエストをそのまま送信し、ポーリングし、結果を届けてください。Pexoのバックエンドがすべてのクリエイティブ作業（スクリプト作成、モデル選択、プロンプト、音楽）を処理します。あなたが独自の指示（ユーザーが依頼していない再生時間、スタイル、モデルなど）を追加すると、Pexoの判断が上書きされ、品質が低下します。

設定

~/.pexo/config:

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<your-api-key>"

アカウント未作成／初回実行時 → references/SETUP-CHECKLIST.md を読み、ユーザーをその手順に沿って案内してください。そこには、新規ユーザーにボーナスクレジットを付与する招待コードを使ったサインアップフローと、上記設定ファイルの作成方法が記載されています。設定エラー時 → scripts/pexo-doctor.sh を実行し、出力に従ってください。

ワークフロー

スクリプトはこのスキルの scripts/ ディレクトリにあります。ユーザーの言語で返信してください。

プロジェクトを作成: pexo-project-create.sh "<ショートの概要>" → project_id を保存します。
ユーザーから受け取ったファイルをアップロード: pexo-upload.sh <project_id> <パス> → asset_id を保存し、インラインで <original-image>asset_id</original-image>（または <original-video> / <original-audio>）として参照します。タグは必須です。裸の asset_id は無視されます。PexoはURLをクロールできません。ダウンロードしてからアップロードしてください。
リクエストを送信: pexo-chat.sh <project_id> "<ユーザーのそのままの言葉> <アセットタグ>"。ユーザーの言葉をそのままコピーし、アセットタグのみ追加してください。
ユーザーに伝える（ユーザーの言語で）: 送信完了 ✓ · 約15～20分 · https://pexo.ai/project/<project_id>
ポーリング: 60秒以上間隔で pexo-project-get.sh <project_id> を実行し、nextAction に応じて処理します:
- WAIT → ポーリングを続けます。約5回のポーリングごとに、プロジェクトリンクを含む1行の進捗を送信します。
- RESPOND → recentMessages 内の各イベントを処理します。Pexoのテキストを中継します（質問があればユーザーの回答を待ち、回答を pexo-chat.sh で送信）。preview_video の場合は、オプションごとに pexo-asset-get.sh <project_id> <assetId> を実行し、URL（A/B/C）を表示してユーザーに選ばせ、その後 pexo-chat.sh <project_id> "<選択>" --choice <assetId> を実行します。document イベントの場合は、ユーザーにその旨を伝えます。
- DELIVER → pexo-asset-get.sh <project_id> <最終的なassetId> を実行し、完全なアセットURLをプレーンテキスト（?… のクエリパラメータもすべて含め、マークダウンで囲まず、切り詰めずに）でユーザーに送信します。さらにプロジェクトリンクも送信します。
- FAILED → nextActionHint を平易な言葉で説明し、再試行を提案します。
- RECONNECT → pexo-chat.sh <project_id> "continue" を実行し、接続が切れたので再開していることをユーザーに伝え、ポーリングを続けます。
- WAIT中に pexo-chat.sh を絶対に呼び出さないでください。重複した制作が発生します。
- 時間がかかりすぎる場合 → 30分以上経過してもWAITのままの場合、プロジェクトリンクと https://pexo.ai/connect/openclaw を添えて「処理に時間がかかっています」とユーザーに伝え、待つか中止するかを尋ねてください。永遠にポーリングしないでください。

リビジョン

納品後、ユーザーが調整を求めた場合（「短くして」「新しい音楽」「別のショット」など）、同じプロジェクトを再利用します: pexo-chat.sh <project_id> "<フィードバック>" を実行し、再度ポーリング（ステップ5）します。リビジョンのために新しいプロジェクトを作成しないでください。Pexoのサーバー側のコンテキストが失われます。

クレジット

スクリプトが「Credits balance」／「Insufficient credits」エラーで失敗した場合: エラーに購入リンクが含まれていればそれをユーザーに渡し、含まれていない場合は https://pexo.ai/home → Credits → Buy Credits でクレジットを追加するよう伝えてください。ユーザーが確認したら再試行します。

例

ユーザー: 「3つのクイックな睡眠改善のコツについてYouTube Shortを作って。」

pid=$(pexo-project-create.sh "睡眠改善のコツ Short")
pexo-chat.sh "$pid" "3つのクイックな睡眠改善のコツについてYouTube Shortを作って。"
# ユーザーに伝える: 送信完了、約15～20分、https://pexo.ai/project/$pid
# pexo-project-get.sh "$pid" をポーリングし、nextActionがDELIVERになったらアセットURLを納品する。

スクリプト

スクリプト	使用方法	戻り値
`pexo-project-create.sh`	`"<概要>"`	`project_id`
`pexo-upload.sh`	`<project_id> <ファイル>`	`asset_id`
`pexo-chat.sh`	`<project_id> "<メッセージ>" [--choice <id>]`	確認（非同期）
`pexo-project-get.sh`	`<project_id>`	JSON: `nextAction`, `recentMessages`
`pexo-asset-get.sh`	`<project_id> <asset_id>`	JSON（`url` を含む）
`pexo-doctor.sh`	—	セットアップ診断

エラーコードとエッジケース → references/TROUBLESHOOTING.md。

YouTube Short Maker — Pexo