← ブログに戻る
Ai読了目安 12 分

バイクのエンジンを分解できるページに変える Claude Skill

公開日 2026年11月14日
バイクのエンジンを分解できるページに変える Claude Skill

このプロジェクトの指示は一文で足りる。分解できる4ストロークのバイクエンジンのシミュレータを作れと Claude Code に頼めば、作ってくる。機械式時計はどう時を刻むのかと聞けば、それも作る。油圧ショベルのアームの分解と、その20秒の映像を頼めば、両方出てくる。

プロジェクト名は teardown、3,497 スター、MIT ライセンスで、アプリではなく skill だ。インストールは一行:`npx skills add elvarofficial/teardown -g -a claude-code`、そのあとフォルダ内で `npm install && npx playwright install chromium` を実行する。Node 20 以降、映像が欲しければ ffmpeg、音が欲しければ Python 3。

出てくるもの

マシンごとに HTML ファイル1枚、完全オフラインで、three.js とフォントはインライン化される。この制約が設計そのものだ。サーバーも CDN もなく、読む側にビルド手順は要らない。メールで送れば、そのまま開く。

ページの中では、マシンが中央に鎮座する。周囲の HUD パネルはカタログの引用ではなく、シミュレーションの実数値を読む。シャフト回転数、バルブタイミング、圧力。ボタンを押すと、その瞬間に仕事をしているアセンブリが開くので、いま動きを担っている部品が見える。しばらく誰も触らなければ、ページは勝手にツアーを始め、決まった順序でカメラを動かし部品を開いていく。

オフラインの HTML ページ内で分解された 3D のバイクエンジンと、実数値を表示するパネル群

参照実装として3台が同梱される。V8 エンジン、Cessna、Strandbeest。ローカルで `node sims/build.mjs v8-live` を叩けばビルドできて、結果を開ける。新しいものを Claude に頼む気がなくても、これはやる価値がある。skill が狙っている水準がそこに出ている。

skill が品質を保つ仕組み

面白いのは 3D ではなくレビューのループだ。`SKILL.md` には、マシンをどう組み立てるか、何をもって正しく見えるか、agent が引き渡す前に自分の出力をどう検証するかが書かれている。`sims/kit/` の下のキットがランタイム、ステージ、シェーダーのウォームアップを提供するので、モデルはリクエストのたびにレンダラをゼロから書かなくて済む。

キャプチャは別系統で、同じくらい意図的だ。`sims/capture.mjs` はフレームごとに描画して 60fps の MP4 にする。レビュー用にスチルのシートにもする。`run_sfx.py` は映像のタイムライン上で効果音をプロシージャルに生成し、minus 14 LUFS にマスタリングする。ストリーミング各社が正規化の目標にしているラウドネスだ。音がずれた生成映像は一目でわかる。この工程が、出せるものと出せないものを分ける。

系譜ははっきり書いてある。ランタイム、フレームキャプチャ、サウンドエンジン、レビュー規則は whaleyxbt/claude-motion 由来で、こちらも MIT。効果音のサンプルは Freesound の CC0 で、別のリポジトリが整備したものだ。他人のアニメーションキットの上に建てて、そう明記するのは格好いい話ではない。だが数か月ではなく数週間で出た理由でもある。

分解できるマシンは図よりよく教える

分解図は一世紀にわたって整備マニュアルに載ってきた。理由は明白で、「中に何があるか」には答えるが「何が何を動かすか」には答えない。静止画では、ピストンが上死点に達する直前にカムがバルブを開くことを示せない。バルブタイミングが腹に落ちるのは、まさにその一点だ。

インタラクションはそれを安く解決する。スライダーを動かせばクランク角が変わり、残りがついてくる。サイクルの途中でハウジングを開けば、どの部品が負荷を受けているかわかる。パネルの数字は更新されるので、暗記するのではなく関係を眺めていられる。

ツアーモードは聞こえより重要だ。ほとんどの人は最初に何をクリックすべきか知らない。良い問いを待ってじっとしているページは、閉じられるページだ。自動ツアーはシミュレーションを解説に変える。技術コンテンツの大半が実際に必要としている形式はそれだ。

明らかな失敗の仕方

言語モデルが物理シミュレーションを書けば、物理を間違えることがある。もっともらしいエンジンを作り、バルブタイミングが二十度ずれている。ギア比が掛け算で合わないギアボックスを作る。パイプラインのどこにも正しさの保証はない。レビュー規則は確率を上げるが、保証はしない。

これを書く価値があるのは、こうしたページの作り込みが説得力を持つ水準だからだ。きれいな 3D モデルとライブの数字は、権威に見える。数字がでっち上げなら、そのページは非常に説得力のある誤情報であり、ひどい図より危険だ。動くからだ。

対抗策はどの agent の出力にも当てはまる同じものだ。出典と算術を見せろと言う。きちんと作られたシミュレータはパラメータをコードに露出させているので、3,000 rpm の4ストロークサイクルが毎分 1,500 回点火することを確認できる。パネルが別のことを言っているなら、そのページは間違っている。しかもそれは目に見える。

第二の限界は範囲だ。機械が明快なものは機能する。エンジン、時計、リンク機構、油圧アーム。挙動の大半が化学、電磁気、あるいはソフトウェアで定義されるマシンは、回転するアセンブリには還元できない。バッテリーを頼めば、自信に満ちた無用なものが返ってくる。

映像のほうがページより納品物になることが多い

一度の依頼から出てくる2つの出力は分けて考えたほうがいい。インタラクティブなページは理解したい人のためのもの。収録した映像はそれ以外の全員のためのものだ。ピッチ、ローンチ記事、研修モジュール、学会のループ映像。

二つ目の出力こそ、キャプチャと音声のパイプラインが存在する理由であり、デモ基準ではなく放送寄りの基準で作られている理由だ。60fps で描画し、音声を minus 14 LUFS にマスタリングした映像は、編集ソフトにそのまま落ちる。誰かがスライダーをドラッグするスクリーンキャストは落ちない。AI 生成の解説コンテンツの大半は、その2つの成果物の間の差で死ぬ。ビジョンは正しいのに、仕上げがない。

形式こそが物語

これをただの賢いデモ以上にしているのは出力形式だ。HTML ファイル1枚、オフライン、自己ツアー付き、収録映像とマスタリング済みの音声。これは完成した教材だ。ランディングページにも、営業資料にも、博物館のキオスクにも、ハードウェアマニュアルの付録にもなる。

この組み合わせはかつて 3D アーティスト、モーションデザイナー、サウンドデザイナー、フロントエンド開発者を必要とした。いまは一文とレビュー1回で済む。そしてレビューこそ人間が時間を使うべき場所だ。モデルはアセンブリとカメラワークがとてもうまい。数字についてはまだ信頼できない。そしてページはその数字のためにある。

関連記事