VideoScript トランスクリプト
このスキルの機能
videoscript コマンドラインクライアントを制御します。CLIは公開されたVideoScript APIと通信し、ユーザー自身が発行したキーを使用します。サービス側で抽出、文字起こし、課金が行われます。このスキルはHTTPを直接呼び出さず、キーを扱いません。
最初に行うこと
videoscript auth status --json
{"authenticated": true, ...}→ 続行します。- 終了コード3 → ユーザーはサインインしていません。VideoScriptウェブサイトでAPIキーを作成し、
videoscript auth login --token <キー>を自分で実行するように伝えてください。キーを会話に貼り付けさせたり、表示したりしないでください。 videoscriptが見つからない場合 → ユーザーにインストールを依頼します（npm install -g videoscript）。
通常のフロー
# 1. 送信（タスクIDを即座に返します）
videoscript transcribe create "<url>" --json
# 2. 待機（サーバーのRetry-Afterを尊重します）
videoscript transcribe wait <id> --json
# 3. トランスクリプトをファイルに書き出す（チャットには書き込まない）
videoscript transcript get <id> --format markdown --output notes/<name>.md
重要なルール：
- 1回の送信＝1つの冪等性キー。 CLIが自動生成し、
--jsonで表示します。再試行が必要な場合はそのキーを再利用（--idempotency-key）することで、ユーザーが二重請求されることを防ぎます。 - 長いトランスクリプトはファイルに保存。 ユーザーのリクエストに必要な範囲だけファイルを読み取ります。1時間分のトランスクリプト全体を会話に貼り付けないでください。
- 消費は可視化されます。 完了したタスクごとにユーザーのクレジットが消費され、ライブラリに表示されます。長時間の処理を送信する前にはそのことを伝えてください。
- コンテンツ制限はサービスの仕様であり、回避できません。 ログイン、有料コンテンツ、DRM、地域ブロック、ライブ配信は設計上拒否されます。プロキシ、クッキー、サードパーティのダウンローダーを提案しないでください。
問題発生時
終了コード: 3 サインイン、4 タスクなし、5 後で再試行、6 クレジット/予算、7 ソースが拒否されました。
5→ CLIが報告するRetry-Afterの時間だけ待ってから再試行します。CLIは自動で2回再試行します。6→ ユーザーの残高またはこのキーの予算が不足していることを伝えます。購入を試みないでください。7→ 制限を明確に説明し、停止します。再試行しないでください。1/2→ 予期しないエラーまたは不正な引数。メッセージを読んで呼び出しを修正してください。
詳細な表：reference/cli.md および reference/errors.md。
このスキルが行わないこと
アップロード、一括ジョブ、タスクの削除、支払い、管理操作、ユーザーのパスワードが必要な操作。キーのスコープはサービス側で強制されます。