Communitygithub.com

LucasH1225/restaurant-website-skills

審計、還原、重建並驗證有證據支持的餐廳店面與到訪攝影,用於私人網站展示。在 Codex 需要將真實場地外觀參考轉化為忠實的 AI 輔助門面影像、修復曝光或透視、建立可辨識的到訪示意、保留招牌與建築特色、記錄來源與輸出的對比證據,或判斷外觀影像是否安全可用於展示或公開用途時使用。請勿用於虛構的店面概念、僅限室內的工作、食物攝影、一般建築渲染圖、脫離街景截圖,或任何無法以當前真實場地證據為基礎的影像。

restaurant-website-skills 是什麼?

此技能專為 AI 代理(如 Codex)設計,用於處理餐廳店面外觀影像的建立與驗證。其核心目標是基於真實的當前照片,透過 AI 輔助進行忠實還原、修復或參考式重建,以產出一張可直接用於網站展示且可辨識的店面影像。技能規範了完整的工作流程,包括審計來源、鎖定餐廳身份、選擇合法的轉換模式(忠實還原或參考式重建)、生成與驗證影像,並通過六道品質保證閘門(身份、立面、招牌、色彩、到訪準備度、AI 痕跡與網頁就緒性)來確保輸出忠於原始證據。支援的平台包括任何能執行 Markdown 指令與 Python 腳本的開發環境,例如 Codex。其運作方式依賴於結構化的工作訂單清單、驗證腳本(validate_manifest.py、register_output.py、make_review_sheet.py)與嚴格的規範,以防止 AI 產生虛構的細節或美化效果,確保最終資產可用於私人展示或公開發布。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/LucasH1225/restaurant-website-skills/tree/HEAD/skills/restaurant-exterior-image-studio

在你喜歡的 AI 中提問

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

說明文件

餐廳店面影像工作室

建立一幅可辨識、準備好用於網站的店面影像,無需重新設計餐廳。將當前的真實照片視為建築、招牌、入口、立面顏色、窗戶、遮陽篷及固定特徵的權威依據。僅將 AI 視為還原或基於忠實參考的呈現層。

在獲取來源、提示、生成或審查外觀之前,請先閱讀 references/exterior-image-playbook.md。複製 assets/exterior-manifest-template.json,而不是自行發明工作訂單。

選擇模式

  • 審計: 驗證餐廳身份、來源時效性、可見的店面事實、遮擋風險及權利狀態。請勿生成。
  • 建立: 選擇一個事實性的主要來源,撰寫保存合約,生成一幅忠實的外觀提案並保留證據。
  • 修復: 診斷失敗的輸出,並從未經修改的真實來源重新生成。
  • 審查: 比較來源與輸出,記錄所有 QA 決策,並判斷其是否適用於私人展示或發布。

讓 $restaurant-demo-builder 決定外觀辨識度是否能支援受眾、轉換目標及頁面結構。使用此技能來產生並驗證外觀資產本身。若任務是提取並將場地顏色轉換為網站代碼,請分別使用 $restaurant-brand-palette。

準備工作訂單

建立 output/exterior-image-studio/<restaurant-slug>/ ,包含:

sources/
prompts/
drafts/
selected/
review/
exterior-manifest.json

複製 manifest 模板。使用小寫 ASCII 檔案名稱。確保 API 金鑰、私鑰及帳戶機密不會出現在任何工作訂單檔案中。

鎖定餐廳身份與來源

驗證餐廳名稱、地址及(若有的話)當前的 Google Place ID。將每個事實性影像連同其原始 URL、平台、檢查日期、權利狀態及 SHA-256 儲存在本地。按以下順序優先選擇來源:

  1. 目前由餐廳擁有或業主提供的照片;
  2. 已獲得業主明確核准的當前照片;
  3. 已明確授權的旅遊、商會或媒體照片;
  4. 向業主請求拍攝的新手機照片;
  5. 僅用作私人展示事實參考的目前公開場所、社交媒體、評論、目錄或顧客照片。

街景可用於確認身份、進出路徑及未來拍攝角度,但絕不能將脫離街景的截圖用作影像輸入或網站資產。切勿將平台外框或地圖截圖貼入展示中。

使用 view_image 檢查每個來源。記錄其是否能證明招牌、入口、立面幾何形狀、立面顏色及固定特徵。記錄不確定性、暫時性遮擋、人臉、車牌號碼、季節性阻擋以及店面可能已過時的證據。

在規劃之前執行來源閘門:

python3 <exterior-skill>/scripts/validate_manifest.py \
  --manifest <work-order>/exterior-manifest.json \
  --stage source

選擇一個真實的轉換方式

當主要照片已經具有有用的拍攝角度且所有重要區域都可見時,使用 faithful-restoration。僅當一張或多張當前真實照片完整支援輸出所需的所有店面區域,但來源需要更乾淨的網站呈現時,才使用 reference-based-recreation。

在提示之前建立保存合約。保留建築、店面比例、招牌文字與位置、標誌形狀、入口、窗戶與門的幾何形狀、遮陽篷、油漆與材料顏色、固定燈具、無障礙設施及其他永久的到訪提示。

僅允許記錄在案的變更,例如曝光恢復、白平衡、輕微色彩校正、鏡頭或透視校正、噪點清理、保守地放大、隱私模糊化及響應式裁切。僅當另一個當前來源能證明被揭露的區域時,才移除暫時性遮擋。否則,請在遮擋物周圍進行裁切。

請勿重建隱藏區域、改寫招牌文字、發明標誌、更改油漆或材料、移動入口、更改窗戶、添加景觀或照明、移除固定特徵、編造停車位、添加露台、消除影響到訪的相鄰環境,或讓場地看起來更豪華。

