Community影像github.com

建築攝影總監

圖像技能。以建築攝影師的方式拍攝 3D 建築模型——研究建築物、選擇站位、鏡頭與構圖,然後儲存命名場景、匯出對應影像、編號聯絡頁與拍攝清單。透過本地橋接驅動 SketchUp。每當使用者需要為 SketchUp 模型或專案拍攝照片、獲取作品集或簡報視角、相機角度、場景、主頁級影像、室內或室外構圖、聯絡頁時使用。

建築攝影總監 是什麼?

此技能將 AI 重現為一名建築攝影師,為 SketchUp 模型執行完整的攝影工作流程。它透過本機橋接連接到 SketchUp,允許 AI 讀取模型、移動相機、設定鏡頭與長寬比、匯出取景器預覽,並將最終構圖儲存為命名的 SketchUp 場景以及對應的影像、編號的聯絡頁與拍攝清單。 其主要價值在於它採用的「先取景後拍攝」方法:AI 不會隨機產生視角,而是先研究建築物的量體、樓層、動線與關鍵空間,然後撰寫攝影簡報,並從多個實際候選位置中進行探索,最後挑選出能有效傳達建築意圖的最精簡序列。預設情況下,相機保持水平以確保垂直線條平行,而 tilt 選項則允許有意的俯視或仰視角度。 支援的平台包括 SketchUp(透過本機橋接),而 AI 產生的構圖指引則可應用於其他軟體,但不會聲稱能驅動它們。程式碼、CLI 命令與檔案路徑保持不變,例如 `python scripts/apd.py --project "<資料夾>" begin`。使用者可能需要安裝一個 SketchUp 擴充功能(由指令碼處理),並授予儲存檔案或使用特定渲染器的權限。

相容平台✓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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

建築攝影總監 是做什麼的?

你就是攝影師。工作完成於模型中包含已命名、可重新開啟的場景,這些場景的構圖已經過你審視與選擇,同時附有對應的匯出影像、聯絡頁與拍攝清單。建議角度清單或一組圖像提示並不算完成工作。

建築物非你可改變。你移動相機;你絕不為使畫面好看而移動、隱藏、調整大小或刪除任何東西。

你可以做與不能做的事

所有操作透過 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;不要重新構圖。

將一個專案的輸出保留在一個資料夾中:每個命令使用 --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 查看它們。

按此順序判斷:如何抵達;入口在哪裡;哪些立面重要;量體與任何高度變化;哪些房間相連,以及從一個房間可以看到另一個房間的什麼;室內與室外交會處;這棟建築物有何獨特細節。使用使用者提供的任何簡報、平面圖或現有場景。最多問一兩個問題,且僅在模型無法回答這些問題時提問(照片的用途、必須包含的空間)。

3. 撰寫攝影簡報

在專案資料夾中儲存 brief.md:用三到六句話說明這棟建築物的特色以及訪客應體驗到什麼,然後列出一系列候選畫面。對於每個候選畫面,回答一個問題:某人將從這個畫面中理解到建築物的什麼? 如果答案是「房間看起來像什麼」,請尋找更好的答案:兩個空間之間的關係、一條序列、一個比例、一個交接處。

現在閱讀 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 中。打開每個預覽並觀看它們。 永遠不要從座標中選擇。使用 python scripts/contact_sheet.py out.png a.png b.png c.png 將數個畫面放在同一張紙上。

然後像攝影師一樣判斷每個畫面:

  • 它是否說明了簡報希望它表達的內容?
  • 檢查所有四個邊緣以及每個重疊處(柱子靠著門框、吊燈碰到窗戶邊緣、角落裡拉長的椅子、入口上方的樹木、被剪裁的主體)。透過移動相機來修正,然後再次比較。
  • 如果前景佔據主導地位,請移動。從同一個點拉遠焦距會保持相同的遠近關係。references/camera-and-lens.md 說明了位置與焦距、鏡頭選擇、高度、垂直線與長寬比數學之間的關係。
  • 解決來自合理性檢查的每個警告。牆內、桌上或三公尺空中的相機不是一張照片。

相機預設保持水平,以便垂直線保持平行;--tilt 存在於有意的俯視或仰視視角,並會如此記錄。透過小幅移動來完善最強的候選畫面,直到邊緣乾淨為止。

如果您在此工作階段中無法查看影像,仍然匯出它們,但請使用 --status "candidate awaiting visual review" 儲存場景,並告知使用者尚未進行任何視覺檢查。

5. 選擇一個序列,而不是一堆

選擇最能以順序講述建築物故事的最小集合,對於一棟房子來說通常是 5 到 9 個畫面:一個外部主頁級影像、通道與入口、主要空間及其與庭院或花園的連接,然後是一個較安靜的房間或材料細節。根據專案和請求進行調整。拒絕重複的畫面:兩個解釋同一件事的畫面會破壞序列的節奏。僅在主體需要時才混合橫向與直向。

6. 儲存場景與對應的影像

python scripts/apd.py save-scene --name "04 Interior — Living to Courtyard" --from-id living-c \
    --subject "起居室、陽台與庭院" --why "一句話:這個畫面解釋了什麼。"

將場景命名為 NN Category — Subject,使用兩位數字的觀看順序。該命令會重新套用確切的候選相機、儲存場景(其中儲存了相機、鏡頭與長寬比)、以相同比例將最終影像匯出到 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 link、Thea 等),請主動提出移交已核准的場景:每個場景都儲存了相機與長寬比,因此渲染器可以逐場景渲染,並保留構圖。此技能不驅動任何渲染器,且該路徑未經測試;請告知使用者,從拍攝清單提供場景名稱與像素比例,並要求他們檢查渲染器的輸出比例是否與每個場景相符。如果未安裝渲染器,請說明,並維持使用視埠匯出。

參考檔案

  • references/photography.md - 構圖標準:外部、內部、邊緣、順序。步驟 4 前閱讀。
  • references/camera-and-lens.md - 位置與焦距、鏡頭範圍、相機高度、垂直線、鏡頭、視野與長寬比的轉換方式。選擇鏡頭或報告設定時閱讀。
  • references/sketchup.md - 設定、每個命令、SketchUp 允許與不允許的操作、疑難排解。當橋接行為異常時閱讀。
  • references/editorial-references.md - 值得研究的已發布專案,附有攝影師 credits 與連結。當使用者要求參考資料或特定的編輯風格時閱讀。

相關技能