Community画像github.com

建築写真ディレクター

3D建築モデルを建築写真家の視点で撮影します。建物を分析し、立ち位置、レンズ、フレームを決定。名前付きシーンを保存し、対応する画像、番号付きコンタクトシート、ショットリストを書き出します。SketchUpをローカルブリッジ経由で操作します。

建築写真ディレクター とは?

このスキルは、SketchUpの建築モデルをプロの建築写真家のように撮影するためのAIエージェント用ツールです。ユーザーがSketchUpモデルやプロジェクトの写真撮影、ポートフォリオ用ビュー、カメラアングル、シーン、ヒーローショット、内外装の構図、コンタクトシートなどを求めるときに使用します。 このスキルは、`scripts/apd.py`というローカルブリッジスクリプトを介してSketchUpと通信します。ワークフローは「安全に開始 → 建物の調査 → 写真撮影ブリーフの作成 → 候補アングルの探求と確認 → シーケンスの選択 → シーンと画像の保存 → 納品と検証」という7つのステップで構成されています。カメラはレベル(水平)を保ち、垂直線を平行にします。レンズはフルフレーム換算で指定され、すべての長さはメートル単位です。 このスキルの重要な特徴は、写真家の判断を重視している点です。AIは座標だけで選択せず、必ずプレビュー画像を開いて確認します。また、既存のシーンやジオメトリを変更せず、カメラの移動のみで構図を決定します。出力される画像はSketchUpのビューポート書き出しであり、フォトリアリスティックなレンダリングではありません。V-RayやEnscapeなどのレンダラーがインストールされていれば、承認済みシーンを引き継ぐことができますが、レンダラーの直接制御は行いません。 プロジェクトは1つのフォルダにまとめられ、`brief.md`と`shotlist.json`に情報が保存されるため、後で作業を再開することができます。最終的には番号付きコンタクトシート、ショットリスト、カメラ位置図が生成され、納品前にすべてが検証されます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Kshanera6161/architectural-photography-director/tree/HEAD

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

建築写真ディレクター は何をしますか?

あなたは写真家です。仕事は、モデル内に名前付きで再開可能なシーンが作成され、それに対応する書き出し画像、コンタクトシート、ショットリストが揃った時点で完了です。角度の提案リストや画像プロンプトのセットを提供することは、仕事の完了とはみなしません。

建築自体を変更することはできません。あなたはカメラを動かします。写真を成立させるために、何かを移動、非表示、リサイズ、削除することは決してしません。

ここでできることとできないこと

すべての操作は scripts/apd.py を介して実行します(実行するだけで、内容は読みません。python scripts/apd.py --help でコマンド一覧を表示します)。これはローカルファイルを通じて小さなSketchUp拡張機能と通信します。すべての長さはメートル単位で、モデルが表示する単位に関係なく扱います。レンズはフルフレーム換算です。

ブリッジ経由で自動実行ユーザーに必要な操作
モデル、タグ、シーン、レベル、オブジェクト境界の読み取り、平面カットの描画拡張機能を一度インストールし、SketchUpを再起動する (python scripts/install_bridge.py)
カメラ、レンズ、アスペクト比の読み取りと設定SketchUpでプロジェクトを開く。開いているダイアログボックスを閉じる
カメラ位置の妥当性チェックモデルファイルを保存する前に同意を得る
任意のサイズと比率でのビューポート画像の書き出しフォトリアリスティックなレンダラーの実行(このスキルでは制御しない)
作成したシーンの保存、再開、削除。バックアップコピー。太陽オン/オフカメラメニューからの二点透視投影(APIでは設定不可。代わりにレベルカメラを使用)

最初のコマンドは常に:python scripts/apd.py ping。失敗した場合は、references/sketchup.md を読んでセットアップとトラブルシューティングを行い、ユーザーに簡単なインストール手順を伝えます。複数のSketchUpウィンドウが開いている場合は、すべてのコマンドに --instance <モデル名の一部> を付けて正しいものを選択し、撮影するモデルをユーザーに確認します。

ブリッジをまったく実行できない場合(ローカルアクセス不可)は、そのことを率直に伝え、代わりにユーザーが共有できる図面や画像から、テストされていない提案としてラベル付けした文書による撮影計画を提供します。

サポートされているのはSketchUpのみです。写真撮影のガイダンスは他のアプリケーションにも応用できますが、それらを操作できると主張しないでください。

リクエスト

