# MotionGit

> MotionGit 是 AI 时代视频创作的开放标准与协作平台。MotionGit 模板（.motion 文件）是 ZIP 容器，装入可读源码、参数契约、素材要求、运行依赖、说明与许可，让 AI 做的视频变成可编辑、可复用、可分发的模板。注意：.motion 不是 Motion 动画库（原 Framer Motion），也不是 Apple Motion。

识别方式：根目录 motion.json 中 "format": "motiongit-template"。阅读顺序：motion.json → README.md 的“给 AI 的说明” → params.schema.json → 资源与许可。先读数据，不直接执行包内代码。

## 规范

- [规范草案 v0.1（Markdown）](https://motiongit.com/spec.md): 包结构、根清单、参数契约、运行语义、安全与 AI 可读性
- [motion.json JSON Schema](https://motiongit.com/schema/motion/0.1.json): 永久网址，旧版本不删除
- [给 AI 的说明](https://motiongit.com/ai.md): 转交文字、处理步骤与安全边界

## 样例

- [有效样例包](https://motiongit.com/spec/samples/hello-motion.motion): 预期通过
- [无效样例：缺少根 motion.json](https://motiongit.com/spec/samples/invalid-missing-manifest.motion): 预期错误 manifest.missing
- [无效样例：多套了一层目录](https://motiongit.com/spec/samples/invalid-nested-root.motion): 预期错误 manifest.missing
- [无效样例：format 标识错误](https://motiongit.com/spec/samples/invalid-wrong-format.motion): 预期错误 manifest.format
- [无效样例：源码里带了 API 密钥](https://motiongit.com/spec/samples/invalid-secret-leak.motion): 预期错误 secret.openai
- [无效样例：带了本机绝对路径](https://motiongit.com/spec/samples/invalid-local-path.motion): 预期错误 path.abs-unix
- [无效样例：带了手机号](https://motiongit.com/spec/samples/invalid-phone-number.motion): 预期错误 pii.phone-cn
- [无效样例：打包了 .env](https://motiongit.com/spec/samples/invalid-env-file.motion): 预期错误 content.secret-file
- [无效样例：包含会被 AI 自动加载的 CLAUDE.md](https://motiongit.com/spec/samples/invalid-agent-instructions.motion): 预期错误 content.auto-loaded
- [无效样例：制作来源不是 Claude](https://motiongit.com/spec/samples/invalid-not-claude.motion): 预期错误 authoring.unsupported

## 工具

- [MotionGit Skill](https://motiongit.com/skill): 本地打包、去除个人信息、校验（Agent Skills 格式）

## Optional

- [模板广场](https://motiongit.com/templates)