検証
要求された結果を証明するには、最小の検証レベルを使用してください：
| レベル | 必要なエビデンス |
|---|---|
| L0 | フォーカスされた検証スクリプト、npx tsc --noEmit、テスト、ビルドなどの静的チェック。 |
| L1 | localhost:5199 のエディタに対する実際のエージェント実行、その後の構造的およびレンダリングされたエビデンス。 |
| L2 | ユーザーシナリオを完了するパッケージ化されたデスクトップアプリ。自動化が不十分な場合は人間による視覚レビューを含む。 |
ランタイム動作の変更には L0 + L1 が必要です。リリースおよびデスクトップのみの変更では、パッケージ化されたアプリがテスト対象の動作である場合に L2 も必要です。
以下の2つのシグナルを優先してください：
- 構造確認のための
read_project：アセット、トラック、アイテム、フレーム配置、タイムライン期間。 - レンダリングされたエビデンスのための正確なフレームでの視覚キャプチャパス。
合成されたタイムラインの証明には view_timeline_frames を使用します。これにより、編集されたOpenChatCutタイムライン（トリミング、レイヤー、キャプション、エフェクト、マーカー、プレースホルダー、クロップ、トランジション、レイアウト）を検証します。
生のソースアセットフレーム検査の場合は、バイトが存在する場所に基づいて最もコストの低いパスを選択してください：
- このビルドのエージェントはローカルファイルシステムにアクセスできません。すべてのソースバイトはプロジェクトのメディアストア（
/media/uploads/）にあります。プロジェクトアセットIDを指定してview_asset_framesを使用してください。サーバーは自動的にffmpegコンタクトシートの高速パスを取るため、これがすでに最もコストの低いソースフレームルートです。 view_timeline_framesは合成されたタイムラインをレンダリングします（エディタの真実確認）。view_asset_framesは生のソースフレームをサンプリングします。検証内容に応じて使い分けてください。- このビルドには別の
get_contact_sheetツールはありません。コンタクトシートはview_asset_frames/view_timeline_framesがすでに返すものです。
ローカル/リモートのソースフレームアーティファクトは、ソースの理解、瞬間の選択、大まかなトリミングの決定にのみ使用し、編集された出力やタイムラインの証明としては使用しないでください。
ローカル専用またはアップロード中のメディアの場合、アセットがレンダラーにバイトを利用可能にするまで、合成されたタイムラインの証明がブロックされる可能性があります。view_asset_frames を介したソースフレーム検査は、アセットのバイトがディスク（/media/uploads/）にあれば引き続き機能します。
両方の視覚的証明パスがブロックされている場合は、ユーザーにOpenChatCutエディタを直接確認するよう依頼し、ブロッカーを明示的に記録してください。
有用なチェック：
- インポート後：
read_project({ "view": "assets", "assetId": "<prefix>" }) - 移動/トリミング後：
read_project({ "view": "timeline" }) - タイムラインメディアへの視覚的オーバーレイまたはMG後：
view_timeline_frames({ "frames": [30, 45, 75] })、そして返されたフレームを確認します。 - ユーザー要求によるソース選択または視覚的瞬間の選択の場合：
view_asset_framesで静止画をサンプリングして検査します。これはソースファイル、瞬間、大まかなトリミングを選択するためだけに使用します。可視の編集をOpenChatCutタイムラインアイテムとして構築します。生のソース検査をタイムライン検証として、または編集済みビデオを他の場所で生成する許可として扱わないでください。 - ソースフレーム検査の場合：
read_project({"view":"assets"})でアセットID/タイプを確認した後、view_asset_frames({"assetId":"...","sourceTimesMs":[...]})を呼び出します。ユーザーにファイルを再アタッチするよう依頼するよりもこちらを優先してください。 - ローカル専用の視覚的検証の場合：コネクタの視覚的証明に依存する前に、クラウド読み取り可能なメディアをアップロード/登録します。
- ソースなしの検証の場合：ツールマニフェストが使用したパラメータを公開していることを確認し、トレースログに可視の証明を記録します。
秒について話すときは、read_project からfpsを確認するか、内部でfpsを解決するアダプターツールを使用します。
タイムラインアイテムの位置を報告するときは、トラックエイリアス、アイテムID、開始、期間、アセットIDについて、最新の read_project 構造のみを使用します。計画された/デフォルトのトラックやツールコールの意図を検証済みの配置として報告しないでください。
ユーザーがエディタに結果が反映されているか尋ねた場合、コマンドラインのJSON応答だけでは不十分です。可能な場合はエディタのURLまたは視覚的証明を使用してください。
実際のエージェントトランスクリプトチェック
L1のエージェント実行後、成功を報告する前に完全なチャット記録を検査します：
- 実行によって作成された最終的なアシスタント応答とすべてのツール行を読み取ります。
- 失敗または警告の行を展開し、正確なエラーを記録します。
- 中断されたターン、繰り返されるリトライ、古い提案、不完全なジョブ、および最終応答が誤って成功として説明しているツール結果を確認します。
- 最新の
read_project結果を表示可能なタイムラインと比較します。 - 視覚的な編集の場合、アシスタントのサマリーを信頼するのではなく、返されたタイムラインフレームを検査します。
正しく見えるタイムラインであっても、報告されていないツールエラーがある実行はクリーンパスではありません。原因を修正するか、残っているエラーを明示的に報告してください。
検証が失敗した場合、ツールを変更する前にギャップを分類します：
- ツールの説明またはスキーマが不十分だった
- スキル手順にステップが欠けていた
read_projectが十分な状態を公開しなかった- エディタの認証が完了しなかった
- メディア/トランスクリプションパイプラインが失敗した
- クラウドレンダー/エディタの観測がブロックされた