Communitygithub.com

登陸頁面審查技能

用於審查、稽核或評論登陸頁面,在宣告登陸頁面工作完成前,或當有人詢問頁面是否看起來像AI生成、套用模板或不專業時使用。

登陸頁面審查技能 是什麼?

此技能為AI代理提供了一套完整的登陸頁面審查流程,涵蓋靜態源碼分析、視覺呈現檢查、動態與3D效果測試,並根據嚴格的標準撰寫最終審查報告。它能自動偵測常見問題,如表單無法正常提交、未經證實的宣稱、CSS樣式衝突、缺少響應式設計等。支援從本地專案目錄、HTML檔案或已部署網址讀取頁面,並可搭配Python HTTP伺服器、Vite、Astro或Next.js等開發工具進行預覽。技能包含一個腳本工具,可掃描原始碼中的25種可疑模式,同時也要求代理手動檢查<head>標籤、表單行為、CTA連結、字體載入、以及對照需求文件驗證所有內容。最終輸出一個完整的審查結果,包含所有失敗與通過的項目,並附上證據,確保登陸頁面上線前達到專業品質。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-review

在你喜歡的 AI 中提問

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

說明文件

登陸頁面審查

您稽核登陸頁面並將評判結果寫入 landing/review.md。頁面可能來自 landing-skills 管線或任何其他地方。您會閱讀原始碼、檢視頁面在四種寬度下的渲染結果、測試任何存在的動畫與3D效果,並根據一套評分標準來評判一切。

看起來完成的頁面常常存在沒人仔細檢查過的破綻:一個表單拒絕所有潛在客戶卻感謝訪客、客戶從未提供的規格與承諾、當WebGL不可用時變為空白的3D頁面、在某個寬度下被其他規則抵消的區塊內距。擷取四種寬度但只看兩種的審查者,會遺漏只在某一種寬度才顯示的問題。您的工作是檢查所有項目,並且只報告您已確認的事實。

<skill-dir> 指的是包含此 SKILL.md 的目錄;腳本位於其 scripts/ 資料夾中。當技能是從外掛載入時,此檔案的路徑會在載入時提供給您;如果沒有,請使用 find ~ -path '*landing-review/scripts/detect-tells.mjs' 2>/dev/null 來找到它。從正在審查的專案目錄執行每個命令,腳本則使用其完整路徑。

輸入

您需要頁面,並使用任何存在的上下文。

  1. 頁面。一個專案目錄、單一HTML檔案或已部署的網址。找到進入點:index.html、src/pages/index.astro、src/App.jsx、app/page.tsx 或任何該技術棧使用的檔案。記錄技術棧;它決定了您在視覺檢查中如何提供頁面。
  2. landing/brief.md:產品、受眾、轉換動作、客戶提供的事實與證明、提供的資產、語言。這是您判斷頁面可能宣稱什麼的真相來源。
  3. landing/copy.md:已批准的文案。比對頁面與文案。
  4. landing/direction.md 和 landing/tokens.css:視覺方向及其理由,以及設計標記。當方向提供了針對客戶的特定理由時,看起來像預設值的選擇是可以接受的。

當檔案缺失時:

  • 無 brief。 在判斷宣稱前,先向使用者詢問四件事:產品是什麼、目標對象是誰、唯一轉換動作是什麼、以及哪些事實、數字、推薦與標誌是真實的。如果您無法詢問,則從頁面自身關於業務的陳述中擷取事實,並將所有推薦、客戶名稱、標誌、評級與指標視為未經證實:將每一項回報為阻止者,並附上修正「確認此項為真實且由客戶提供,否則刪除它」。未經證實的證明上線,其風險如同虛構的證明。
  • 無 copy.md 或 direction.md。 根據評分標準單獨審查文案與視覺效果。您將會失去說出「這與已批准的文案不同」的能力,除此之外不受影響。不要要求這些檔案。
  • 無 landing/ 資料夾。 在專案中建立 landing/ 和 landing/shots/;報告與螢幕截圖將放在那裡。
  • 頁面無法建構或無法提供服務。 在評分標準行B15下回報,包含錯誤訊息。如果無法以任何其他方式(已部署網址、先前的建構)取得渲染後的頁面,則視覺檢查無法執行,評判結果為 incomplete(請參閱評判結果)。

