blitzreels-editing について
CLIまたはRESTでBlitzReelsプロジェクトを編集するスキルです。安全な変更、検証、復旧、書き出しまでの手順を定めています。
主な機能
- 01CLIとRESTの選択
- 02範囲を絞ったタイムライン確認
- 03リスクのある編集の事前プレビュー
- 04編集後の状態とフレームの確認
- 05書き出し状況の確認
活用シーン
- 01タイムラインのカットや字幕の編集
- 02メディアと編集可能なテキストの配置
- 03古いIDや部分的な失敗からの復旧
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/blitzreels-editingを入力して読み込まれたか確認します。
同梱ファイルevals/evals.json
詳細
BlitzReels 編集
CLI と REST は、同じプロジェクト編集における実行経路として扱います。 ワークスペースを直接操作する場合はインストール済みの CLI を使用し、連携または明示的な API 操作には REST を使用します。
ワークフロー
- 操作面を選択します。
- CLI：
command -v blitzreelsで確認してから、agent-context --commandで正確なコマンドを調べます。 - REST：機能インデックスを読み込み、必要な OpenAPI 操作のみを調べます。
- CLI がない場合は、公開コントラクトで編集がサポートされていれば REST を使用して続行します。
- CLI：
- ID を選択する前に、プロジェクトと範囲を限定したタイムラインのコンテキストを読み込みます。 影響を受ける区間の字幕の単語またはメディアのみを読み込みます。
- 変更全体を担う最も高レベルの操作を選択します。
- 音声の削除：字幕のリップルを伴うタイムラインカット。
- 字幕の修正：単語テキストの変更、結合、分割、削除、タイミング変更、またはブロックのパッチ適用。
- ビジュアルの配置：まず配置プリセットを使ってメディアを挿入または変形します。
- 編集可能なテキスト：コンテンツアイテム。
- リスクのある書き込みは、ドライランまたはプランで事前確認します。 確認フラグを渡す前に、破壊的な出力を確認します。
- コントラクトで受け付けられる場合は、冪等性キーを指定して変更します。
- 影響を受けた状態を再読み込みし、変更した各区間のフレームをレンダリングします。
- ビジュアルを確認し、有料レンダリングの承認を得てからエクスポートを開始します。 終端状態で成功するまでポーリングし、出力を取得できることを確認します。
CLI の検出
blitzreels agent-context --command "timeline cut" --json
blitzreels agent-context --command "captions words list" --json
blitzreels agent-context --command "media attach" --json
blitzreels agent-context --command "project snapshots" --json
単語レベルの詳細なメタデータが必要な場合に限り、project inspect --mode full を使用します。
リカバリー
- ID が古い場合、または競合が発生した場合は、保留中の編集を破棄してコンテキストを更新し、対象を選び直します。
- 一部の処理が失敗した場合は、すべてのアイテムを確認し、検証後に失敗したアイテムのみを再試行します。
- API 呼び出しがサーバーに到達した可能性がある場合は、再試行する前に現在の状態を読み込みます。
- 書き起こし済みメディアを添付した後は、字幕が重なる可能性があるため、レイヤーを追加する前にタイムラインを更新します。
完了
使用した操作面、影響を受けた ID、変更のレシート、警告、プレビューの証拠、エクスポートの状態を返します。 後続の読み込みとレンダリングしたフレームによって、要求された状態が確認できた場合にのみ編集は完了です。
コメント
Markdown 対応