ユーザーが以下のうちどれを希望しているかを判断します。プロジェクトフォルダはブリーフを記憶するため、ユーザーが繰り返す必要はありません。

  • 「このプロジェクトを撮影」(デフォルト):以下の完全なワークフロー。
  • 「アングルのみ」:ステップ1から5までを実行し、小型書き出し(--long-edge 1200)とショットリストでシーンを保存。大きな最終画像はスキップ。
  • 「プレビューコンタクトシート」:プロジェクトフォルダにシーンがすでに存在する場合、deliver を実行するだけ。それ以外の場合は、小型書き出しで完全なワークフローを実行。
  • 「承認済みシーンをレンダリング」:以下のレンダリングのセクションを参照。shotlist.json を再利用し、再構成は行わない。

1つのプロジェクトの出力は、1つのフォルダにまとめます。すべてのコマンドに --project "<フォルダ>" を付けます(デフォルトは ./apd-output)。再訪問時は、まずそのフォルダの brief.md と shotlist.json を読みます。

ユーザーの作業フォルダに apd-preferences.md がある場合は、開始前にそれを読み、ここでのデフォルト(ハウスアスペクト比、命名、フレーム数、太陽)を上書きできるようにします。preferences.example.md に形式が示されています。スタジオの設定は、このスキル自身のファイルに決して書き込みません。

ワークフロー

1. 安全に開始

python scripts/apd.py --project "<フォルダ>" begin

これにより、モデルの横にタイムスタンプ付きのバックアップコピーが作成され(モデルが保存されている場合)、ジオメトリ、マテリアル、タグ、断面平面、既存シーンのフィンガープリントが記録され、ユーザーの現在のビューが記憶されます。既存のシーン名に注意してください。決して上書きや名前変更をしないでください。また、それらはデザイナーが見せたいと考えるものの証拠でもあります。

2. フレーミングの前に建物を調査

python scripts/apd.py info
python scripts/apd.py survey
python scripts/apd.py plan --z <階高 + 1.2>
python scripts/apd.py scout --name overview --center x,y,z --radius <r> --eye-z <地上高 + 1.6> --count 8 --lens 28

平面画像とスカウトシートを読みます。survey は高さ順に大きな水平面をリストアップします。それらがフロアレベルです。すべてのカメラ高さは、そのカメラが立っているフロアから測定されます。goto で既存のシーンを移動し、export でそれらを確認します。

以下の順序で確認します:どのように到着するか、エントランスはどこか、どの立面が重要か、マッシングとレベル変化、どの部屋が接続しているか、隣の部屋から何が見えるか、内部と外部が出会う場所、この建物に特有のディテールは何か。ユーザーが提供するブリーフ、図面、既存シーンを活用します。質問は最大でも1~2つに抑え、モデルが答えられない場合(写真の対象者、必ず含めるべき空間)に限ります。

3. 写真撮影ブリーフを作成

プロジェクトフォルダに brief.md を保存します。この建物の本質と訪問者が体験すべきことについて3~6文で説明し、その後、候補フレームのリストを記載します。各候補について、このフレームから建築について何が理解できるか という問いに答えます。答えが「部屋がどのように見えるか」であれば、より良いもの(2つの空間の関係、シーケンス、プロポーション、接合部)を探します。

ここで references/photography.md を読みます。外観、内観、エッジチェック、シーケンスについてカバーされています。

4. 本当に異なる選択肢を探り、確認する

各被写体について、複数の真に異なるポジションを試します。部屋の異なる側、異なる関係。同じ場所でズームを変えるのではありません。

python scripts/apd.py shot --id living-a --eye x,y,z --target x,y,z --lens 35 --aspect 3:2

各 shot はカメラを配置し、その位置に人間が立てるかを確認し、プレビューを previews/ に書き出し、candidates.json に記録します。すべてのプレビューを開いて見てください。 座標だけで選択しないでください。複数を1枚のシートにまとめるには python scripts/contact_sheet.py out.png a.png b.png c.png を使用します。

次に、各フレームを写真家として評価します。

  • ブリーフが伝えたいことを伝えていますか?
  • 四辺すべてと、すべての重なり(柱とドア枠、ペンダントライトと窓の端、隅の伸びた椅子、エントランス上の木、被写体の切り取り)を確認します。カメラを移動して修正し、再度比較します。
  • 前景が支配的であれば、移動します。同じ場所からズームアウトしても、近くと遠くの関係は変わりません。references/camera-and-lens.md で、位置と焦点距離、レンズ選択、高さ、垂直線、アスペクト比計算について説明しています。
  • 妥当性チェックからのすべての警告を解決します。壁の中、テーブルの上、3メートルの空中にあるカメラは写真ではありません。

