create-apple-notes-mockup
実際のiPhoneスクリーンショットのように見えるApple Notes画面を生成します。正しいステータスバー、フローティングツールバーピル、太字タイトル、段落間隔のある本文テキスト、黄色のテキストカーソル、自動修正アンダーライン、オプションの埋め込み画像とチェックリスト、およびオプションのiOSキーボードを備えています。
目的
JSONノート仕様を、ピクセル精度のApple Notes(iPhone、ライトモード)スクリーンショット(HTML + PNG、ネイティブ解像度1180×2556、DPR 2)に変換します。これは、create-apple-notes-video-ad 分子がタイピングアニメーションを偽装するためにフレームごとに駆動する、決定論的なLLM非依存のレンダラーであり、広告、ソーシャル投稿、ストーリーボードにおける「自分へのメモ」ワンショットビートのためのスタンドアロンツールでもあります。オーケストレーションエージェントがコピーを管理し、このアトムが忠実度(ステータスバー、スマート句読点、カーソル、自動修正アンダーライン、ツールバー、キーボードクローム)を担当します。
使用すべきタイミング
- 広告、ソーシャル投稿、ビデオシーン、プロダクトモックアップ用のApple Notes風スクリーンショットが必要な場合。
- タイピングアニメーションビデオを駆動するためのApple Notesフレームのシーケンス(タイトルのみ → 段落追加 → カーソル移動)が必要な場合 —
create-apple-notes-video-adで使用されます。 - ストーリーボード内で静的な「自分へのメモ」ビートが必要な場合。
iMessageのスレッドをレンダリングする場合は、代わりに skills/atoms/messaging/create-imessage-mockup を使用してください。
入力
このスキルは決定論的です。LLMは組み込まれていません。オーケストレーションエージェントが以下のスキーマに一致するノートJSONを作成し、レンダラーを呼び出します。
ノートJSONスキーマ
{
"title": "こんにちは",
"body": [
{ "type": "paragraph", "text": "これはApple Notesアプリでタイピングしている画面録画です。" },
{ "type": "paragraph", "text": "これがどのように感じられるか見てみましょう。" }
],
"cursor": "end",
"autocorrect_underline": ["これ", "どのように"],
"status_bar": {
"time": "9:41",
"battery_pct": 87,
"battery_low": false,
"show_focus_glyph": false
},
"show_keyboard": false,
"keyboard_state": {
"suggestions": ["みる", "いく", "する"],
"shift": "lower",
"letters_row1": "qwertyuiop",
"letters_row2": "asdfghjkl",
"letters_row3": "zxcvbnm"
},
"with_iphone_frame": false
}
title— 文字列。太字の見出し、1行。body[]— ブロックリスト。サポートされるブロックタイプ:paragraph—{ "text": "..." }。スマート句読点が自動適用されます('→'、"→"、...→…、--→–、---→—)。image—{ "src": "<path|url>", "caption": "optional" }。相対パスは仕様ファイルのディレクトリを基準に解決され、データURIとしてインライン化されます。checklist—{ "items": [{ "text": "...", "checked": true|false }] }。チェックされた項目は黄色の塗りつぶし丸と取り消し線、チェックされていない項目は灰色のアウトライン丸で表示されます。divider— 水平線。
cursor—"title" | "end" | null。"title"はタイトルの最後に黄色いキャレットを配置します。"end"は最後の段落の最後に配置します。nullは非表示にします。autocorrect_underline[]— 大文字小文字を区別する単語リスト。各出現箇所にApple Notesの中間タイピング時の黄色いアンダーラインが付きます(<span class="spell">)。status_bar—time、battery_pct(0–100)、battery_low(バッテリーを赤く表示)、show_focus_glyph(時刻の横にDND/車アイコン)。Dynamic Islandはレンダリングされません。show_keyboard—trueでiOS QWERTY + フォーマットツールバーをオーバーレイします。keyboard_state—show_keyboardがtrueの場合のみ参照されます。shift="lower" | "upper"。with_iphone_frame— 薄い暗いベゼルインセットを追加します(ヒーローコンポジション用)。
CLI
node render.js --note examples/mid.json
node render.js --note examples/long.json --output ./my-exports/ --name todays-note
node render.js --note my-note.json --with-keyboard
node render.js --note my-note.json --viewport 1080x1920 # 9:16 広告配信サイズ
フラグ
| フラグ | 効果 |
|---|---|
--note <path> | (必須) 上記スキーマに一致するJSONファイル |
--with-keyboard | show_keyboardを強制有効化(仕様を上書き) |
--with-iphone-frame | ハードウェアベゼルを強制有効化 |
--no-frame | ハードウェアベゼルを強制無効化 |
--output <dir> | 日付付き出力フォルダの親ディレクトリ。デフォルト ./apple-notes-mockup-exports/ |
--name <slug> | 出力フォルダのスラッグを上書き |
--out-html <path> / --out-png <path> | 明示的なパスに直接書き込み(日付フォルダをスキップ) |
--viewport WxH | レンダービューポートを上書き(デフォルト 1180x2556) |
--dpr N | デバイスピクセル比(デフォルト 2) |
出力
<output>/<YYYY-MM-DD>-<slug>/
index.html # 完全なスタンドアロンHTML(画像はデータURIとしてインライン化)
screenshot.png # 選択されたビューポート×DPRでレンダリングされたPNG
spec.json # 再現性のための入力のコピー
デフォルトの <output> はカレントワーキングディレクトリの ./apple-notes-mockup-exports/ です。
ワークフロー
- プロンプトまたは既存のノートJSONを受け取ります。
- プロンプトのみが与えられた場合:スキーマに一致する
note.jsonを作成し、保存します。 node render.js --note <path> [--with-keyboard]を実行します。- 生成されたPNGを開いてレイアウトを確認します。何か問題がある場合(折り返し、カーソル位置、バッテリーの色など)、JSONを編集して再レンダリングします。
セットアップ(初回のみ)
cd create-apple-notes-mockup
npm install
npx playwright install chromium
リポジトリには create-imessage-mockup/node_modules へのシンボリックリンクが同梱されているため、新しいクローンでは npm install はこのスキルを自己完結させたい場合にのみ必要です。
ファイル
| ファイル | 目的 |
|---|---|
render.js | CLIエントリポイント — フラグを解析、画像パスを解決、HTMLを生成、スクリーンショットを取得 |
generate.js | ノートJSON → スタンドアロンHTMLページ(ここでスマート句読点と自動修正アンダーラインが適用されます) |
screenshot.js | HTML → PNG(Playwright chromiumヘッドレス経由、1180×2556、DPR 2) |
templates/note.css | すべてのビジュアルスタイリング(ステータスバー、ツールバー、本文、チェックリスト、画像、キーボード) |
templates/icons.js | インラインSVGアイコン(戻るシェブロン、元に戻す、共有、その他、完了チェック、信号、Wi-Fi、バッテリー、フォーマットツールバーアイコン、キーボードグリフ) |
assets/samples/sample-landscape.jpg | examples/with-image.json で使用されるサンプル画像 |
examples/*.json | すべてのバリエーション(タイトルのみ、タイピング途中、長文複数段落、チェックリスト付き、画像付き、フレーム1小文字キーボード)をカバーする6つのリファレンスノート |
tests/run-all.sh | すべての例を tests/output/ にレンダリングしてビジュアルレビューを実行 |
apple-notes-skill-build.html | リファレンスビデオフレームと生成されたPNGを比較するサイドバイサイドレビューボード |
品質チェック
ノートが出荷可能と宣言する前に:
- タイトルが通常の太さではなく、太字の見出しでレンダリングされている。
- 本文テキストがAppleのスマート句読点を使用している —
'はカール、"はカール、…は1文字。 - 黄色いカーソル(
#FFCC00)がターゲットテキストの最後にぴったりと配置され、幅は約5px。 - 本文段落が1行の空白行(手動の
<br>なし)で区切られている。 - 自動修正アンダーラインはフラグが立てられたトークンの下にぴったりと配置された短い黄色い線で、大文字小文字を区別するマッチング。
- ステータスバー:時刻が左、信号/Wi-Fi/バッテリーが右。
battery_low: trueの場合のみバッテリーが赤くなる。Dynamic Islandなし。 - スクロールマスク: ステータスバーとツールバーは不透明な白い背景を持ち、分子のドライバーによってスクロールされた本文コンテンツが透けて見えないようにする。DevToolsで
.noteを-300pxだけ移動させ、タイトルがツールバーによって完全にマスクされていることを確認する(後ろや透けて見えない)。 - ツールバー:フローティング戻るシェブロンピル(左)、白いカプセル型の元に戻す/共有/その他、黄色い完了丸(右)。すべてにソフトシャドウが適用されている。
- キーボード(有効時):QWERTYレイアウトが
shiftの大文字小文字設定に一致、サジェストストリップに3つの単語が表示、キーの上にフォーマットツールバーピル、下部にマイクと地球儀。 - 画像ブロックは丸みを帯びた角(約18px)でレンダリングされ、本文の左パディングを尊重する。
- チェックリスト:チェックされた項目は黄色い塗りつぶし丸 + 取り消し線、そうでない項目は灰色のアウトライン丸。
障害モード
| 症状 | 原因 | 修正 |
|---|---|---|
| 本文テキストの折り返しが1語早すぎる/遅すぎる | フォント幅がリファレンスと異なる(ChromiumがSF以外のフォールバックを選択) | .note-body の font-size を2px単位で調整するか、左右のパディングを減らして .note を広げる |
| タイトルが細く見える/十分に太くない | ホストにSF Pro Displayがなく、システムがより細いフォントにフォールバック | font-weight: 900 に設定(デフォルトのまま)し、`fc-list |
| 「Hello's」「Let's」がストレート引用符でレンダリングされる | スマート句読点プリプロセッサが無効 | escapeHtml の前に generate.js で smartQuotes() が呼び出されていることを確認 |
| 画像がレンダリングされない(空白スペース) | リモートURLがブロックされているか、相対パスが解決されなかった | ローカルファイルパスを使用。render.js はローカル画像をbase64としてインライン化 |
| 自動修正アンダーラインが「this」のみを意図しているのに「This」にもマッチする | 正規表現が大文字小文字を区別していなかった | デフォルトでは正規表現は大文字小文字を区別。autocorrect_underline に正確な大文字小文字の文字列を渡す |
| 空の段落がつぶれる(カーソルスペースがない) | 内容のない <p class="note-paragraph"></p> の高さがゼロ | CSSで margin: 0 0 84px 0 が設定されているため、空の段落でも1段落分の間隔が確保される。末尾のマージンを削除していないことを確認 |
| 黄色い完了丸がオレンジ色に見える | CSSの色ずれ | 純粋なAppleの黄色は #FFCC00。カーソルと完了で値を共有。#FFC107(Material Amber)に変更しない |
| キーボードサジェスト「Hello's」がストレートアポストロフィでレンダリングされる | サジェストにスマート引用符が適用されていない | generate.js の smartQuotes(s) で適用されることを確認済み |
参考
ビジュアル仕様は apple-notes-typing.MP4(Apple Notesをライトモードでタイピングする36秒のiPhone画面録画)から抽出されました。このフォルダの apple-notes-skill-build.html を参照して、サイドバイサイドの証明を確認してください。各例はターゲットとするリファレンスフレームとともに表示されます。