Communitygithub.com

Fallonwong/piano-remotion

制作带有原始双手跳进、光效轨迹和摄像机的钢琴乐谱视频。审核记谱修订,重用采样音频工具,并在导出前等待乐谱审批和实际关键帧/试听审批。

piano-remotion 是什么?

这是一个用于自动化制作钢琴乐谱视频的 AI 助手技能,支持原始的双手跳进动画、光效轨迹和摄像机运动。该技能与 Claude Code 等 AI 编码代理集成,通过提供两个关键的内容审查点(乐谱审批和关键帧/试听审批)来确保输出质量。它支持多种输入源,包括 MusicXML、MIDI、PDF 和图像,并能处理复杂的记谱元素,如连音、符杠、连奏线等。该技能还集成了音频采样和渲染功能,可以生成经过校准的音频输出。对于开发者来说,该技能通过结构化的工作流程自动化了繁琐的视频制作过程,同时保留了人工审核关键决策点的能力,非常适合需要高质量钢琴教程或表演视频的内容创作者。

兼容平台~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。有关音频或 PDF/图像,请阅读音频和识别工作流程;几何和渲染工作流程 记录了几何和现有舞台机制。有关运行时重用和安装,请参阅环境设置。使用生产级证据和记谱审计参数运行这些命令。不要将旧版 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 通过已验证的 MuseScore Basic 导出完整的已批准 XML;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 证据重新绑定新工作,而非覆盖已完成的制品。

相关技能