pippit-skill

Pippit スキルのワークフロー

海外向けの Pippit.ai ワークフローには、この自己完結型スキルを使用します。両方のバックエンドスクリプトセットがローカルに含まれています。

• scripts/nest/：Pippit Nest による AI 生成、編集、参照素材のアップロード、進行状況のポーリング、結果のダウンロード。
• scripts/publish/：ソーシャルアカウントの検索、動画のアップロード、公開予約、タスクの CRUD、分析。

外部の Pippit スキルディレクトリは必要ありません。ローカルコマンドでは、{baseDir} をこのスキルのフォルダーとして解決してください。公開ペイロードのフィールドの詳細については、references/publishing-api.md をお読みください。

Pippit Nest は、クリエイティブの解釈、プロンプトの拡張、モデルの選択、ストーリーボードの作成、ワークフローの振り分けを担当します。ローカルエージェントは、参照素材のアップロード、ユーザーの依頼の受け渡し、進行状況のポーリング、確認依頼への対応、結果のダウンロードのみを行い、ユーザーから依頼された場合に、選択された動画を公開します。

依頼の振り分け

• クリエイティブのみ：scripts/nest/ を使用して生成または編集し、ポーリングして出力をダウンロードします。ユーザーから公開を依頼されていない限り、ローカルファイルを返した時点で終了します。
• 公開のみ：既存のローカル動画、連携済みアカウントの確認、公開予約、タスクの CRUD、分析には scripts/publish/ を使用します。
• 作成から公開まで：まず scripts/nest/ を使用し、生成された動画をダウンロードしてから、scripts/publish/ を使用してアップロードと公開予約を行います。
• 画像のみの出力：公開できるのは動画のみです。画像やポスターの公開を希望するユーザーには、まず動画を生成するか、画像を動画に変換するかを確認してください。

クリエイティブ依頼への対応

• ユーザーのクリエイティブ依頼または編集依頼は、そのまま scripts/nest/submit_run.py --message に渡してください。ユーザーから明示的に依頼されていない限り、短縮、要約、書き換え、推敲、翻訳、分割したり、プロンプトの文言を追加したりしないでください。
• 1つのクリエイティブタスクは、1回の Nest 送信として扱ってください。ユーザーから明示的に個別の実行を依頼されていない限り、1つの依頼をショット別、シーン別、アセット別の実行に分けないでください。
• ストーリーボードを手動で作成したり、カメラプランを推測したり、スタイルを分析したり、モデルを選んだり、サブプロンプトをローカルでオーケストレーションしたりしないでください。これらは Pippit Nest に任せてください。
• 参照画像や動画が提供された場合は、それらをアップロードし、返されたアセット ID とともに元の依頼を送信してください。ユーザーの文言を、参照素材に関する独自の説明に置き換えないでください。
• Pippit が確認や応答を求めた場合は、その質問をユーザーに提示し、ユーザーの回答を同じ thread_id に送信してください。ユーザーに代わって回答しないでください。

アクセスキー

作成と公開の両方で、同じ Pippit アクセスキーを使用します。次の順に解決してください。

1. PIPPIT_ACCESS_KEY
2. PippitAccessKey
3. $CODEX_HOME/pippit-skill/secrets.json のローカルキャッシュ

次のいずれかのローカル保存スクリプトを使用して、新しいキーを一度保存してください。

python3 {baseDir}/scripts/nest/save_access_key.py --access-key "..."

アクセスキーを捏造、取得したり、キー全体を出力したりしないでください。キーが利用できない場合は、英語で次のように応答してください："No Pippit access key is configured. Please get one from https://www.pippit.ai, then provide it or save it before continuing."

エンドツーエンドのフロー

1. 不足している最小限の情報を収集します。
   • クリエイティブの依頼内容、および参考画像／動画ファイル
   • 対象プラットフォーム：TikTok、Facebook Page、または Instagram
   • 連携済みのプラットフォームアカウント
   • タイトルまたはキャプション
   • 公開モード：ユーザーが予約公開を明示的に希望しない限り、デフォルトの公開
   • 予約公開の場合：タイムゾーンを含む公開予定時刻
