Communitygithub.com

Fallonwong/鋼琴-動畫製作

製作鋼琴樂譜影片,包含原創雙手跳動、發光軌跡與鏡頭效果。審閱記譜修訂、重複使用取樣音訊工具,並在匯出前先後等待樂譜與關鍵幀/試聽審核。

鋼琴-動畫製作 是什麼?

這是一個專為 AI 代理(如 Claude Code、Cursor、Codex)設計的技能,用於自動化製作高品質的鋼琴樂譜影片。此技能的核心價值在於提供一個嚴格的人機協作審查流程,確保最終影片的音樂性和視覺效果準確無誤。它支援從 MusicXML、MIDI 或 PDF/圖片樂譜開始,並能處理包含雙手跳動、滑音軌跡和動態鏡頭的複雜場景。技能會引導代理依序完成樂譜辨識/分類、記譜審閱(WAITING_FOR_SCORE_APPROVAL)、音訊製作(使用使用者錄音或取樣引擎)、關鍵幀與試聽審核(WAITING_FOR_KEYFRAME_APPROVAL),最後才是匯出。它嚴格禁止繞過任何審核步驟,並要求引用使用者真實的回應作為批准依據,從而避免了 AI 幻覺導致的錯誤,適合需要高度還原原創鋼琴作品的創作者。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add Fallonwong/piano-remotion

在你喜歡的 AI 中提問

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

說明文件

Piano Remotion — V1.0.0

請先閱讀已安裝的官方 remotion-best-practices。重複使用相容的授權環境;Python/OMR 為可選項目。首次安裝或大型下載需要路徑、版本、內容、大小/原因和使用者許可。保留私人來源,關閉個人疊加層,保留原始的 ScoreNoteLeap/PianoScoreScene 視覺效果。尚未指派任何授權。

使用 node <skill>/scripts/piano.mjs。關於音訊與辨識工作流程,請參閱音訊與辨識工作流程;關於幾何圖形與現有舞台機制,請參閱幾何與渲染工作流程。關於執行時重複使用與安裝,請參閱環境設定。在那些命令中使用生產環境的證據和記譜審計引數。不要將舊版的 Demo 呼叫視為已確認的歌曲完成。

以兩個內容審查停止點執行任務

  1. 發現/分類。 重複使用當前專案和明確授權的相容工具。缺少 PATH 或探測逾時並不代表不存在。可靠的 MusicXML/MIDI 優先於重新辨識。PDF/五線譜圖片優先使用已安裝的專業 OMR;若缺少工具則提供選項,而非自行編造轉錄。簡譜需要明確的調號/八度/節奏解譯。絕不無聲地編寫逐曲專用辨識器或簡化聲部。
  2. 準備並審閱記譜。 保留可編輯的 MusicXML,包含真實音高/時值/拍號/休止符/和弦/聲部/五線譜/符槓/圓滑線/連結線語義。檢查每個小節的原始/重排裁剪;平衡的小節數並非正確性依據。notation-audit 會添加修訂差異、密集/連接/複音測試小節以及有證據支援的疑點。在修正後使用 --previous,當使用者識別出有範圍限制的變更時使用 --expected-measures。顯示非預期的變更;不要為了鏡頭編輯而重置已經正確的音樂。新的 PDF/圖片 score-request 需要 --notation-audit。顯示裁剪/差異/疑點,回傳 WAITING_FOR_SCORE_APPROVAL 並結束該回合。代理自行審查不得批准。
  3. 記錄真實的使用者同意。 引用使用者實際的詞語,並附上顯示的 requestId/訊息參考,或使用他們的審閱頁面回覆。絕不偽造 actor=user 或批准。樂譜回應會記錄提供/合成/靜音;產生的音訊選擇不代表批准了未聽聞的音色。本機 JSON 綁定的是版本,而非人類身份。
  4. 產生已批准的歌曲/音訊。 保留原始的動畫和原生 SVG 幾何圖形。同音高的連結線會在其完整時值內發聲一次;圓滑線下的音高保持獨立;符槓不是連結線。使用 audio-plan 發現:優先使用使用者錄音,其次才是現有的取樣引擎/字型。audio-render 將完整的已批准 XML 透過經過驗證的 MuseScore Basic 匯出;audio-master 記錄明確的全局增益/填充並保護可聽到的釋放尾音。新的已確認綁定需要 --audio-evidence。不要將代理產生的波形註冊為使用者錄音。內建的 synthesize --preview-only 僅為校準草稿;絕不要為了通過對齊而用自訂振盪器取代正式音訊。
  5. 顯示實際的關鍵幀並試聽。 預覽和匯出都使用相同的最終完整歌曲主控/屬性/工作。keyframes 會產生實際的幀和簡短的試聽/動作片段。顯示音訊來源/設定檔/混音以及雙手/和弦/線條變化/連接/鏡頭。回傳 WAITING_FOR_KEYFRAME_APPROVAL 並結束該回合。可選的早期音色試聽很有用,但不是強制的第三道關卡。一個 10–15 秒的片段不能取代完整歌曲主控。音訊/引擎/混音的變更會使此審查失效。
  6. 在兩個批准後匯出。 render --approval ... --confirmed 會使用凍結的工作。僅使用 --confirmed 不能繞過審查。驗證解碼後的串流、可聽性、持續時間、fps/大小和取樣後的起音。對於密集/連奏的音樂,缺少能量峰值是不確定的:保留聲音並回傳 needs_review;絕不要為了滿足偵測器而縮短衰減或更改音符。不要偽造通過的報告。保留實際的命令、輸入和結果。

辨識品質與限制

檢查掃描品質、頁面/裁剪出處、臨時記號/調號/譜號/八度、附點/符槓/連音、休止符、和弦數量、聲部/手以及連結線與圓滑線的區別。對於困難的長樂譜,從一個具代表性的 3–5 小節測試段落開始;在有用時使用第二種現有方法進行交叉檢查。模型讀取兩次並非獨立的基準真相。在沒有以人為校正基準的情況下,切勿聲稱準確率百分比。保留每個小節的不確定性證據,並解釋每項修正。

同一路徑上失敗兩次需要診斷/替代方案。如果大約十分鐘後仍無可審查的結果,請報告阻礙因素;不要無聲地執行一個小時。在每個階段內自主完成例行工作;不要為普通的可逆步驟或授權的混音調整請求微觀許可。

在可用時使用已安裝的專業 OMR 適配器。根據原始來源判斷記譜;成功的製譜或影片匯出不能取代來源審查。請參閱使用說明和提示詞。保留舊工作以供檢查;使用 V1.0.0 的證據重新綁定新工作,而不是覆蓋已完成的成品。

相關技能