1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | PropMotion |
| 作者/维护者 | Mateusz Dembek（dembsky） |
| 来源链接 | https://github.com/dembsky/PropMotion |
| 许可证 | MIT（GitHub API） |
| GitHub Stars | 97（GitHub API） |
| Forks | 3（GitHub API） |
| 最新版本 | 1.7.0（SKILL.md 元数据） |
| 安装方式 | npx skills add dembsky/PropMotion，或手动复制 scenekit-product-stages 目录到目标 Agent 的 skills 目录（README） |
2. 功能介绍与亮点
PropMotion 是一份面向 SwiftUI 应用的 SceneKit 3D 物体动效技能，聚焦一个常见产品需求：让一个 3D 物体（产品模型、成就徽章、硬币等）在界面里旋转登场、被抓取投掷、带称重感地下落回弹，而不是搭建完整游戏或 AR 场景。核心能力覆盖四块：舞台搭建（透明 SCNView 叠加在 SwiftUI 布局、三点光源加独立阴影光源）、动作设计（先写提示单再写代码的关键帧编排、手搓积分器替代物理引擎）、真实交互（抓取/投掷/触感反馈）、多镜头串接（把独立场景剪成一条连续片段）。
主要亮点：SKILL.md（约 17.9KB）外配 10 份分主题参考文档（阴影光照、手势触感、多物体物理、镜头调度等），把 SceneKit “文档没写但踩了才知道”的坑（如 MSAA 下阴影失效、首帧编译着色器卡顿）逐条记录并给出修复方式；全部依赖 Apple 原生 SceneKit 框架，不引入 Unity、Blender 或第三方资产；仓库附带一份基于 Apple 官方文档与 WWDC 会话核实的 RealityKit 迁移可行性研究，作者直言 SceneKit 已进入维护模式、重度需求应优先考虑 RealityKit，定位诚实；另附 evals.md 自测脚本验证触发时机。
3. 适用场景
所属分类：前端与设计
适用于 iOS/SwiftUI 开发者需要为单个产品、勋章或硬币等 3D 物体制作旋转登场、抓取投掷、称重感下落等动效的场景。开发者可提供参考照片让 Agent 读取真实比例，也可只写文字描述动作节奏，Skill 引导 Agent 先建立测量与镜头脚本再写 SceneKit 代码，帮助独立开发者补齐官方文档留白的实操细节。
不覆盖：完整游戏或 AR 场景（作者建议这类需求改用 RealityKit）、非 iOS/SwiftUI 平台的 3D 渲染需求，以及 Android、Web 端的等效方案。
4. 跨 Agent 兼容性
- Claude Code：原生支持——README 提供
npx skills add dembsky/PropMotion一条命令安装，也可手动复制到~/.claude/skills/；SKILL.md 采用标准 YAML front matter + 指令正文格式。 - Codex：未验证——README 未提及 Codex，SKILL.md 格式本身符合通用 Agent Skills 规范，理论上可安装，但未见官方或社区来源确认。
- OpenClaw：未验证——未在已抓取材料中找到相关证据。
- Hermes Agent：未验证——未在已抓取材料中找到相关证据。
5. 推荐理由
PropMotion 把“让一个 3D 物体在 SwiftUI 里动起来”这件事，从零散踩坑经验整理成可直接喂给 Agent 的操作手册——聚焦阴影、镜头、物理、触感这类只有真正做过才会撞到的细节。对独立开发者而言，省下的是反复试错首帧卡顿、阴影在 MSAA 下失效这类隐性调试时间；技能零代码执行、零网络请求、不依赖第三方引擎或付费服务，装上即用，攻击面几乎为零。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | GitHub 97 stars；仓库创建于 2026-08-06，6 天内积累至此；未找到第三方独立讨论或评测来源 |
| 可用性 | 9 | 一条命令安装；SKILL.md 加 10 份参考文档结构完整，含大量代码示例；最近一次提交 2026-08-08，维护活跃；纯 Apple 原生框架，无付费依赖 |
| 安全性 | 9 | 仓库内无可执行脚本，安装单元只含 SKILL.md 与 Markdown 参考文件（生成的 Swift 代码由使用者自己的 Xcode 工程构建运行，技能本身不执行任何代码）；不联网、不要求 API key；License 为 MIT，权属清晰 |
综合评分：7.67
安全检查清单：①无 shell 命令执行，安装单元只含 SKILL.md 和 10 份 Markdown 参考文件，无脚本文件 ②不联网外发数据，全部指导内容用于本地生成 Swift 代码 ③不要求 API key 或任何凭据 ④SKILL.md 与参考文件未发现可疑指令或混淆内容 ⑤个人开发者，未见刷星或虚假宣传迹象，commit 记录与仓库活动一致真实 ⑥License 为 MIT，明确 ⑦最近维护 2026-08-08，在近 1 个月内。
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与 PropMotion 的差异 |
|---|---|---|
| SwiftUI Agent Skill（twostraws / Paul Hudson） | 通用 SwiftUI 编码规范——API 用法、布局、性能、可访问性 | 覆盖整个 SwiftUI 开发面，不涉及 3D/SceneKit；PropMotion 只解决“一个 3D 物体怎么演出”这一具体需求，两者可叠加使用 |
| SwiftUI Agent Skill（AvdLee） | 同类通用 SwiftUI 最佳实践指南 | 定位与上者接近，同样不涉及 3D 渲染；PropMotion 补的是这类通用指南留白的 SceneKit 实操细节 |
| iOS Game Development（Axiom，第三方市场收录） | 路由式技能，覆盖 SpriteKit / SceneKit / RealityKit 等多种 2D/3D 引擎的入门开发 | 面向“做游戏”的广度覆盖，单一引擎内容较浅；PropMotion 不做游戏，只把 SceneKit 里“一个物体的一段演出”这条窄需求做深做透，含具体阴影、触感、镜头调度细节 |
PropMotion 的定位不是“教你用 SwiftUI”，也不是“教你做游戏”，而是补上两者中间的空白：当产品里只需要一个 3D 物体演出一小段动作时，如何用最少的技术栈把它做对、做稳。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
仓库附带 research/realitykit-parity.md，逐条核实 12 个 SceneKit 生产模式在 RealityKit 上的对应情况与差距，用于评估是否值得推出配套版本。作者为单人开发者。
10. 安装使用方式
方式一（推荐）：
npx skills add dembsky/PropMotion方式二（手动，Claude Code）：
git clone https://github.com/dembsky/PropMotion.git
mkdir -p ~/.claude/skills
cp -r PropMotion/scenekit-product-stages ~/.claude/skills/方式三（Claude.ai 网页版）：将 scenekit-product-stages 文件夹压缩为 zip，在 Settings > Capabilities > Skills 中上传。
安装后无需重启，Agent 在处理 SCNView/SceneView、UIViewRepresentable 3D 场景、产品或主视觉物体动效、旋转登场、阴影异常、Metal 渲染黑屏等相关任务时会自动触发；也可显式要求“使用 $scenekit-product-stages 制作一个硬币掉落弹起的动效”。
11. 注意事项
- 明确不适用于 RealityKit、ARKit、visionOS 或完整游戏世界场景——作者在 SKILL.md 中直言 SceneKit 已进入维护模式，重度 3D 需求应优先考虑 RealityKit。
- 仅覆盖 iOS/SwiftUI 平台，不含 Android 或 Web 端的等效方案。
- 仓库创建于 2026-08-06，成立时间很短，尚无长期维护记录，当前 0 个 Issue，社区反馈样本不足。
- 需要一定 SwiftUI/SceneKit 基础知识，才能有效驾驭参考文档中的进阶技巧（如自定义积分器、多物体物理）。