isometrics(ラインスタイル) は何をしますか?
短い指示(「ギャラリーのアイソメトリックス」「空の受信トレイの状態」)を、完全な状態として出荷できる1つの描画およびアニメーション化されたオブジェクトに変換します。イラスト、見出し、コピー行、ボタンで構成されます。すべてのオブジェクトは、ワールド単位の3Dプリミティブから構築され、真のアイソメトリック投影で投影されるため、このスキルで作成された他のすべてのオブジェクトと1つのグリッド、1つのアウトライン、1つの外観を共有します。
外観は一言で言えば次のとおりです。1つのオブジェクト、平面の場合は正面、箱状の場合は真のアイソメトリック角度、紙のように白い面上の1pxのアウトライン、1つの小さなブランドカラーマーク、影なし、グローなし、1拍のモーションの後に静止。
段階を飛ばしてはいけません。チェッカーが合格し、シートを確認するまで、オブジェクトは完了したとは見なされません。
目次
| ファイル | 参照タイミング |
|---|---|
SKILL.md | 常に:ワークフローとルール |
references/brief-to-concept.md | ステージ1~2:あいまいな指示を3つのコンセプトに変換する |
references/motion.md | ステージ4:ビートの選択とタイミング |
references/line-style.md | ステージ3~5:すべての描画ルール、すべきこととしてはいけないこと、理由付き |
references/engine-api.md | 構築中:エンジンとラインキット |
references/isometric-math.md | エンジンにない形状に計算が必要な場合 |
examples/*.tsx | 構築前:最も近いものから始める |
engine/iso-core.tsx、engine/iso-line.tsx | ユーザーのプロジェクトに一度コピーされる |
scripts/check.mjs | ステージ5:厳格なレンダリングチェック |
セットアップ(プロジェクトごとに一度)
オブジェクトは、Tailwind CSSとshadcn/ui(@/lib/utilsのcnと@/components/ui/buttonを使用)、およびmotionパッケージを使用するプロジェクト向けのReactクライアントコンポーネントです。
-
components/isometrics/iso-core.tsxがあるか確認します。ない場合は、このスキルからengine/iso-core.tsxとengine/iso-line.tsxをcomponents/isometrics/(またはユーザーが好むフォルダに。オブジェクトは相対的にインポートするため、すべて1つのフォルダに格納されます)にコピーします。 -
プロジェクトに
motionがない場合:インストールします(npm i motion、またはプロジェクトのパッケージマネージャーを使用)。shadcnのボタンがない場合:npx shadcn@latest add button。 -
チェッカー用、Playwright:
npm i -D playwrightとnpx playwright install chromium(またはインストール済みのChromeを使用します)。 -
1つのオブジェクトを単独でレンダリングするページを、
PlayOnHoverでラップして作成します(チェッカーはホバーで再生します)。例:Next.jsのapp/isometrics-preview/<name>/page.tsx、またはプロジェクトのルーター内のルート。import { PlayOnHover } from "@/components/isometrics/iso-line"; import { MapPin } from "@/components/isometrics/map-pin"; export default function Page() { return ( <main className="flex min-h-svh items-center justify-center p-10"> <PlayOnHover><MapPin /></PlayOnHover> </main> ); }オブジェクトごとに作成し、削除できるプレビューページであることをユーザーに伝えます。
1つのオブジェクトを機能させるためにエンジンを編集しないでください。形状がどうしても不足している場合は、オブジェクト自身のファイル内に、3Dから構築されたヘルパーを追加し、そのことをユーザーに伝えてください。
ワークフロー
ステージ1 · 指示を読む
何よりも先に、リクエストを3つの答えに変換します。
- 主題: 物やトピック(「ギャラリー」→写真、アルバム、画像)。
- 用途: どの状態に使うか:空(まだ何もない)、ブロック(アクセス不可、オフ、接続されていない、見つからない)、何も見つからない(検索、フィルター)、成功/すべてクリア、または機能カード内のスポットイラスト。
- メッセージ: 状態が伝える平易な一文(「まだ写真がありません」)。
用途が明示されていない場合、指示は通常複数の用途に当てはまります。それがコンセプトの目的です。references/brief-to-concept.mdを参照してください。
ステージ2 · 3つのコンセプト、その後待機
指示がすでに1つのオブジェクトと1つの状態を指定している場合を除き、ユーザーに3つのコンセプトを表で示し、一時停止してユーザーの選択を待ちます。
| オブジェクト | メッセージ(見出し) | 1拍のモーション | |
|---|---|---|---|
| A ★ | … | … | … |
| B | … | … | … |
| C | … | … | … |
各コンセプトは4つのテストすべてに合格する必要があります。
- 120pxでアウトラインが認識できること。 色がなくても人がわかるシルエット。
- 角が丸いものは箱型より優先。 ラインでは丸いオブジェクトの方が親しみやすく読めます。ただの箱は小包やワイヤーフレームのように見えます。
- 1つのオブジェクト。 シーンではなく、山でもありません。2つ目の小さな部分は、それがオブジェクトに属している場合(蓋、旗、手)にのみ許容されます。
- ビートがメッセージを伝える。 モーションは文の動詞です(
references/motion.mdを参照)。ビートに名前を付けられない場合、それは間違ったオブジェクトです。
推奨するものを★でマークし、その理由を一言で述べてください。3つを変化させてください:異なるオブジェクト、異なるビート。指示が具体的である場合(「トレイのある空の受信トレイ状態」)、表をスキップし、自分の選択とビートを述べて先に進んでください。
ステージ3 · オブジェクトをパーツに分解する
コードの前に、ワールド単位でパーツ表を作成します。各パーツ、それが構築されるプリミティブ(Extrude、Slice、Ring、FacePath、Boxなど)、0.5グリッド上のサイズと位置、動くかどうか、そしてどのパーツがブランドマークかを示します。次にコピー:見出し(28文字以下)、1~2文、ボタンラベル(22文字以下)とそのアイコン(アイコンは動詞に従います。アクションが追加する場合のみプラス記号)。
パーツを決定するルール(すべてreferences/line-style.mdにあります):
- 最初にビューを選択します。 平らなものや薄いもの(ページ、バッジ、ディスク)は
view="front"。箱状のものや奥行きのあるもの(プリンター、箱、サーバー、トレイ、机の上に置かれた棒)はview="isometric"。正面から見た箱は、線が二重になった平らなステッカーのように見えます。 - y方向、x=0付近、z=0の上に立つように構築します。
- 3段階のディテール:形状、人が認識する部分、そして静かなマーク(ネジ、通気口、継ぎ目、ラベル)。
- クリーンなライン:正面から見た立体には奥行きがないか、明確な奥行き(約4px以上のストリップ)があります。パーツは面一であるか、0.5以上浮き出ています。丸いスタックは1つの半径と1つの継ぎ目ラインを共有します。
- 平らなもの(紙、ラベル、画面)は面であり、立体ではありません。
- 丸い立体は、水平な円の間のスライスで、下からペイントされます。
- 凸でないアウトラインは、その遠いエッジを描画する必要があります。
- ハウジングからスライドして出てくるパーツは、ハウジングの部分で切断され、浮かんではいけません。
- 1つのブランドマーク(パレット
main)。その他はすべて紙(surface)。
ステージ4 · ビートを選択して書く
メッセージから動作を選び(references/motion.md)、描画コードの前にファイルの先頭にストーリーボードコメントを書きます。タイミング、何が動くか、どのくらいの距離、理由。すべての値は名前付き定数にします。ビートは、アートがビューポートにスクロールインしてから400ms待機し、1.2~2.4秒続き、1回再生されます。ユーザーのコードがactiveを渡すと、代わりにactiveがtrueになるたびに再生されます(80msの遅延あり)、それ以外では自動再生されません。モーションの軽減設定では、静止ポーズが表示されます。
ステージ5 · 構築、レンダリング、チェック、確認、修正
-
examples/(下表)の最も近い例から始めます。その構造を維持します:ストーリーボード、TIMING、ジオメトリ、トラック、ポーズ、ピース、LineState。 -
プレビューページでレンダリングし、チェッカーを実行します。
node <skill>/scripts/check.mjs http://localhost:3000/<preview-path>/<name> --duration <待機時間+ビートのms>これにより、ライトモードとダークモードでレンダリングされ、疑似クロック上でアートにホバーしてビートを再生し(そのためプレビューページはオブジェクトを
<PlayOnHover>でラップする必要があります)、0%、25%、50%、75%、100%の時点とその後のフレームを保存します。その後以下をチェックします:- ライトモード、ダークモード、モーションの軽減設定で、ハイドレーションエラーやコンソールエラーがないこと。
activeが渡されたときに再生され、アート内にボタンがないこと。- ビートが正確に静止ポーズに戻ること。
- モーションの軽減設定では静止しており、静止ポーズを表示し、
activeを無視すること。 - すべてのアウトラインが約1pxであること。フィルター、グロー、シャドウ、グラデーションペイントがないこと。
- 静止描画がフレーム内に収まっていること。
- 描画が見出しに対して2px以内で中央揃えされていること。
- クリーンなライン:アウトラインの最大6%が持続的な二重線(実際の長さに沿って0.5~2px離れた2本の線。線が交わる小さな塊はカウントされません)であること、ダークモードの4倍拡大(
lines.png、二重線はlines-marked.pngで赤色表示)で確認。 - 光学サイズがセットに合っていること(√(w×h) 140~175 px)。
-
sheet.pngとlines.pngを見ます(両方を開き)、以下のチェックリストを確認します。チェッカーはデザインを認識できません。あなたが認識します。 -
修正して再度実行します。 最大3ラウンド。3回経過してもまだ不十分な場合は、そこで停止し、シートとともに何が不十分かを正確にユーザーに伝えます。
-
報告: コンセプト、ストーリーボード、チェッカー結果、確認後に修正した点、まだ不十分な点、シートのパス。
シートを確認する:チェックリスト
認識性
- 見出しがなくても、見知らぬ人がサムネイルサイズでオブジェクトの名前を言えるか?
- 誤って顔のように見えるものがないか(曲線上の2つの丸い部品など)。
- ブランドマークは1つの小さな部分であり、目を引くべき部分である。
静止
- 静止時に、すべての直立部品は垂直で、すべてのエッジは水平であること。傾いているもの、斜めにぶら下がっているものはなく、2枚目のシートはオフセットされており、回転していないこと。
- 静止ポーズがモーションの軽減設定のポーズと等しいこと(チェッカーはピクセルを比較します。あなたはそれが意図的に見えるか確認します)。
ライン(lines.pngを確認:ダークモード、4倍拡大)
- すべての場所で1つのアウトラインの太さ。二重エッジがないこと、塗りつぶし間のヘアライン状の継ぎ目がないこと、曲線のアウトラインに欠けている遠いエッジがないこと、アウトラインをはみ出す塗りつぶしがないこと、空中で途切れる線がないこと。
- すべてのパーツは面一であるか、明確に浮き出ていること(0.5以上)。細いストリップがないこと。
リアリズム
- 正しいビュー:平らなものは正面、箱状のものはアイソメトリック。
- 3段階:形状、認識可能なパーツ、静かなマーク。実際に持っている人が「そう、それがプリンターだ」と言うか?
- 上面のストリップ(30°上から見た厚さ)が立体にはあり、薄い面にはないこと。
モーション
- ビートがメッセージを伝える。各動作は前の動作によって引き起こされること(遅れ、フォロースルー、落ち着き)。
- ヒンジで動くパーツがハウジングを貫通してスイングしないこと。先端が静止位置を越えないこと。スイングは小さいこと(吊り下がったパーツで最大6°、フラップで最大25°)。
- フェードインまたはフェードアウトするものがないこと。出現するものはスケールで成長すること。
ページに適合
- コピーに中央揃えされていること。フレームにデッドスペースがパディングされていないこと。
- ダークモードで正しく見えること:紙の面は暗い紙になり、ブランドマークはブランドのままであること。
二度としない:このスキルが過去に犯した過ち
それぞれが一度出荷され、レビューで発見され、現在はルールとなっています。オブジェクトを報告する前に、すべての行と照らし合わせて確認してください。
| 過ち | 現在のルール |
|---|---|
| 箱を正面から描画すると平らなステッカーのように見えた | 最初にビューを選択する:平らなものは正面、箱状のものは view="isometric" (line-style.md) |
| 薄い上面のストリップ、ほとんど浮き出ていないパーツ、段付きのリングが二重の汚い線を描画した | 細いストリップは不可。面一であるか0.5以上浮き出ていること。丸いスタックは1つの半径にすること。チェッカーのクリーンラインズテストに合格し、lines.png(ダークモード、4倍拡大)を確認すること |
| オブジェクトが単なるアウトラインだった(「現実的でない」) | 3段階のディテール:形状、認識可能なパーツ、静かなマーク |
| セット内のオブジェクト間でサイズが異なっていた | defaultArtClassName を使用して光学サイズを140~175pxにすること |
| ページがフレームの外に3ユニット飛び出していた | モーションはアートの空気内にとどまり、フレームエッジを少し超える程度にすること |
| 2つのラッチ、全幅のストライプを「1つのブランドマーク」としていた | 本当に1つの小さなマークにすること |
| 継ぎ目上のドット上のスロット、2つのラッチが顔のように読まれた | サムネイルサイズで偶発的な顔を探すこと |
| 観客に向かうコーナーフリップが正面から見えなかった | 観客に向かう動きは、その角度のごく一部でしか読めない。ピクチャープレーン内の動きを優先するか、大きく動かすこと (motion.md) |
| ページをその平面内で傾けると、アイソメトリック角度でせん断された | アイソメトリックビューでは、パーツをその法線またはエッジ上のヒンジの周りでのみ回転させること (motion.md) |
| パーツが最初の再生で開始ポーズを1フレームだけフラッシュした | クロック状態によって駆動されるパーツは、クリップが変更されるとリセットされ、保持されているときは静止から開始する (engine-api.md) |
| 薄いトレイの壁が薄いプラスチックのように読まれた | 頑丈な壁には厚みを持たせること(0.5以上)。薄い面は紙用 |
| 各オブジェクトは単独では問題なく見えたが、セットではそうではなかった | 報告前に、バッチ全体をライトモードとダークモードで並べてレビューすること |
| 鐘の胴体、シャックル、針の指針が曲線に沿って二重のアウトラインを描画した | 正面から見て、曲線部品は平らな面(または明確に深い面)にする。指針には平行な側面を与え、決して先細りにしないこと |
| ガラスのアウトライン上に描かれた砂が1つの厚いスミアになった | 内容物は内側の壁の内側に収め、決して容器のアウトライン上に置かないこと |
| ボックスから0.25浮き出たドアがアーチを二重にした | 開口部と同じ形状のドアは、静止時に1つのアウトラインを共有すること |
| アイソメトリックで32°の金庫のドアがエッジオンに見えた | アイソメトリックのドアと蓋は約24~26°開き、その面がまだ読めるようにすること |
| キーリングがキーの穴を通らずに重なっていた(「リングがキーリングの内側にない」) | スレッド化された部品はインターリーブする:リングは各パーツの穴の片側で後ろを通り、反対側で前に出る (line-style.md) |
| オブジェクトをサイズに縮小すると二重線が戻ってきた | 最初にデフォルトの幅を設定し、小さく描画されるオブジェクトにはストリップを0.5以上にすること |
| 「!!!」バッジがライン検査に不合格だった | マークはクリアなギャップのある形状として描画すること。テキスト内のグリフギャップは避けること |
譲れないルール
- 真のアイソメトリックのみ。 軸は水平から30°、互いに120°、等スケール。2:1の「ゲーム」投影(26.565°)は決して使用しない。
- ジオメトリが先。 プリミティブをワールド単位で配置する。投影されたスクリーンパスを手動で記述してはならない。
- 1つのグリッド。 位置とサイズは0.5ワールド単位。面の詳細は0.25。
- 1つの外観。
variant="ink"(デフォルト)または"line"。1つのオブジェクト内で外観を混在させてはならない。1pxアウトライン、紙の壁、影なし、グローなし、グラデーションなし。 - トークンからのテーマ。 色は、
--iso-*変数を介してユーザーのshadcnテーマからのみ取得する。オブジェクトファイル内で16進数やoklchを使用してはならない。ブランドマークはtoneに従う(デフォルトはprimary)。 - プロップ、フォークではない。 コピー、トーン、バリアント、ストローク幅、モーションスイッチは、ドキュメントコメント付きのプロップ(
LineStateProps)である。コンテンツプロップにtitleという名前を決して付けない。それはアクセシブルな名前である。 - アクセシブルで埋め込み可能。 アートは、
titleプロップが提供されている場合を除き、装飾的です。