2. Pippit での生成／編集にはクレジットが消費されることをユーザーに伝え、明示的な確認を得てから submit_run.py を呼び出します。
3. 参考ファイルが提供されている場合は、scripts/nest/upload_file.py を使って1つずつアップロードします。
4. アップロード済みのアセット ID がある場合はそれらを含め、ユーザーの元のクリエイティブ依頼を単一の scripts/nest/submit_run.py --message の値として送信します。
5. 返された場合は web_thread_link を表示し、thread_id と run_id の両方を指定して scripts/nest/get_thread.py でポーリングします。
6. Pippit から説明や操作を求められた場合は、その質問をユーザーに提示し、回答を同じスレッドに送信します。
7. 生成された結果の URL から、scripts/nest/download_results.py を使ってダウンロードします。
8. 公開する生成動画ファイルを選択します。複数の動画があり、ユーザーが選択していない場合は、どれを使うか尋ねます。
9. scripts/publish/list_user_platform_account.py で連携済みのソーシャルアカウントを一覧表示します。使用可能なアカウントがない場合は処理を停止し、Pippit でアカウントを連携するよう案内します。
10. 最終的なローカル動画を scripts/publish/upload_file.py でアップロードします。
11. ユーザーが予約公開に言及していない場合は、デフォルトの公開として扱います。公開モードを選ぶようユーザーに尋ねてはいけません。
12. デフォルトの公開の場合は、明示的な近い将来の予約時刻に変換します。ユーザーが別の短い遅延時間を希望しない限り、現在の現地時刻から5分後を、次の分に切り上げた時刻とします。予約公開の場合は、タイムゾーンを含む具体的な絶対公開時刻を必須とします。
13. プラットフォーム、アカウント、動画ファイル、キャプション／タイトル、公開モード、絶対公開時刻を改めて提示します。確認を待つのは、プラットフォーム／アカウント／動画／キャプションが不明または曖昧な場合、あるいはユーザーが予約公開を希望しているのに具体的な時刻を指定していない場合に限ります。デフォルトの公開モードや近い将来の予約時刻を推定したことだけを理由に、確認を求めてはいけません。
14. scripts/publish/batchcreate_schedule_task.py で予約タスクを作成します。Pippit での公開は予約公開のみです。即時公開の方法があると決して述べてはいけません。
15. タスク ID／ステータス、生成されたローカルファイルのパス、Pippit のスレッドリンクを返します。デフォルトの公開を使用した場合は、予約公開にも対応していることを簡潔に伝えます。

ローカルコマンド

コマンドの完全な例については、references/command-map.md を参照してください。よく使うコマンド：

python3 {baseDir}/scripts/nest/submit_run.py --message "Create a product video..."
python3 {baseDir}/scripts/nest/get_thread.py --thread-id THREAD_ID --run-id RUN_ID --after-seq 0
python3 {baseDir}/scripts/nest/download_results.py --urls URL1 URL2 --output-dir ./pippit_output --prefix artifact
python3 {baseDir}/scripts/publish/list_user_platform_account.py
python3 {baseDir}/scripts/publish/upload_file.py /path/to/video.mp4
python3 {baseDir}/scripts/publish/batchcreate_schedule_task.py --platform tiktok --platform-user-id PLATFORM_USER_ID --asset-id ASSET_ID --title "TITLE_OR_CAPTION" --schedule-time "2026-05-15T20:00:00+08:00"

公開ルール

• scripts/publish/ を通じて公開できるのは動画のみです。
• 公開モードが指定されていない場合は、デフォルトの公開として扱います。デフォルトの公開は「まもなく公開」を意味し、近い将来の予約タスクとして実装する必要があります。
• プラットフォームアカウント、キャプション／タイトル、公開モード、明示的な絶対公開時刻が揃っていない場合は、予約してはいけません。デフォルトの公開では、タスク作成前に近い将来の絶対公開時刻を算出します。
• デフォルトの公開タスクの作成に成功した後、予約公開にも対応していることを短く添えます。
• 「今日」「明日」「来週の金曜日」などの相対日付は、予約前に絶対日付に変換します。
• TikTok、Instagram、Facebook 固有の設定には、スクリプトのフラグと JSON オーバーライドオプションを使用します。複雑なプラットフォームペイロードを推測してはいけません。まず references/publishing-api.md を読んでください。
• 1回の一括作成呼び出しで作成できるタスクは最大10件です。それを超える場合は、意図的に分割してください。

フォローアップ操作

• スケジュール済みタスクを更新、削除、または一覧表示するには、scripts/publish/ のタスクスクリプトを使用し、クエリにプラットフォームと platform_user_id を含めてください。
• 公開済みの投稿を分析するには、scripts/publish/list_videos.py を使用し、利用可能な場合はタイトル、プラットフォーム、公開時刻、視聴回数、いいね数、コメント数、シェア数、エンゲージメント率を要約してください。
• 公開前に生成したアセットを調整するには、scripts/nest/submit_run.py --thread-id を使用して、同じ Pippit Nest スレッドを続けてください。

出力時の要件

ユーザー向けの回答は簡潔にしつつ、必要な運用識別子を含めてください。

• Nest での生成：thread_id、run_id、web_thread_link、ダウンロードしたローカルファイル
• 公開：プラットフォーム、platform_user_id、アップロードした asset_id、タスク ID、タスクのステータス、スケジュール時刻
• 分析：プラットフォーム、アカウント、動画タイトル、公開時刻、主要な指標

該当するローカルスクリプトが成功を返していない限り、生成、アップロード、または公開タスクが成功したと主張しないでください。