Communitygithub.com

homepage-maker

引導 AI 代理像設計師一樣,透過研究真實網站、記錄靈感來源,並確保不遺漏在地商家必備資訊,來產出具體的落地頁、首頁或作品集。

homepage-maker 是什麼?

homepage-maker 是一個專為 AI 代理(如 Claude Code、Cursor、Codex)設計的技能,用於產出高品質的在地商家首頁、登陸頁或作品集,避免常見的「AI 感」設計(如置中標題、紫色漸層、三張卡片)。其核心流程分為「前置研究」→「程序」→「規則」三階段:代理需先完成客戶基本資訊、競爭分析等研究,再依序執行 `init`、`ref`、`board`、`copy`、`check`、`shots` 及 `deploy` 等指令。技能強制要求每個區塊標註靈感來源 (`data-ref`),並透過多道關卡(事實驗證、法規合規、行動裝置響應、對比度、韓文排版、AI 文案評分等)確保輸出品質。支援 Vercel 部署,並針對韓國在地商家提供 Naver 地圖、JSON-LD、原產地標示等專用區塊。與 Muzli MCP 相比,homepage-maker 更強調來源透明、強制檢驗及在地化,但缺乏個人化收藏功能。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/min9lin9/min9maker-homepage/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

homepage-maker 是做什麼的?

AI 代理的目標是避免做出充滿「AI 感」的頁面(置中標題、紫色漸層、三張卡片),而是像設計師一樣:先研究實際優秀的網站、明確記錄從何處借鑑了什麼、確保店家首頁不漏掉任何必要資訊。渲染與檢查由 scripts/homepage.mjs 執行。

SK=.claude/skills/homepage-maker/scripts/homepage.mjs
node $SK init sites/<slug>
node $SK ref sites/<slug> <url> --note "從這個網站借鑑的一個技巧"
node $SK board sites/<slug>
node $SK copy sites/<slug>
node $SK check sites/<slug> [--draft]
node $SK shots sites/<slug> --compare <ref1>,<ref2>
node $SK deploy sites/<slug> [--prod]

初次安裝:在技能資料夾中執行 npm install && npx playwright install chromium(詳見 README 的安裝步驟)。所有指令需在專案根目錄執行。文案 AI 感分數僅在專案中安裝了 humanize-korean 且位於 .claude/skills/humanize-korean/ 時才啟用(若在其他位置,請設定環境變數 HUMANIZE_KOREAN_ROOT)。

前置研究

此技能是根據研究結果來建立頁面。您只需要自行收集設計參考資料,其餘研究應在開始前完成。各項目的說明、用途及缺失的影響請參考 references/prerequisites.md。

時機必要的研究項目
簡報前客戶基本資訊(地址、電話、營業時間、停車、預約、菜單、價格、產地)、訪客情境(誰在何種情況下進入網站)、該行業的廣告法規
提出三個方向前競爭對手與替代管道現況(評論、介紹文、是否有官網)、品牌定義
文案定稿前關鍵字與搜尋曝光
部署前網域與主機註冊人資訊、必要免責聲明(如有預約或諮詢表單時)

未確認的資訊應在 facts.md 中標記為「待確認」,check 指令會阻止其顯示於頁面。

程序

⛔ 標記的步驟需經人工核准才能繼續。

  1. init — 使用上表確認前置研究已完成後,在 sites/<slug> 中建立 brief.md、facts.md、refs.md、site/ 及 refs/。
  2. 簡報 — 將網站目的設定為訪客的一個主要行動(例如:導航、預約、來電)。記錄訪客在何種情境下進入網站(例如:週末開車來的客人在出發前用手機查詢)。
  3. 事實表 — 記錄地址、電話、營業時間、公休日、停車、預約連結、Naver 地圖連結、菜單、價格、產地,並附上來源。未經確認的資訊標記為「待確認」,不可用於頁面。若頁面中出現 facts.md 未記錄的數字,check 將會失敗。
  4. 尋找參考 — 從 references/sources.md 中的來源中,至少挑選三個網站,從中找出 8 到 12 個候選。不要只看同業,而應參考解決了相同問題(例如:展示菜單、告知位置、呈現流程)的優秀網站。
  5. 截圖與記錄 — 使用 ref 指令截取所選的 5 到 8 個網站。桌面與行動裝置截圖、字型、字體大小、顏色、內容寬度、動態效果等資訊會儲存在 refs/<slug>/ 中,並記錄於 refs.md。為每個參考網站記錄一行「從中借鑑的技巧」。不得直接複製版面、照片或文案。方法請參考 references/moves.md。
  6. ⛔ 提出三個方向 — 使用 board 指令產生 out/board.png 與共用資料夾 out/board/(搜尋引擎排除、noindex,每張卡片包含原始網站連結、借鑑的技巧、使用的區塊)。提出三個從不同參考網站出發的設計方向。每個方向需說明借鑑了哪些參考網站的什麼元素,在人類選定一個方向前,不得開始製作。
  7. 逐區塊製作 — 以區塊為單位製作 site/index.html(與 site/ 中的 CSS 和圖片)。每個 <section> 必須加上 data-ref="<refs 資料夾名稱>" 以標明來源。製作某區塊前,應重新觀看該參考網站對應的區塊。韓國在地商家必備區塊請參考 references/korea-local.md。
  8. 文案潤飾 — 使用 copy 指令將頁面上顯示的文案以區塊為單位提取出來,儲存至 sites/<slug>/_workspace/<日期>-NNN-<tag>/01_input.txt(圖片來源、授權行及 data-copy-skip 區域會排除)。若專案中有 humanize-korean (epoko77-ai/im-not-ai),同一指令會顯示路徑(light/standard/heavy)與風險等級。將該執行資料夾以 humanize-korean 技能潤飾,產出 final.md 並通過 verify_gates.py 後,僅將變更的句子移回 site/。不得修改數字、專有名詞或引用。若無此工具,此步驟僅止於文案提取。
  9. check — 持續修正直至失敗(✗)數歸零。開發期間可使用 --draft 將失敗降為警告,但交付與部署時不得使用 --draft 且必須通過。
  10. 肉眼比對 — 使用 shots --compare 產生 out/compare.png,將成品與所選的參考網站並排檢視。同時開啟 out/site-mobile.png。檢查重點:第一眼是否能看出這是一家什麼店、位於何處;從參考網站借鑑的技巧是否實際發揮作用;頁面是否看起來像樣板。如需修正,回到步驟 7。
  11. ⛔ 核准 — 使用 compare.png、site-mobile.png 及 out/report.json 進行核准。
  12. 部署 — deploy 指令僅在 check 通過後,才會將網站部署至 Vercel。首次部署會以資料夾名稱(sites/<slug> 中的 slug)連接 Vercel 專案。Vercel 會將新專案的首次部署自動設為 production 環境(<slug>.vercel.app),因此若包含暫用資訊,需在頁面頂端加入「暫用資訊」提示。第二次起會產生預覽網址,--prod 僅在核准後使用。自訂網域連線亦需在核准後進行。