在開始檢查之前,請先閱讀 references/rubric.md。它包含每項檢查、通過的標準以及失敗時的嚴重性。在撰寫 landing/review.md 前,請閱讀 references/report-format.md。references/snippets.md 包含檢查會執行的腳本。

流程

按此順序執行檢查,然後撰寫報告:

  1. 靜態檢查:掃描原始碼,然後閱讀它。
  2. 視覺檢查:渲染頁面並觀察其在四種寬度下的外觀。
  3. 動畫與3D檢查:僅在頁面有動畫或3D場景時執行。
  4. 逐一執行 references/rubric.md 中的所有評分標準,按區域劃分:文案、美術指導、建構、動畫、上線準備。將工作檢查清單寫入 landing/review-checklist.md,每個行ID佔一行:fail 附上位置,pass 附上證據,或 n/a 附上理由。唯有當其證據是該行自己在「如何檢查」中規定的輸出時,才能算作通過:列表處要有列表,計數處要有計數,並且在涵蓋所有區塊時包含每個區塊、頁首和頁尾。僅憑記憶從頁面勾選的行不算已執行。在簡短的靜態頁面上,也要像複雜頁面一樣仔細閱讀文案與美術指導,並且即使一個阻止者已經很明顯,也要執行每一行:審查列出的是下一輪必須修復的所有項目,而不僅僅是決定評判結果的項目。
  5. 按照 references/report-format.md 的描述撰寫 landing/review.md:失敗項目放在表格中,通過項目及其證據放在「已檢查且無問題」區段下。然後執行此檔案末尾的自我檢查。

在進行過程中記錄筆記:對於每個發現,記錄您在哪裡看到它(檔案與行數,或寬度與區塊)以及您如何確認它。

靜態檢查

將掃描器指向頁面的原始碼路徑,而不是整個儲存庫:

node <skill-dir>/scripts/detect-tells.mjs index.html styles.css
node <skill-dir>/scripts/detect-tells.mjs src --json

它讀取的內容:您直接命名的任何檔案,無論其副檔名為何。在目錄中,它會讀取 .html、.htm、.css、.scss、.js、.jsx、.mjs、.ts、.tsx、.astro、.vue、.svelte、.md 和 .mdx 檔案,跳過 node_modules、.git、dist、build、.next、.astro、.output、.vercel 和 .wrangler 資料夾,並跳過任何超過 1 MB 的檔案。每一行都會根據 25 條規則進行檢查。發現結果會以 file:line [rule-id] 訊息 的格式輸出,後面跟著 fix: 行。退出碼 1 表示發現了問題,0 表示沒有發現問題,2 表示路徑或用法錯誤。--self-test 會檢查掃描器本身。