將確切的提示儲存在 prompts/ 下,記錄其 SHA-256,並通過生成閘門:

python3 <exterior-skill>/scripts/validate_manifest.py \
  --manifest <work-order>/exterior-manifest.json \
  --stage generate

從真實參考生成

使用 $imagegen,並搭配事實性主要來源及僅在 manifest 中記錄的支援來源。說明來源控制店面事實,而提示僅控制允許的呈現變更。指定目標長寬比及預期的網站放置位置。禁止新增文字、新標誌、建築變更、隱藏區域發明、美化升級及不支援的物體移除。

以非破壞性方式儲存每次嘗試。切勿將先前的 AI 輸出用作店面證據。

註冊選定的點陣圖,以便保留其真實尺寸及 SHA-256:

python3 <exterior-skill>/scripts/register_output.py \
  --manifest <work-order>/exterior-manifest.json \
  --output <work-order>/selected/storefront-proposal.png

執行六道 QA 閘門

以實用尺寸比較未經修改的主要來源、所有支援參考及選定的輸出。獨立記錄每個閘門:

  • identity:輸出毫無疑問是同一家當前的餐廳。
  • facade_fidelity:幾何形狀、材料、窗戶、遮陽篷及固定特徵保持事實性。
  • signage_fidelity:招牌文字、標誌、位置及比例保持不變且清晰可讀。
  • color_fidelity:立面及招牌顏色未轉變為新的品牌身份。
  • arrival_readiness:入口及有用的尋路背景保持清晰;隱私問題已處理。
  • ai_tells_and_web_readiness:無格式錯誤的文字、發明的細節、合成表面或無法使用的裁切。

建立內部對照表:

python3 <exterior-skill>/scripts/make_review_sheet.py \
  --manifest <work-order>/exterior-manifest.json \
  --out <work-order>/review/source-vs-output.html

在保留規範證據後,將 review.source_record 和 review.output_record 設為 recorded。這是工作流程證據,而非業主核准。

發布至展示或公開用途

在將選定的輸出複製到網站之前,立即執行私人展示閘門:

python3 <exterior-skill>/scripts/validate_manifest.py \
  --manifest <work-order>/exterior-manifest.json \
  --stage demo

私人展示可以使用基於權利狀態未知的公開真實照片的提案,但需保留原始內部資料,將輸出標記為照片提案,並保留 owner_confirmation: pending 和 publication_status: not-cleared。

公開發布需要獲得業主對當前準確性的核准,以及業主提供、已授權或明確許可的來源。執行 --stage publication;請勿推論私人一對一展示用途已經清除了發布權利。

交接

報告身份證據、未經修改的來源、權利狀態、保存合約、提示、選定的輸出、六項 QA 決策、對照表、當前驗證階段、業主確認狀態及發布障礙。未經明確授權,請勿發布或聯繫餐廳。

範例調用

  • $restaurant-exterior-image-studio 審計這些店面參考資料,並告訴我是否可能製作忠實的私人展示影像。
  • $restaurant-exterior-image-studio 根據經過驗證的餐廳照片建立一幅寬幅到訪影像,不要更改招牌或建築。
  • $restaurant-exterior-image-studio 審查這幅生成的店面影像與其真實來源的對比,並修復任何發明的細節。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

LucasH1225/restaurant-website-skills

Extract, interpret, record, and validate evidence-backed restaurant color systems for website demos. Use when Codex needs to inspect a storefront, sign, logo, menu, packaging, or interior photo for recurring brand colors; separate brand evidence from food, sky, foliage, lighting casts, asphalt, or camera noise; choose a harmonious palette combination; translate a real anchor color into accessible CSS design tokens; preview color roles; or hand a palette lock to restaurant-demo-builder. Do not use for generic color inspiration without restaurant evidence, logo redesign, image generation, layout selection, or blind extraction of the most frequent pixels.

LucasH1225/restaurant-website-skills

Research, position, design, build, and visually verify persuasive mobile-first website demos for independent restaurants with missing, broken, Facebook-only, outdated, or poor websites. Use when Codex is asked to analyze a restaurant lead, plan or create an outreach-ready restaurant website demo, turn Maps/Facebook/menu/review evidence into a tailored site, structure a clear mobile menu, coordinate evidence-backed food and storefront imagery, or integrate a restaurant-derived brand palette. Use restaurant-food-image-studio for food-image production, restaurant-exterior-image-studio for storefront-image production, and restaurant-brand-palette for photo-to-token color work. Do not use for generic restaurant directories, delivery marketplaces, or unverified production claims.

LucasH1225/restaurant-website-skills

Initialize, parallelize, resume, integrate, and validate evidence-gated restaurant website Demo work orders across restaurant-demo-builder, restaurant-brand-palette, restaurant-food-image-studio, and restaurant-exterior-image-studio. Use when Codex needs to start a new restaurant Demo from a lead, coordinate design/food/storefront subagents, run the complete multi-Skill workflow, continue interrupted work without repeating passed stages, inspect blockers or artifacts, or verify that a private Demo is ready for review. Do not use it to publish a site, contact a restaurant, bypass a specialist manifest, or generate unsupported food or storefront imagery.

LucasH1225/restaurant-website-skills

Collect, restage, harmonize, and verify evidence-backed food photography for independent restaurant website demos. Use when Codex needs to retrieve real restaurant dish photos through Apify Google Maps or Masa, turn mixed phone snapshots into one coherent customer-facing camera and lighting system, improve exposure or source-supported appetite cues, prevent visible AI artifacts, bind every designed image to a real served-dish source, or retain source-versus-output evidence and timing records. Do not use for text-only food generation, generic stock-food requests, full-menu illustration, or any realistic dish image that lacks a matching real restaurant photo.

相關技能