Communitygithub.com

Screen Studio デモ最適化スキル

ユーザーの編集意図を安全で可逆可能なScreen Studioタイムライン編集に変換するスキルです。

Screen Studio デモ最適化スキル とは?

このスキルは、AIエージェント(Codexなど)がScreen Studioで作成されたデモ録画を安全かつ効率的に最適化するためのものです。ユーザーの意図(ターゲット時間、スタイル、優先順位)を明確にし、元のプロジェクトファイルを決して直接編集せず、常にコピーに対して作業を行います。`analyze_timeline.mjs`でプロジェクトを分析し、`plan_compression.mjs`で圧縮計画を立案、`apply_speed_plan.mjs`で変更を適用する一連のスクリプトが用意されています。さらに、`optimize_zoom_track.mjs`でズームの快適さを調整し、`verify_project.mjs`で最終的な整合性を確認します。元のプロジェクトを上書きしない、スライスを削除しない、ズーム変更前に確認を求めるなど、厳格な安全ルールに従うことで、非可逆的なミスを防止します。また、`screenstudio_cdp_open_project.mjs`を使用してScreen StudioのCDPモードと統合し、ランタイム情報に基づいた検証も可能です。

対応~Claude Code✓Codex CLI~Cursor
npx skills add 77777R7/screenstudio-demo-optimizer

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Screen Studio デモ最適化スキル は何をしますか?

このスキルを使用して、ユーザーの編集意図を安全で可逆可能なScreen Studioタイムライン編集に変換します。

このスキルは固定された編集スタイルではありません。常にユーザーの希望する結果(ターゲット時間、ペース、論理の保持、速度制限、ズーム動作、出力形式)が計画を制御するようにしてください。

コアワークフロー

  1. 編集契約を明確にする、または推測する:
    • ターゲット時間: 正確、おおよそ、または制約なし。
    • スタイル: ソーシャルデモ、チュートリアル、投資家用デモ、内部ウォークスルー、落ち着いたレビュー、高速ティーザー、またはカスタム。
    • 優先順位: すべての論理ステップを保持、待機時間のトリミングを許可、繰り返しの削除を許可、オーディオを保持、ズームを保持、動きを減らす。
    • 出力: 計画のみ、編集コピー、またはエクスポート。
  2. 変更前に安全なコピーを準備します。
    • scripts/prepare_edit_copy.mjs を使用します。
    • ユーザーが明示的に要求しない限り、元の .screenstudio プロジェクトを変更しないでください。
  3. プロジェクトを分析します。
    • scripts/analyze_timeline.mjs を使用します。
    • スライス、速度、再生範囲、ズーム範囲、およびサブ秒のズームリスクを読み取ります。
  4. 編集可能な計画を作成します。
    • ターゲット時間が指定されている場合は scripts/plan_compression.mjs を使用します。
    • 適用する前に、計画を人間にわかりやすく説明します。
  5. 編集コピーを変更する前に確認を求めます。
  6. 確認された変更を適用します。
    • scripts/apply_speed_plan.mjs を使用します。
    • 外部またはCLIでの保存後は scripts/normalize_project_json.mjs を使用します。
  7. ズームの快適さを確認します。
    • scripts/optimize_zoom_track.mjs --review を使用します。
    • 確認後にのみズーム変更を適用します。
  8. 検証します。
    • scripts/verify_project.mjs を使用します。
    • Screen Studioが利用可能な場合は、必要に応じて scripts/screenstudio_cdp_open_project.mjs および screenstudio --port <port> status を使用します。

プリファレンス契約

ユーザーが十分な意図を示した場合は、妥当なデフォルトで進めてください。ターゲットが曖昧な場合は、簡潔な質問を1つしてください。

ユーザーが単に「良くして」とだけ言った場合のデフォルト契約:

{
  "targetSeconds": null,
  "style": "balanced-demo",
  "preserveLogic": true,
  "allowDelete": false,
  "maxReadingSpeed": 1.6,
  "maxActionSpeed": 3,
  "maxWaitSpeed": 10,
  "zoomPolicy": "reduce-jumpy-zooms"
}

一般的なプリセット:

  • social-demo: 短く、鮮明で、待機速度が高く、不安定なズームを削減します。
  • tutorial: 低速で、ステップを保持し、アグレッシブなズーム変更を避けます。
  • investor-demo: 簡潔で、ナラティブな瞬間を保持し、結果を強調します。
  • agent-workflow: 待機/読み込みを大幅に高速化し、主要な決定と最終結果を保持します。
  • review-only: 分析して推奨するのみで、変更は行いません。

ズームを編集する前に、ペーシングのヒューリスティックについては references/compression-rules.md を、ズーム快適性ルールについては references/zoom-comfort-rules.md を参照してください。

スクリプトクイックスタート

安全なファイルを準備:

node scripts/prepare_edit_copy.mjs "/path/to/demo.screenstudio"

分析:

node scripts/analyze_timeline.mjs "/path/to/demo.agent-edit-copy.screenstudio"

90秒のカットを計画:

node scripts/plan_compression.mjs "/path/to/demo.agent-edit-copy.screenstudio" --target-seconds 90 --preset social-demo > /tmp/plan.json

確認された計画を適用:

node scripts/apply_speed_plan.mjs "/path/to/demo.agent-edit-copy.screenstudio" /tmp/plan.json
node scripts/verify_project.mjs "/path/to/demo.agent-edit-copy.screenstudio"

ズームの快適さを確認:

node scripts/optimize_zoom_track.mjs "/path/to/demo.agent-edit-copy.screenstudio" --review

Screen Studioがインストールされている場合、Screen StudioをCDPモードで開く:

node scripts/screenstudio_cdp_open_project.mjs "/path/to/demo.agent-edit-copy.screenstudio"

安全ルール

  • 重要でない編集については、デフォルトで計画を優先します。
  • デフォルトでは元のプロジェクトを上書きしないでください。
  • ユーザーが削除を許可しない限り、スライスを削除しないでください。
  • オーディオ主体またはナレーション主体の録画は、速度変更に敏感なものとして扱います。
  • Screen Studio/CLIフローによってプロジェクトデータがネストされたJSON文字列としてラップされる可能性があるため、保存後は project.json を正規化します。
  • プロジェクトファイルから最終的な時間を検証し、可能であればScreen Studioランタイムからも検証します。
  • 変更された正確なスライスとズームを報告します。

破壊的または不可逆的なアクションを行う前に、references/safety-and-backups.md を参照してください。

既知の制限事項

  • Screen Studioの内部構造はバージョンによって変更される可能性があります。CDPでのオープンに失敗した場合は、プロジェクトファイル分析にフォールバックし、ユーザーにその旨を伝えてください。
  • タイムラインデータのみから画質を完全に判断することはできません。可能な場合はフレーム抽出またはScreen Studioプレビューを使用してください。
  • バンドルされているスクリプトは保守的なプリミティブです。エージェントは依然として主観的なトレードオフを説明し、確認を求める必要があります。

関連スキル