由於它會讀取 Markdown,因此也會報告筆記、報告、簡報和先前審查中引用的短語。忽略所有不在頁面原始碼中的檔案內的發現:landing/*.md、README、筆記、先前的 review.md 檔案。

將每個發現視為一個提示去查看,而不是一個評判結果。打開那一行,查看它實際包含的內容以及頁面用它做什麼,然後才做出決定。描述規則匹配的內容:對標籤顏色的色板匹配不是關於頁面背景的發現。以下是一些透過查看才能決定的例子:

  • 標誌連結上的 dead-anchor 是一個次要的建構錯誤。在主呼籲行動按鈕上,則意味著轉換無效:一個阻止者。
  • overused-font 表示一個常見字體主導了字型堆疊。只有當 direction.md 沒有給出理由且該字體沒有搭配一個獨特顯示字體或等寬字體時,這才算是一個發現。
  • palette-cream-terracotta 會觸發於兩個精確的十六進位值。單獨的奶油色永遠不是一個跡象;奶油色、陶土色強調色和時髦襯線字體的組合才是。

一次乾淨的掃描證明不了什麼。虛構的宣稱、沒有JavaScript就空白的頁面、過大的套件、以及連結到有效頁內ID但從未導向購買的呼籲行動,都不會在原始碼中留下模式。大多數失敗是缺失、計數、矛盾、構圖和異常行為,這些是逐行正規表達式無法看到的。一個頁面可能掃描乾淨,但在其他所有檢查中都失敗。

因此,在掃描之後,請您親自閱讀原始碼。需要透過閱讀來進行的檢查在 references/rubric.md 中標記為「source」。最常抓到的檢查包括:

  • <head>:標題、lang、中繼描述、網站圖示、Open Graph 標籤。
  • 每個表單:它提交到哪裡、處理器如何處理資料、以及成功訊息是否等待伺服器回應。
  • 每個呼籲行動 href:它實際指向哪裡。
  • 字體:每個 font-family 是由 @font-face、樣式表連結或框架字體導入載入的,還是僅為系統字型堆疊?
  • 頁面上的每個宣稱、數字、名稱、規格和承諾,與簡報進行比對。簡報中說已提供的每個資產,與頁面顯示的內容進行比對。
  • 自我抵消的CSS,例如一個容器類別的 padding 簡寫屬性比區塊規則更為具體,並靜默地將該區塊的垂直內距重置為零。在瀏覽器中透過讀取計算後的內距來確認。
  • prefers-reduced-motion:存在與否,以及它的作用。
  • 建構後HTML的 body:如果它是一個空的 <div id="root"> 且沒有 <noscript>,則該頁面在沒有JavaScript的情況下是空白的。

視覺檢查

您需要一個渲染後的頁面。掃描器和原始碼無法向您顯示重疊、佈局的空半邊、換行的標題、崩潰的間距或位於3D場景頂部的文字。

提供頁面服務

始終透過HTTP進行審查,即使是純HTML。多項檢查需要伺服器:根目錄相對路徑(/styles.css、/assets/...)在 file:// 協議下會失敗,而評分標準行L7會請求一個不存在路徑、/robots.txt 和 /sitemap.xml。如果缺少 node_modules,請先安裝依賴項。

  • 已部署網址: 直接使用它。
  • 純HTML和CSS: 在包含 index.html 的資料夾中,執行 python3 -m http.server 8000 並開啟 http://localhost:8000/。
  • Vite: npm run build,然後 npx vite preview(預設連接埠 4173)。
  • Astro: npm run build,然後 npx astro preview(預設連接埠 4321)。
  • Next.js: npm run build,然後 npm run start(預設連接埠 3000)。
  • 任何其他建構: 建構它,然後在輸出資料夾中執行相同的 python3 -m http.server 命令。

將您審查的網址寫在「檢查」下方。僅在萬不得已且無法提供服務時,才開啟 file:// 路徑;屆時L7將不會執行,並且任何使用根目錄相對路徑的資產可能因此原因而缺失。在「檢查」下方同時列出兩者,並且不要報告伺服器本來可以找到的缺失資產。

僅在現有建構輸出與原始碼同步時審查它。find src index.html -newer dist/index.html(使用該技術棧的原始碼和輸出路徑)會列出自建構以來已更改的原始碼檔案;如果有列出任何檔案,或者沒有建構輸出,請重新建構。在「檢查」下方說明您審查了哪一個以及原因。

選擇擷取方法,按此順序

  1. 瀏覽器工具,如果環境中有可用的。您需要這些功能:導航到網址、設定檢視區寬度、拍攝全頁螢幕截圖、在頁面中執行腳本、以及模擬媒體功能(色彩模式、減少動畫)和關閉 JavaScript。

  2. 備用腳本,當沒有瀏覽器工具或工具無法擷取時使用。即使有人告訴您沒有瀏覽器可用,也請執行它:它會透過 npx 啟動自己的瀏覽器,可能仍然可以工作。

    node <skill-dir>/scripts/screenshot.mjs <url-or-file> landing/shots
    node <skill-dir>/scripts/screenshot.mjs <url-or-file> landing/shots --dark
    

    它會寫入 360.png、768.png、1280.png 和 1440.png(如果使用 --dark,則為 360-dark.png 等),全頁,在等待 1.5 秒後,並列印每個檔案路徑。如果它失敗並顯示「Executable doesn't exist」,請執行 npx playwright install chromium 並重試。當它以非零碼退出、列印 capture failed at <width>px 或沒有寫入任何圖片時,即表示失敗。

  3. 兩者都無法使用。 只有這時視覺檢查才沒有執行。無論如何,請執行靜態檢查和原始碼閱讀,然後遵循 incomplete 的評判結果規則。

備用腳本無法在頁面中執行腳本、模擬減少動畫、關閉JavaScript或WebGL、或滾動。使用它時,請從圖片中判斷您能判斷的內容,透過閱讀原始碼檢查減少動畫、JavaScript關閉和WebGL關閉,並在「檢查」下方列出每個您無法即時執行的檢查及其原因。

擷取所有四種寬度

對於每種寬度,360、768、1280 和 1440(高度800也可以):

  1. 設定寬度,載入頁面,等待字體和圖片。
  2. 使用 references/snippets.md 中的檢視區檢查來確認實際寬度。某些工具不會將視窗縮小到低於某個最小值,並會靜默地給您一個更寬的頁面;請改用該工具的裝置或檢視區模擬功能,並再次檢查。
  3. 將全頁螢幕截圖拍攝到 landing/shots/。
  4. 執行 references/snippets.md 中的測量腳本並閱讀其注意事項:溢位、比檢視區更寬的元素、版面位移、Canvas 計數。
  5. 在即時瀏覽器中滾動頁面,從上到下。

然後開啟並閱讀每張圖片:所有四種寬度,以及您拍攝的深色圖片。在繼續之前,為每種寬度在筆記中寫一行您看到的內容。只看兩種寬度而假設其他寬度沒問題,正是導致僅在某些寬度顯示的失敗被遺漏的原因:一個窄區塊在寬寬度下留下一半的空行,或者區塊連結沒有選單僅在最窄寬度下隱藏。

如果全頁擷取失敗或回傳的圖片被截斷(這在帶有 Canvas 的高頁面上可能發生),請改為在頂部和幾個滾動位置(四分之一、一半、四分之三、底部)擷取檢視區,並在「檢查」下方說明。備用腳本只會進行全頁擷取;如果它以這種方式失敗,請記錄哪些寬度缺失。

對於滾動驅動頁面的全頁擷取,可能會在捲軸位置為零時,顯示視差或黏性區塊位於畫面外而產生的空白帶。在報告空白區域之前,請在即時頁面中滾動到該位置。如果在該位置渲染正常,則為擷取偽影,而非缺陷。

查看的項目

在每種寬度下,打開評分標準:

  • 水平滾動、文字被裁剪、元素重疊、文字位於圖片或 canvas 頂部導致難以閱讀。
  • 間距:沒有垂直內距的區塊、與上方區塊緊貼的標題、突出到內容之外的邊框。
  • 構圖:在 1280 和 1440 下的半空行、換行到四行或在最後一行留下一個單詞的標題、在 360 下換行的眉毛文字/標籤/按鈕、高度不一致的卡片。
  • 在 360 下的導覽:區塊連結是否仍然可達、按鈕是否至少 44x44 像素、固定頁首是否遮擋了標題?
  • 在 360 下的順序:產品是否在表單上方可見,還是被推到了下方?
  • 圖片:是真實資產,還是為尚不存在的資產,以正確長寬比標記的佔位符?
  • 鍵盤:在 1280 下用 Tab 鍵瀏覽頁面一次。焦點必須...

Individual skills in this repo

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

相關技能