Communitygithub.com

77777R7/screenstudio-demo-optimizer

用於安全且可逆地優化 Screen Studio 示範錄製的 Codex 技能與輔助腳本。

screenstudio-demo-optimizer 是什麼?

此技能為 AI 代理(如 Codex)提供了一組結構化的工作流程和腳本,用以安全地編輯 Screen Studio 示範錄製的專案時間軸。它會根據使用者的目標(例如目標持續時間、風格與邏輯保留),引導代理建立可逆的編輯計畫,而非直接修改原始檔案。該技能包含用於分析、壓縮、速度調整、變焦最佳化和驗證的腳本,支援「社交示範」或「教學」等多種預設樣式。關鍵在於安全性:它預設建立原始專案的副本,在套用任何變更前要求使用者確認,並內建規則以防止破壞性動作,例如在不允許的情況下刪除片段或覆寫原始檔案。這使其非常適合需要細心、逐步編輯高價值示範內容的情境,同時將風險降至最低。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add 77777R7/screenstudio-demo-optimizer

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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。

偏好設定協定

如果使用者給出足夠的意圖,則使用合理的預設值進行。如果目標不明確,則提出一個簡潔的問題。

當使用者只說「讓它更好」時的預設協定:

{
  "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 的情況下以 CDP 模式開啟:

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

安全規則

  • 對於非平凡的編輯,預設採用「先計畫」原則。
  • 預設情況下不要覆寫原始專案。
  • 除非使用者允許刪除,否則不要刪除片段。
  • 將音訊繁重或旁白繁重的錄製視為對速度敏感。
  • 在儲存後正規化 project.json,因為某些 Screen Studio/CLI 流程可能將專案資料包裝為巢狀 JSON 字串。
  • 從專案檔案中驗證最終持續時間,如果可能,也從 Screen Studio 執行階段驗證。
  • 報告確切已變更的片段和縮放。

在執行破壞性或不可逆的操作前,請閱讀 references/safety-and-backups.md。

已知限制

  • Screen Studio 內部機制可能隨版本而改變。如果 CDP 開啟失敗,則退回到專案檔案分析並通知使用者。
  • 僅從時間軸資料無法完全判斷視覺品質。可用時,使用畫面提取或 Screen Studio 預覽。
  • 綑綁的腳本是保守的基本工具。代理仍應解釋主觀權衡並請求確認。

相關技能