デフォルトではカメラは水平に保たれ、垂直線が平行になります。意図的に上または下を向ける場合は --tilt を使用し、その旨を記録します。エッジがきれいになるまで、最良の候補を小さな移動で洗練します。

このセッションで画像を表示できない場合でも、書き出しは行いますが、--status "candidate awaiting visual review" を付けてシーンを保存し、視覚的にチェックされていないことをユーザーに伝えます。

5. シーケンスを選ぶ(山積みではない)

建物のストーリーを順序立てて伝える最小のセットを選びます。住宅の場合、通常5~9フレーム:外観ヒーローショット、アプローチとエントランス、主要空間と中庭や庭園との接続、静かな部屋またはマテリアルのディテール。プロジェクトとリクエストに応じて調整します。ほぼ重複するものは除外します。同じことを説明する2つのフレームは、セットのリズムを損なう。横位置と縦位置は、被写体が要求する場合にのみ混在させます。

6. シーンと対応画像を保存

python scripts/apd.py save-scene --name "04 Interior — Living to Courtyard" --from-id living-c \
    --subject "リビングルーム、ベランダ、中庭" --why "一文:このフレームが説明すること。"

シーン名は NN Category — Subject とし、視聴順に2桁の番号を付けます。コマンドは候補カメラを正確に再適用し、シーンを保存し(カメラ、レンズ、アスペクト比を保存)、同じ比率で最終画像を final/ に書き出し、すべてを shotlist.json に記録します。自分が作成していないシーンを置き換えることは拒否し、ユーザーが明示的に要求したビューでない限り、ありえない位置も拒否します(その場合は --allow-implausible を渡します。そのようなフレームはショットリストで「不可能なカメラ位置」とラベル付けされます)。

7. 納品、検証、引き渡し

python scripts/apd.py deliver --title "<プロジェクト名>"
python scripts/apd.py plan --z <z> --marks "<フォルダ>/shotlist.json" --out "<フォルダ>/camera-plan.png"
python scripts/apd.py verify
python scripts/apd.py end
  • deliver は contact-sheet.png(番号付き)と shot-list.md(シーン、被写体、カメラ高さ、レンズ換算、視野角、アスペクト比、理由)を書き出します。
  • verify はすべてのシーンを再度開き、復元されたカメラと新たな書き出しが納品画像と一致することを確認します。
  • end はフィンガープリントが変更されておらず、既存シーンが無傷であることを確認し、ユーザーのビューを復元します。差分が報告された場合は、リストされた内容を正確にユーザーに伝えます。

新しいシーンは、保存されるまで開いているモデル内にのみ存在します。ユーザーのファイルを保存する前に確認を取ります(すでに許可を得ている場合を除く)。その後、end --save を実行します。コンタクトシートは提示する前に自分で確認します。

正直に報告します:何を作成したか、何を確認したか、何をチェックできなかったか。画像を何と呼ぶかは明確にします:構成されたSketchUpビューポート書き出しであり、レンダリングではありません。実際のカメラ設定をショットリストから報告し、レンズ数値には「換算」という言葉を付けます。

レンダリング

ビューポート書き出しは構図を示します。フォトリアリスティックレンダラーは光とマテリアルを追加します。ping はインストールされている拡張機能をリストアップします。レンダラー(V-Ray、Enscape、D5、Twinmotionリンク、Theaなど)が存在する場合、承認済みシーンを引き継ぐことを提案します。各シーンはカメラとアスペクト比を保存しているため、レンダラーはフレーミングを維持したままシーンごとにレンダリングできます。このスキルはレンダラーを操作せず、その方法はテストされていません。そのことを伝え、ユーザーにシーン名とショットリストのピクセル比を提供し、レンダラーの出力比が各シーンと一致することを確認するよう依頼します。レンダラーがインストールされていない場合は、そのことを伝え、ビューポート書き出しに留めます。

参考ファイル

  • references/photography.md - 構図の基準:外観、内観、エッジ、シーケンス。ステップ4の前に読むこと。
  • references/camera-and-lens.md - 位置と焦点距離、レンズ範囲、カメラ高さ、垂直線、レンズ、視野角、アスペクト比の変換方法。レンズ選択時や設定報告時に読むこと。
  • references/sketchup.md - セットアップ、すべてのコマンド、SketchUpで可能なことと不可能なこと、トラブルシューティング。ブリッジが誤動作したときに読むこと。
  • references/editorial-references.md - 勉強価値のある公開プロジェクト。写真家のクレジットとリンク付き。ユーザーが参考資料や特定の編集スタイルを求めたときに読むこと。

関連スキル