スティックシーン は何をしますか?
カムランのインク&バタースタイルのスティックフィギュアが、製品の機能を示す1つの仕事を行います。シーンはアイドル状態(呼吸、一瞥、あごをかく)になり、トリガーされると5〜8秒のアクションを1回再生し、その後元の状態に戻ります。これは、依存関係のない<stick-scene>要素内の1つの<canvas>です。
ここにあるものはすべて、kamranahmed.info/story の約90のシーンで実証済みです。これらのパターンを出発点としてください。新しい描画スタイルを発明しないでください。
ファイル
runtime/stick.js: ランタイム全体。リグ(フィギュア、ポーズ、イージング、ペン)、プロップキット、ステージ、<stick-scene>要素。そのままプロジェクトの静的フォルダにコピーします。templates/scene.js: 新しいシーンの開始点。templates/preview.html+scripts/frames.mjs: 選択した瞬間にシーンをフリーズして1枚のコンタクトシートにレンダリングし、エラーを報告します。scripts/motion.mjs: シーンを60 fpsでステップ実行し、静止画では隠れるグリッチ(関節のスナップ、顔を通る腕、頭に重なるプロップ、逆向きまたは後ろに突き出た肘、押しつぶされた回転、滑る足、手が届かない、アクションの開始または終了時のポップ)を報告します。references/craft.md: APIチートシート、ポーズクックブック、タイミングレシピ、プロップレシピ、メタファーカタログ、およびすでに犯した過ち。シーンを書く前に読んでください。examples/: 実際のシーン。diffity-review.js(コメント→エージェントによる修正→承認、2人のフィギュア、ボードと机)が最もすっきりした完全な例です。scenes-p3.jsとscenes-p4.jsには約30個以上のシーンが含まれています。craft.md のメタファーカタログにどれがどれかが記載されています。
ワークフロー
- 製品を理解する。 ユーザーが何をするか、ユーザーが何を得るかをそれぞれ1行で説明します。ランディングページやREADMEがあればそれを読んでください。
- 2〜3のメタファーを提案し、ユーザーに選択してもらいます。ただし、ユーザーがそのまま進めるように指示した場合は除きます。各アイデアは1行で:プロップ、アクション、成果。良いメタファーは物理的(レバー、スタンプ、コンベヤ、ピンボード、フレームレール、クレートスタック)で、一目でキャプションなしで読み取れ、目に見える結果(チェックマーク、スタンプ、何かが浮き上がったり光ったり)で終わります。craft.md のカタログを参照してください。
templates/scene.jsからシーンを書きます。 最初に固定ワールド座標でプロップをレイアウトし、次にアイドル、次にT秒にわたるタイムラインとしてアクションをレイアウトします。labelにはスクリーンリーダー用の平易な文章を指定します。- コンタクトシートでチェックします。 すべてのシートを確認してから完了とします。
# 一度だけ、スクラッチディレクトリで: npm i [email protected] NODE_PATH=<scratch>/node_modules node <skill-dir>/scripts/frames.mjs \ --scene <id> --src path/to/scene.js \ --frames "idle:0,idle:2.5,s:0.8,s:1.6,s:2.4,s:3.2,s:4.0,s:5.0" --fw 400 --out /tmp/<id>.png<skill-dir>はこのSKILL.mdが配置されているフォルダです。その後PNGを読み取ります。idle:<sec>は静止ループをフリーズし、s:<sec>はアクションのある瞬間、u:<0..1>はその一部分です。@<n>を追加してn回目の再生をレンダリングします(s:2.4@1)。これにより、S.nによって変化するシーンのすべてのバリアントをチェックできます。次の条件を満たすまで修正と再レンダリングを繰り返します:端が切り取られていない、プロップが顔や説明対象を覆っていない、各ビートが単独で読み取れる、テキストがボックス内に上下の余裕を持って収まっている、手が持っているものの前にあり、持っているものが現実と同じように体に接触している(口元のマイク、手のひらの中のハンドル)、矢印は手描きの山形(塗りつぶされた三角形ではない)、最後のフレームがアイドルと一致している(ループバック時にポップが発生しない)。通常2〜3ラウンド必要です。 次に、コンタクトシートでは判断できないモーションをチェックします。すべてのNODE_PATH=<scratch>/node_modules node <skill-dir>/scripts/motion.mjs --scene <id> --src path/to/scene.jsjump(ポーズを切り替えるのではなくブレンドする)、arm-through-face、head-covered(顔に重なるプロップ、メモ、または吹き出し)、bent-back-elbow、elbow-out-back(しばらくの間保持された折れた腕)、squash、start-pop、end-popを、「motion is clean」と表示されるまで修正します。歩行の最初または最後の短いskateは許容されます。 - 埋め込みます。
runtime/stick.jsとシーンファイルをサイトの静的フォルダにコピーし、以下を追加します。Astroでは<stick-scene scene="<id>" play="view" style="height:230px; max-width:560px"></stick-scene> <script src="/scenes/stick.js" defer></script> <script src="/scenes/<id>.js" defer></script><script is:inline ... defer>を使用します。stick.jsはすべてのシーンスクリプトより前にドキュメント順で配置する必要があります(deferredスクリプトは順番に実行され、シーンはロード時にwindow.RIGを読み取ります)。複数のシーンがあるランディングページでは、各シーンをフレーム(1pxの境界線、白い背景、かすかなドットグリッド(14pxでradial-gradient(#e6e6e6 1px, transparent 1.2px))、フロアバンドを保持(no-floor無し)を持つ角丸カード)内に配置し、地面の線が小さなステージのように端から端まで続くようにします。ページ上のすべてのシーンに同じフレームと全コンテンツ幅を指定します。その後、実際のページをヘッドレスブラウザで読み込み、要素をビューにスクロールし、約3秒待機して、デスクトップとスマートフォンの幅でスクリーンショットを撮影します。
要素
scene:SCENES['<id>']として登録されたID。play:view(半分表示されたときに1回再生され、その後クリックで再生。ランディングページのデフォルトとして最適)、click、hover(マウスが上にある間ループ、タッチではクリック)、loop(常時実行、控えめに使用)、idle(決して再生しない)。no-floor: 地面の線の下の薄いグレーのバンドを削除します。白いページで使用します。no-ground: 線も削除します。zoom: ボックス内の描画を拡大縮小します(デフォルト1)。labelまたはaria-label: シーンが示す内容。デフォルトはシーンのlabel。no-font: Google FontsからBalsamiq Sansをロードしません(サイトが既にセルフホスティングしている場合、またはGoogleを呼び出してはいけない場合)。- CSSでサイズを指定します。描画は高さ(230pxがネイティブサイズ)とシーンのワールド単位の
widthにフィットし、中央に配置されます。 prefers-reduced-motionでは1つの静止フレームを表示し、再生しません。画面外のシーンは描画されません。STICK.theme({ butter: '#…', greenInk: '#…' })はページ全体のパレットカラーを変更します。1つのシーンだけに必要な場合は、シーン内のローカルカラー定数(diffity-review.jsのGitHubの追加/削除の緑色など)を優先します。
スタイルルール
- インク
#141414、白い紙の塗りつぶし、1つのバターまたはアクセントのハイライト、多くの空白。単語には8.5〜11pxのBalsamiq Sansを使用し、単語は少数に抑えます。 - フィギュアが主役です。頭やアクティブな手をプロップの後ろに隠さないでください。最初にプロップを描き、次にフィギュア、次に持っているものや飛んでいるものを描きます。
- 1シーン1アイデア。説明にキャプションが必要な場合、メタファーが間違っています。
- 作業ではなく結果を示します。状態が変化し、しばらく保持されるもので終わります。
- 描かれた動物や詳細なキャラクターよりも物理的なオブジェクトを優先します。2人目のフィギュア(ヘルパー)には、
ink/farを介して単一の色を割り当てます。AIエージェントはロボットです:fig(..., { ink: '#d97757', far: '#e8b7a3', bot: { col: '#d97757', dark: '#a8553a', glow, blink, happy } })は、丸い頭、暗いバイザーと光る目、耳ボルト、アンテナ球、胸部ライトを描画します。2人目のエージェントはティール(#3d7a8c、dark#2a5866、far#a9c9d1)にします。黒いエージェントも機能します:暗いcolは自動的に白いバイザーとインク色の目を取得します。作業中は明るいglow、完了時はhappyを設定し、各フィギュアの下のy = 16に小さなラベル(you、agent、claude)を配置します。 - エージェントは即座に反応すべきではありません。リクエストが到着した後、作業を開始する前に一拍置きます(
thinking…ライン、hmm…バブル、手をあごに当てる、ゆっくりとしたアンテナの点滅)。 - 他社のロゴは使用しないでください。プロップ上のプレーンテキストとしての製品名は問題ありません。