Describe any machine in one line. Claude builds a photoreal, physics based, interactive simulation of it in one HTML file, plus the film to post it. An open source Claude Code skill.

Machine Skill – 将一行描述转化为交互式 3D 模拟

它是什么 – 一个用于 Claude Code（及其他兼容 Claude 的代理）的代理技能，它能将简短的文本提示（例如

/machine a turbofan jet engine, the kind that pushes a wide‑body off the runway

）转化为功能齐全、逼真的 3D 网页。该页面以真实比例展示机器，由程序生成的几何体构建，使用 three.js 渲染，并由计算推力、压力、速度等的轻量级物理/热力学求解器驱动。该技能还可以录制一段包含构建、运行、剖面和“破坏”序列的 30 秒确定性影片。

快速入门（针对非专家）

安装技能
```
npx skills add AirsupHQ/machine-skill -g -a claude-code
```
这会将仓库复制到 ~/.claude/skills/machine，Claude Code 即可加载它。
询问 Claude 在 Claude Code 中输入以 /machine 开头的行，后跟描述，例如
```
/machine a mechanical watch movement, the escapement ticking
```
Claude 将回复一个类似 watch.html 的文件。
查看/交互 在任何现代浏览器中打开生成的 HTML。您可以拖动视图、爆炸装配体、切割截面、观看实时标签，或让求解器“破坏”机器（例如，抛出一个风扇叶片并查看计算出的负载）。

录制影片（可选）

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

该脚本逐帧执行模拟，确保每次运行的输出完全相同。

您能从该技能中获得什么

特性	对您的意义
真实世界比例	机器以米为单位建模，包含 15-40 个命名部件和数千个实体零件（叶片、螺栓、齿轮等）。比例尺显示实际尺寸。
基于物理的材质	钢、钛、Inconel、铜、黄铜、铝、聚合物、玻璃、蓝宝石——每种材质都具有测量的反射率和适当的表面处理（拉丝、抛光、热辉光）。
影棚级灯光	柔光箱主光、环境光遮蔽、泛光以及可选的夜间或纸质背景，在任何运动开始前提供产品摄影外观。
实时物理求解器	每台机器都附带一个小型、自包含的求解器（涡轮机的布雷顿循环、火箭室方程、泵相似定律等）。屏幕上显示的数字是实时计算的，页面列出了控制方程。
交互模式	爆炸、剖面（带剖面线的截面）、X 射线、慢动作、暂停，以及应用用户指定故障（例如，抛出叶片、泵气蚀）的确定性“破坏”模式。
一键成片	添加 `?film=1` 可使模拟与录制器同步步进，生成 28 秒的确定性视频。`record.mjs` 脚本添加音乐、洋红色帧保护和可选的粉色扫描验证。

工作原理（概览）

SKILL.md – Claude 读取的清单；它定义了工作流（研究 → 几何 → 材质 → 求解器 → 渲染 → 影片）和屏幕文本风格。
kit/lab-kit.js – 一个单一的 ES 模块（无需构建步骤），内联到每个生成的 HTML 页面中。它从 CDN 拉取 three.js 0.170 并提供：
- 叶片、齿轮、外壳等的几何构建器
- 具有真实 PBR 值的材质库
- 剖面渲染（带自动生成截面盖的平面裁剪）
- 用于爆炸、标签和影片时间轴的 UI 辅助工具。
references/solvers.md – 包含真实常数的紧凑物理配方集合（例如，布雷顿循环、火箭喷管膨胀、泵曲线）。页面显示所使用的方程以保持透明度。
scripts/ – 用于截图 (shot.mjs)、确定性视频捕获 (record.mjs)、粉色帧检测 (pinkscan.mjs) 和内联套件 (inline.mjs) 的实用程序。
examples/ – 可直接打开的现成 HTML 文件（涡轮风扇、火箭发动机、炼油泵、压缩机等）。

谁会使用它？

教育工作者和培训师 – 为航空航天、发电厂或机械工程课程提供交互式、基于物理的可视化效果。
内容创作者 – 为社交媒体或技术博客快速生成高质量的 3D 讲解视频。
工程师 – 在无需完整 CAD/CFD 流程的情况下，对设计的基本性能进行快速的“假设”视觉检查。
AI 爱好者 – 一个将自然语言提示桥接到物理驱动图形的代理技能的具体示例。

局限性（如 README 中所述）

物理效果是简化模型，而非 CFD 或有限元分析。结果适用于说明，但不适用于认证。
几何体是程序化 three.js，比例和零件数量准确，但不适用于制造公差。
重型场景（约 60 万个三角形）需要不错的 GPU；移动浏览器可以运行较轻的版本。
该技能专注于机器和机构——它不处理人物、景观或复杂的流固耦合。

获取帮助/贡献

提交 issue 或提交包含新机器描述的 pull request。
仓库包含用于未来想法的 V2-IDEAS.md 和定义自动化测试提示-响应期望的 evals/evals.json。

总结： Machine Skill 让您只需输入描述真实机器的单句话，即可立即获得交互式、基于物理的 3D 网络模拟以及可发布的视频。这是一个功能齐全、开源的 Claude Code 技能，仅需浏览器和一个适度的 Node 环境即可进行录制。

以上所有细节均直接取自项目的 README；未添加任何外部推测。

AirsupHQ/machine-skill