scenes-gathered-zine-live-flow-v1-0

拾景紙刊の実写全工程 v1.0（実写版）

提供された写真 1 枚から、インポート可能な Live Photo ZIP を 1 つ作成します。処理は、厳密に分離された 2 つのモジュールを通じて行います。

1. 固定された同梱モジュール references/static-poster-v1-9/SKILL.md を使用して、完成したポスターを作成します。
2. 完成したポスターを覆う平らなシートだけをアニメーションさせて、取り除きます。
3. 最終フレームを正確に Apple Live Photo JPG/MOV ペアにします。
4. そのペアだけを 1 つの ZIP にパッケージ化します。
5. インポートを求められた場合は、macOS のファイルを開く操作を通じて ZIP を「实况照片导入器」に渡し、そこで終了します。

同梱の static-poster-v1-9 モジュールを変更しないでください。静止画に関するすべての判断の唯一の基準として使用します。

トリガーモード

• 全工程／インポート： 元写真 → v1.9 ポスター → Live ZIP → インポーターへの引き渡し。
• ZIP のみ： 元写真または完成済みの v1.9 ポスター → --no-import を指定して Live ZIP を作成。
• 静止画のみ： references/static-poster-v1-9/SKILL.md に直接従い、アニメーションの前に終了します。

確立済みの全工程ワークフローでは、プレビュー動画、コンタクトシート、目視レビューのゲート、メタデータレポート、承認待ちを省略します。明示的なエラーが返されない限り、自動的に続行します。最終的な目視確認はユーザーが行います。

フェーズ 1：ポスターを固定する

入力が未加工の写真の場合：

1. 同梱モジュール references/static-poster-v1-9/SKILL.md をすべて読み、記載どおりに従います。
2. 必須の画像生成手順を使用して、向きを一致させたポスターを生成します。
3. 平坦化した結果を、現在のプロジェクトの出力ディレクトリに保存します。

入力がすでに完成済みの v1.9 ポスターの場合は、そのまま使用します。

このフェーズの後は、完成したポスターを変更不可の底板として扱います。アニメーション中に、色調変更、シャープ化、明瞭化、再生成、トリミング、縦横比を維持しないリサイズ、顔のレタッチ、ディテールの追加、その他の再デザインを行わないでください。完全に現れたすべてのフレーム領域は、この固定されたポスターから直接取得する必要があります。

フェーズ 2：裂け目を選ぶ

完成したポスターを確認してから、裂け目の経路を構成します。以下を読みます。

• references/adaptive-path-selection.md
• references/adaptive-tear-boundary.md

ソースに基づくカスタム経路を、正規化されたポイント 3～7 個で必ず 1 つ構成します。プリセットの方向から選ばないでください。静かな紙面から始め、環境や手がかりを示し、次に構造上の関係を見せ、中央の 3 分の 1 の間に主要な被写体を登場させ、視覚的に明確な止めどころで終えます。

実際の稜線、海岸線、屋根の線、道路、視線、空間の奥行きの変化、または被写体同士の関係に沿わせます。ポスターのガイドカラーを引き立てつつ、なぞらないようにします。上から下、または下から上への見せ方、一本の硬直した直線的な対角線、顔、身体、テキスト、特徴を決定づける物体は避けます。

開口部は、シーンに応じた 1 本のグローバルな経路に沿って進みます。その境界には、振幅が大きく周波数の低い、幅広い起伏、小さく不揃いな切れ込み、変化する開口幅、細い暖色の繊維状の縁を用います。デジタル的で不自然なワイプ、均一なのこぎり歯、規則的なジグザグ、丸まったシート、3D の奥行きシミュレーションは採用しません。

フェーズ 3：Live ZIP を作成する

固定されたポスター、選択した方向、任意のカスタム経路を指定して、scripts/build_live_zip_and_import.py を使用します。使用できるモーションプロファイルは固定されています。

• 30 fps で 3.0 秒。
• 全面が覆われた状態を短く維持。
• 裂け目が進行。
• 広く丸みのある低周波の境界変化を伴う、左右非対称な両側への拡大。
• 2.7 秒から最終ホールドまで、ポスターを一切変更せず正確に表示。
• カメラの動き、被写体の動き、照明の変更、視差、内部アニメーションなし。

ZIP のみを作成する例：

python3 scripts/build_live_zip_and_import.py \
  --input /absolute/path/to/final-poster.png \
  --output-zip /absolute/path/to/GatheredScenesLivePhoto.zip \
  --direction custom \
  --path-points "0.04,0.72;0.26,0.60;0.52,0.44;0.76,0.34;0.98,0.24" \
  --no-import

ペアリングの不変条件については、references/apple-live-photo.md を参照してください。ZIP の仕様は厳格です。

• 最上位フォルダーは 1 つだけ。
• その中に、対応する .JPG と .MOV が各 1 つだけ。
• ZIP の中にポスター、レシート、コンタクトシート、プレビュー、ソースファイル、サイドカーファイルを入れない。
• このワークフローで必要な、永続的な納品物は ZIP のみ。

すべてのレンダリングフレーム、ペアになっていないメディア、レシートは一時ファイルとして扱います。

フェーズ 4：インポーターへの引き渡し

ユーザーが自動化された一連の処理全体を求める場合、または結果を「写真」に保存するよう求める場合は、--no-import を省略します。references/importer-handoff.md を読み、ビルドスクリプトで完成した ZIP をバンドル ID com.zeejay.live-photo-importer で開きます。

このスキルには、すぐに実行できる Apple シリコン搭載 macOS 用インポーター assets/实况照片导入器.app が含まれています。ビルドスクリプトは、明示的に指定されたアプリ、ユーザーがインストール済みのコピー、同梱されたコピーの順に自動で確認します。別途インポーターをダウンロードするよう求めないでください。

ドラッグ＆ドロップを模擬したり、「写真」アプリを操作したりしないでください。ZIP が「实况照片导入器」に正常に渡された時点で処理を終了します。ペアリングの検証、権限、「写真」ライブラリへの追加、その後の iCloud 同期はインポーターが担当します。

インポーターが見つからない場合は、まず同梱アプリが存在し、破損していないことを確認します。それ以外の場合は完成した ZIP を保持し、引き渡しエラーを報告します。ポスターやアニメーションを再生成しないでください。ほかの正確なアプリパスがわかっている場合に限り、--importer-app /absolute/path/实况照片导入器.app を使用します。

応答の形式

ZIP のみのモードでは、ZIP の絶対パスを返します。処理全体のモードでは、ZIP の絶対パス、macOS がインポーターへの引き渡しを受け付けたかどうか、構成されたナラティブの流れの簡潔な説明を返します。ユーザーが明示的に求めた場合を除き、中間ファイルは提示しないでください。