Machine Skill — 一句话描述机械装置，Claude 自动生成可交互 3D 实物 + 1 分钟短视频

技能简介

Machine Skill 是开源团队 Airsup 推出的一款 Claude Code Skill（正式兼容 Anthropic AgentSkills 规范），定位"把脑里的机械装置直接做成可点击的 3D 模型 + 配套短视频"。在 Claude Code 对话框里输入「做一个差速器」「来一台六缸发动机」「造一台老式打字机」，Claude 会自动调用这个 Skill，输出一个 ~1MB 的单文件 HTML，内含带真实物理引擎的 3D 模拟（可旋转、可拆解、可调参数），并同时生成一段 60 秒横版电影感短片，可直接发 YouTube / TikTok / 小红书。Skill 本身有完整 SKILL.md 定义，可独立升级版本。

核心能力

• 一句话生成 3D 实物模型：从 artext 提示词解析结构 → 调 Three.js + Cannon-es 物理引擎 → 输出单 HTML 文件，体积 < 1.5MB。
• 真实物理仿真：齿轮咬合、连杆传动、流体循环、热变形等基础物理由 Cannon-es 内核仿真，参数可拖动滑块实时验证。
• 可拆解演示：UI 内置"爆炸图"按钮，可一键展开所有部件，分别高亮每个零件、播放运动轨迹。
• 自动配套短视频：调用 Runway / Veo 3 / 即梦等视频模型 API，把 3D 渲染结果剪辑成 60 秒横版电影，附 BGM + 字幕。
• Claude Code Skill 标准：用 SKILL.md + agentskills.io 清单描述，CLI 调用 claude plugin install airsup/machine-skill 一键安装，自动识别词槽「做一个 + XX」。
• MIT 开源可商用：默认模型 / 默认参数 / 默认输出格式均可二次修改，可插入自定义 GLB / GLTF 资产。

安装配置

• 安装方式：

  claude plugin marketplace add airsup/machine-skill
  claude plugin install machine-skill@airsup

• 可选 API 密钥：若要生成配套短视频，需在 ~/.config/airsup/.env 配置 Runway API Key 或 Google Veo 3 凭证；纯 3D 模式无需任何 Key。
• 浏览器要求：Edge / Chrome 119+ 启用了 WebGL 2.0；Safari 17+；手机端 Chrome 120+。

使用步骤

1. 在 Claude Code 中唤起：直接输入「做一个 + 你想造的设备」（如「做一个蒸汽机」「做一个咖啡机拉布机」）。
2. Claude 触发 Skill：Claude 检测到 machine-skill 后自动调用，本地生成单 HTML 模拟页（10-30 秒）。
3. 浏览器内交互：自动弹窗打开 HTML，可用鼠标拖动旋转、点击零件、调节速度/温度/压力滑块，物理引擎会实时计算。
4. 一键导出短视频：在模拟页底部点 "Make Film" → 选 16:9 / 9:16 / 1:1 与目标平台 → 后台调用视频模型（约 1-3 分钟），MP4 直接下载到本地。
5. 分享与二次编辑：MP4 自带字幕与背景音乐；HTML 模型可托管在 GitHub Pages / Vercel 形成可分享 Demo 链接。

适用场景

• 教师 / K12 STEM 课堂：把物理课讲"差速器 / 行星齿轮 / 四冲程发动机"做成可点可调的 3D 演示，比 PPT 直观 100 倍。
• 机械自媒体 / 抖音知识号：原本需要 SolidWorks + Blender + Premiere 三件套的工作流，现在一句话 + 1 个 Key 即可量产。
• 产品 / 工业设计提案：把客户脑海里的草图秒变可点击 demo，把"想象"提前到"看得到"。
• AI 编程教学：让学生看 Claude 如何把"造一台打印机"分解为零件清单 + 物理参数 + 渲染调用。
• 开源硬件社区：快速 demo 一个新发明的机械结构，吸 star / 收 issue / 招募贡献者。

适用人群

• 机械 / 物理老师：希望把抽象概念做成可互动的 3D 课件。
• 自媒体创作者：做"机械 + AI"知识号，需要大量 3D 演示与短视频素材。
• 工业 / 产品设计师：早期方案 demo 工具，节省 SolidWorks 建模时间。
• AI 编程爱好者：体验 Claude Code Skill 标准 + Anthropic AgentSkills 生态的最佳示例。

工作原理

Skill 通过 SKILL.md 注册一段 YAML 描述「当用户说'做一个 + XX'时调用本 skill」。Claude 解析结构 → 调 Three.js 在客户端实时渲染（无需 GPU 服务器） → 调用 cannon-es 计算物理轨迹 → 生成自包含 HTML（含内联 JS / 模型 / 着色器）。视频路径可选 Sora / Veo 3 / Runway Gen-4 任一 API：HTML 中的 canvas 通过 MediaRecorder 截取 WebGL 流，上传至视频模型后端，回传 MP4 URL。

官方链接

• 官方 Demo 实验室：https://airsup.ai/lab/skill
• Claude Code Skill 安装清单：https://code.claude.com/docs/en/skills
• AgentSkills 兼容标识：https://agentskills.io
• GitHub 源码：搜索 "airsup/machine-skill"（GitHub Topic: claude-skills）
• 许可协议：MIT License（个人与企业免费商用，可二次开发）

更新动态

• 2026 年 10 月初首发版本，已支持 50+ 常见机械装置（发动机 / 差速器 / 联轴器 / 泵 / 打印机 / 缝纫机）。
• 路线图：增加风力发电机 / 涡轮 / 半导体晶圆等工业级模型；支持自定义 GLB 资产上传；新增 Lottie 动画导出。