PropMotion Skill 技能

很多 App 需要一个 3D 瞬间：一个产品在展示台上转动、一个成就徽章滚入画面、一枚硬币落地反弹。不是游戏、不是 AR，就只是一个动得起来的 3D 物体。SceneKit 完全能做到这一点，而且可以嵌入任何 SwiftUI 布局——但相关知识分散，大量细节从未形成文档。

PropMotion 就是这份「失踪的手册」，专门为 AI coding agent 编写，让它在 SwiftUI 场景里做出专业水准的 3D 动画，而不需要任何 Unity、Blender 或付费素材库。

【它解决什么】

SceneKit 的官方文档只告诉你「SCNNode 是什么」，却不告诉你这些：Deferred shadows 在 MSAA 开启时会静默失效；新鲜 SCNView 的着色器会在动画第一帧编译，导致动画中途中断；真实物理感需要刻意设计重力参数才能看起来自然而不是塑料感漂浮。这个 skill 把这些全部记录在案，每一个陷阱都有明确的修复方案。

【能做出什么】

• 物体滚入画面、落地后有真实阴影 • 支持 Grab（抓起）、Throw（抛出）、碰撞墙壁反弹，每次撞击触发 Haptic 震动反馈 • 重量感：重物上升慢、下降快，落地有轻微颤动 • 多物体物理模拟：硬币雨落入容器、弹珠碰撞、行驶中的车轮带烟雾 • 多镜头剪辑成一段完整宣传片

所有几何体均为代码即时生成（无需 3D 模型文件），动画全部是烘焙关键帧配合手写物理公式，无需物理引擎。

【工作方式：两种输入，两种思路】

Shape（外形）→ 给参考照片：从两张不同角度的照片读取比例与尺寸，让 AI 测量后再建模，而不是靠形容词凑形状。

Motion（动画）→ 写脚本：精确描述「什么时间发生什么」，skill 将其转为时间表后再开始写代码。时间描述越精确，第一次产出的偏离就越小。

【迭代方式】

截图指出问题比语言描述更有效。当动画感觉不对但说不清原因时，让 Agent 在地面画出运动路径红线，一眼就能判断是轨迹问题还是场面调度问题。

【安装】 npx skills add dembsky/PropMotion