AirsupHQ/machine-skill

这是什么？

核心功能

• 01将描述的机器生成为单个 HTML 三维页面，无需构建步骤。
• 02为每台机器运行独立的物理求解器，驱动运动和数值显示。
• 03提供爆炸图、带实体剖面的剖切、X 光和实时标注等视图模式。
• 04内置可计算的破坏模式，用于模拟故障和载荷。
• 05通过 Node 脚本录制确定性的 MP4 影片，可选添加背景音乐。

适用场景

• 制作用于教学的发动机或机械结构交互式讲解页面。
• 为社交媒体制作机器的短动画视频。
• 在培训或技术文档网站中嵌入设备的剖切三维模型。
• 探索工况变化如何影响机器模型中的各项数值。

快速上手

1. 1

   将技能安装到 Claude Code

   npx skills add AirsupHQ/machine-skill -g -a claude-code
2. 2

   在 Claude Code 中描述一台机器以生成它

   /machine a mechanical watch movement, the escapement ticking
3. 3

   将生成的页面录制为视频（需要 Node 和 ffmpeg）

   node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 --music freepd:Classical/Easy_Lemon

使用前须知

• !主要适用于机器、发动机、机构和装置；人物、风景和地图效果较弱。
• !物理计算是简化模型，并非 CFD 或 FEA，数值未经认证。
• !复杂页面需要支持 WebGL 2 的真实 GPU 才能全速运行。
• !录制视频需要 Node 18+、Playwright 和 ffmpeg。

收录于专题

标签

常见问题

machine-skill 是什么？

一个 Claude Code 技能，输入一句机器描述，即可生成基于物理计算的单文件交互式 3D 仿真及宣传短片。 Machine Skill 是一个面向 Claude Code 的开源 Agent Skill。输入一句话描述，例如涡扇发动机或机械手表机芯，Claude 会查找该机器的真实尺寸和工况，并用 three.js 生成一个可独立打开的 HTML 页面。每台机器都配有一个小型物理求解器，例如燃气轮机的布雷顿循环、活塞发动机的曲柄连杆模型，用于驱动运动和页面上显示的数值。

machine-skill 可以免费使用吗？用的什么许可证？

machine-skill 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

machine-skill 还在维护吗？

活跃维护中。machine-skill 最近一次提交是在 2026年10月13日。

machine-skill 适合用来做什么？

制作用于教学的发动机或机械结构交互式讲解页面。 为社交媒体制作机器的短动画视频。 在培训或技术文档网站中嵌入设备的剖切三维模型。 探索工况变化如何影响机器模型中的各项数值。

machine-skill 怎么安装和运行？

将技能安装到 Claude Code: npx skills add AirsupHQ/machine-skill -g -a claude-code 在 Claude Code 中描述一台机器以生成它: /machine a mechanical watch movement, the escapement ticking 将生成的页面录制为视频（需要 Node 和 ffmpeg）: node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 --music freepd:Classical/Easy_Lemon

在哪里获取 machine-skill？

源代码和安装说明在 GitHub 上：https://github.com/AirsupHQ/machine-skill