規則

  • 參考來源僅限 references/sources.md 中的允許清單。對於 robots.txt 封鎖 Claude 代理的網站(如 Godly、GDWEB),ref 指令會拒絕。請人類直接瀏覽並留下筆記。
  • 參考網站截圖僅供分析用途。refs/ 不會上傳至儲存庫(已加入 .gitignore),且不得在網站中使用參考網站的圖片、文案或 Logo。
  • 交付的圖片僅限店家自行拍攝的照片。不得使用 AI 生成的食物圖片或合成人物。草稿階段可使用授權明確的佔位圖片(如 CC 授權),但需在頁面上標示「佔位」及圖片來源,並於 facts.md 中記錄來源行。
  • 使用未確認資訊製作草稿時,需在 facts.md 中標記為暫用,並在頁面頂端加上「暫用資訊」提示。電話號碼只能使用非實際號碼(例如 031-000-0000)。
  • 宣稱性用語(首創、最大、唯一、始祖、第 N 名)需有 facts.md 中的依據。若列出菜單與價格,必須標示原產地(依原產地標示法)。與 carousel-maker 規則相同。
  • 圖片每張目標小於 500KB(建議使用 WebP/AVIF),全站總和小於 3MB。

檢查關卡

關卡失敗條件
refs已記錄「借鑑技巧」的參考網站少於 3 個
attribution存在無 data-ref 的區塊,或指向 refs/ 中不存在的參考網站
fact頁面中的數字未記錄於 facts.md
placeholder存在 [...]、【...】、lorem、TODO 等殘留
claim · origin無依據的宣稱性用語,或列出肉類菜單與價格但無原產地行
localLocalBusiness/Restaurant JSON-LD、tel: 連結、Naver/Kakao 地圖連結、營業時間中缺少任一項
meta缺少 og:title、og:image、lang="ko"、viewport
koreanbody 中無 word-break: keep-all
a11y · contrast圖片無 alt 屬性、未達 WCAG AA 對比度
mobile390px 寬度下出現水平滾動、內文小於 16px(按鈕小於 44px 為警告)
template · weight紫色漸層、制式文案、圖片過大(警告)
copy-stylehumanize-korean 分數非 low 風險、路徑非 light、連接語尾後逗號 z>3、'A 不是 B' 句型出現超過 2 次(警告)。若無此工具則跳過 (i)

與 Muzli MCP 比較

項目Muzli MCPhomepage-maker
參考來源Muzli 編輯策展(單一來源)Muzli 公開收藏 + SiteInspire、Land-book、Lapa Ninja、One Page Love、Awwwards
來源標示透過對話口頭說明每個區塊強制加上 data-ref,遺漏即失敗
參考分析圖片與文字說明桌面與行動裝置截圖 + 字型、字體大小、顏色、寬度 token
結果檢驗無事實、法規、在地商家資訊、行動裝置、對比度、韓文關卡 + 文案 AI 感評分 (humanize-korean)
視覺審查無與參考網站並排產出比較圖
部署muzli.space(搜尋不曝光、無表單功能、10 個限制)Vercel(搜尋曝光、可連接自訂網域)
韓國在地化無Naver 地圖與預約、JSON-LD、原產地、韓文換行
Muzli 的優勢基於 90 萬設計師收藏的策展,可利用個人收藏僅使用公開網站,缺乏個人化功能

相關技能