ワークベンチ操作
明確な編集リクエストを既存の CLI 操作に変換し、常に同じプロジェクト内で結果を読み返します。これは別の編集エンジンではなく、他のスキルを使用する前に必ず読むべきエントリポイントでもありません。
まずアクションを判別する
| ユーザーの意図 | 本スキルの対応パス |
|---|---|
| 現在のプロジェクトを確認する、特定のフレーズを探す、既存のクリップと映像を確認する | 読み取り専用の位置特定、操作方法 を参照 |
| フレーズにアニメーションや動画を重ね、元の音声を保持する | 画面オーバーレイ、タイムラインは延長しない、操作方法 を参照 |
| 画面、フレーズ、またはセグメントを削除する | オブジェクトと音声への影響を区別する、削除方法 を参照 |
| セグメントを分割する、短縮する、既存セグメントの順序を入れ替える | EDL 変更、操作方法 を参照 |
| 縦横比を変更する、画面をフル表示または全体表示にする | プロジェクトキャンバスとメディアのフィットを区別する、操作方法 を参照 |
| メインタイムラインの任意の位置に新しい素材を挿入し、後続をずらす | まず現在の機能を確認する。汎用の挿入コマンドがない場合は、明確にギャップを示し、オーバーレイや移動を挿入と偽らない |
ユーザーが「挿入」と言った場合、まずそれが画面を重ねて音声を継続するものか、新しい長さを追加して後続をずらすものかを判断します。「削除」と言った場合は、画面を削除するのか、音声と時間を削除するのかを判断します。意図が明確な場合は、繰り返し確認せずに実行します。重複した発言、素材の再利用、またはターゲットが一意でない場合は、確認のために位置を列挙し、テキストからインスタンスを推測しません。
口誤り、重複、どのバージョンを保持するかの自動判断は「カット口誤りスキル」に任せます。字幕の内容とレイアウトは「字幕スキル」に、カット/アニメーションの作成は対応する「デザインスキル」に、完成品の出力は「エクスポートスキル」に、接続障害とアップグレードは「メンテナンスとトラブルシューティング」に任せます。追加のエージェントを自動起動したり、不足しているスキルを自動インストールしたりしません。
1回の操作の固定フロー
- 接続: 初回またはIDが変更された場合、接続と送信 を完全に読みます。確認済みの Runtime パラメータ配列、明示的な origin、サーバーの projectId と機能を保持し、動作ごとに環境を再発見しません。
- 読み取り: 関連ドキュメントのみを読みます。ドキュメント自体の revision、ターゲットID、元の値、期待される結果を保存します。フレーズの位置特定は、必要に応じてページを分割して完全に読み取り、ソースのIDとインスタンスを確認します。字幕の cue ID をワードIDとして使用してはいけません。
- 計画: どのオブジェクトを変更するか、時間を短縮するか/音声に影響するかを簡潔に説明します。ユーザーがすでに明確に許可した範囲については、繰り返し確認しません。新しい影響(関連レイヤーの追加削除など)については、事前に許可を得る必要があります。
- 提出: 実際の
workbench commands --jsonのフィールドとパターンに従って呼び出します。書き込み操作の--confirmedは、すでに許可があることを示し、Agent に権限を付与するスイッチではありません。編集作業は Runtime を通じてのみ行い、プロジェクト JSON を直接変更しません。 - 検証: 影響を受けるリソースを読み取り、ID、差分、長さを確認し、必要に応じてワードアンカー、字幕ステータス、画面タイミングをチェックします。複数のパッチを連続して行う場合、前のステップの読み返しが成功してから次のステップを構築します。これはアトミックなバッチトランザクションではありません。
- 納品: データが書き込まれたこと、画面/音声が実際に検証されたかどうか、サポートされていない項目や検証されていない項目をそれぞれ説明します。提出の成功はプレビュー/完成品のパスを意味しません。ページが更新されていなくても書き込まれていないことを意味しないため、まず読み返しを行い、「更新」のために再提出してはいけません。
失敗したら書き込みを中止する
- 競合: 現在の差分を再読み取りします。古い承認は、revision を新しいものに置き換えて自動的に再生することはできません。新しいターゲットと影響を確認した後にのみ、別の計画を立てます。
- タイムアウト、切断、または読み返し失敗: 結果がすでに書き込まれている可能性があります。元のリクエストとIDを保存します。対応するリソース、アセットハッシュ、または元の operationId で正確にクエリします。見つからなくても、送信されていないことの証明にはなりません。IDを変更して盲目的に再試行してはいけません。
- リソース不足、あいまいなターゲット、capability不足: 具体的な問題点を報告し、既存のプロジェクトを保持します。自動的にアップグレード、再起動、再文字起こし、レジストリの変更、または他のツールへの切り替えを行いません。
- 汎用の元に戻す/やり直し、音量ミキシング、再生制御、または任意の位置への新しいメディアの順方向挿入のための架空のコマンドは提供しません。
playbackは読み取り専用のワードストリーム再生であり、operation-recoverは制限されたトランザクション回復であり、任意の undo ではありません。 - 削除はプロジェクト内の指定されたオブジェクトのみを指します。元のビデオ、録音、インポート済みアセット、モジュールファイル、キャッシュはクリーンアップしません。
典型的なリクエスト
- 「2番目のフレーズにこのMP4を重ねて、音声はそのままにして」→ 実際のワードIDを特定、メディアをインポート、古いレイヤーを保持してオーバーレイを追加、読み返し。
- 「追加したばかりの黒いアニメーションを削除して」→ 一意のレイヤーを特定、そのレイヤーのみを削除。音声はカットせず、アニメーションのソースファイルは削除しない。
- 「3回目に言ったこのフレーズを削除して、後ろをつなげて」→ 3番目のインスタンスを確認、サポートされているワード/セグメント削除フローを実行、新しい長さを検証。
- 「最初のセグメントを2つに分割して、後半を最後に移動して」→ セグメントの局所的なカット後に秒数で分割、新しいIDを読み返し、マグネットタイムラインのルールに従って移動。