Communitygithub.com

網站精修導演 — 五關上線前出貨

上線前對任意網站做結構化五關精修審計——視覺打磨、技術底座、UX 完整度、內容品質、跨裝置就緒,百分制打分。

網站精修導演 — 五關上線前出貨 是什麼?

Landing Pages 配方第 3 步(精修/出貨):skills-website-finishing-director。CRO 工藝與電影感搭建之後,給視覺/技術/UX/內容/裝置就緒打分,放行落地頁上線。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cody-W-Tucker/skills/tree/HEAD/skills/website-finishing-director

在你喜歡的 AI 中提問

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

說明文件

網站完工總監

結構化的 5 階段網站完工審查 — 從第一印象到上線就緒 — 以 100 分評分。就像繪畫:底漆、底色層、細節、清漆、最終檢查。沒有網站能在未經完工審查的情況下上線。

何時使用此技能

  • 上線前關卡 — 在 DNS 生效或流量導入前的最終驗證
  • 重新設計後審查 — 在視覺改造後,確認沒有回歸問題
  • 客戶交接 — 生成結構化報告,證明網站符合品質標準
  • 季度維護 — 發現累積的 UX 技術債、失效連結、過時內容
  • 針對性審查 — 僅執行單一階段(例如:效能衝刺後僅執行「第二階段」)

方法論基礎

來源:

  • Nielsen Norman Group — 啟發式評估框架(10 項可用性啟發式)
  • Google Web Vitals — LCP、CLS、INP 門檻值
  • OWASP — 安全標頭基準
  • Oli Gardner / Unbounce — 登陸頁面轉換最佳實踐
  • Don Norman — 情感設計(本能/行為/反思層面)
  • GUIA 製作經驗 — 8 個已上線網站,記錄了 Next.js、Framer Motion、GSAP、Lenis、Railway、Docker 的常見問題

核心原則:一個通過 Lighthouse 並擁有正確 meta 標籤的網站在技術上有效,但並不完成。完成是「它能運作」與「它準備好了」之間的差距。它需要像訪客體驗網站那樣來評估 — 漸進的、情感化的、跨裝置的 — 而不是一系列個別指標的檢查清單。

為何重要:現有工具(Lighthouse、Screaming Frog、Awwwards)各自僅審查一個面向。沒有任何工具能將視覺打磨 + UX 完整性 + 技術基礎 + 內容品質 + 品牌一致性,在一個序列化、有評分的流程中結合起來。此技能就是那個工具。


Claude 負責 vs 您決定的事項

「Claude 執行審查。您決定什麼可以上線。」

Claude 負責您提供
根據檢查清單系統化執行每個階段即時 URL 或程式碼庫存取權限
為每個檢查點評分並附上理由情境:品牌定位、目標受眾、上線時程
將問題分類為 P0/P1/P2覆寫決策(例如:「P1 在 MVP 階段可接受」)
生成最終報告,包含修復建議最終的 Go/No-Go 判斷
根據製作經驗標記 GUIA 技術棧的常見問題在真實裝置上驗證(Claude 無法開啟 Safari)

請記住:這是一個人機協作的工作流程。Claude 嚴謹地建構審查;您則在真實裝置上以人眼驗證裁決。


此技能的功用

  1. 5 秒第一印象測試 — 評估最初幾秒內的清晰度、情感契合度及 CTA 可見性
  2. 技術基礎審查 — 效能(Core Web Vitals)、SEO 基礎、安全標頭、失效連結
  3. UX 完整性檢查 — 元件狀態、表單行為、動畫打磨、行動裝置可用性
  4. 內容與品牌驗證 — 文案品質、佔位符檢測、語氣一致性、視覺一致性
  5. 跨裝置與上線就緒 — 瀏覽器測試、OG 預覽、分析工具、404 頁面、Favicon

使用方法

上線前的完整網站審查

我即將上線 [網站 URL]。執行完整的 website-finishing-director 審查(全部 5 個階段)。
品牌象限:[溫暖+平靜 / 溫暖+活躍 / 冷靜+活躍 / 冷靜+平靜]。
目標受眾:[誰]。

特定修復後的單一階段審查

我剛剛針對 [網站 URL] 進行了效能最佳化。僅執行第二階段(技術基礎)。

登陸頁面快速審查

審查此登陸頁面:[URL]。使用「登陸頁面」設定檔(階段 1、2、4)。

指示

執行此審查時,請依序遵循 5 個階段。每個階段建立在先前階段的基礎上 — 先打地基再打磨。為每個檢查點評分,依優先順序分類問題,然後生成最終報告。

審查設定檔

並非每個網站都需要全部 5 個階段。選擇與專案相符的設定檔:

設定檔階段使用時機
登陸頁面1、2、4單頁活動或產品頁面
完整網站1、2、3、4、5包含導覽、表單、內容的多頁網站
電子商務2、3、5包含購物車、結帳、產品頁面的商店

使用縮減設定檔時,請按比例調整點數總和。Go/No-Go 門檻適用於百分比分數,而非原始點數。


第一階段:第一印象(15 分)

「訪客在 5 秒內理解並感受到什麼?」

展示首頁(或英雄區塊)5 秒鐘。回答以下 5 個問題 — 每個 3 分:

## 第一階段 — 第一印象(5 秒測試)

### 1. 這是什麼?(3 分)
訪客能否識別這個網站/產品/服務是什麼?
[ ] 3 — 立即清晰,無歧義
[ ] 2 — 閱讀副標題後清楚
[ ] 1 — 模糊,需要滾動才能理解
[ ] 0 — 完全不知道這是什麼

### 2. 這是給誰的?(3 分)
是否有信號識別目標受眾?
[ ] 3 — 明顯的人口統計/心理特徵信號
[ ] 2 — 隱含但未明確
[ ] 1 — 通用(「所有人」)
[ ] 0 — 令人困惑(信號指向錯誤受眾)

### 3. 我為什麼要在意?(3 分)
價值主張或效益是否可見?
[ ] 3 — 清楚效益,情感共鳴
[ ] 2 — 著重功能但可理解
[ ] 1 — 存在但被埋沒
[ ] 0 — 看不到價值主張

### 4. 我下一步要做什麼?(3 分)
主要的 CTA 是否可見且清晰?
[ ] 3 — CTA 在摺頁上方可見,動作特定文字
[ ] 2 — CTA 存在但通用(「了解更多」)
[ ] 1 — CTA 在摺頁下方或難以找到
[ ] 0 — 看不到 CTA

### 5. 感覺如何?(3 分)
情感基調是否與品牌象限相符?
[ ] 3 — 完美象限匹配(溫暖品牌 = 溫暖設計)
[ ] 2 — 大致相符,輕微不一致
[ ] 1 — 明顯不匹配(溫暖品牌 + 冷感設計)
[ ] 0 — 相反象限(定位混淆)

### 第一階段分數:___/15

裁決:
- 12-15:通過 — 第一印象清晰且情感一致
- 8-11:需要改進 — 訪客能理解,但緩慢或有摩擦
- <8:失敗 — 重新設計摺頁上方體驗

整合:將情感感受與 web-design-director 象限系統進行比較。如果品牌是溫暖+平靜,但網站感覺冷靜+活躍,無論分數如何,這都是 P0。

此階段的 GUIA 常見問題:

  • Calendly URL 在 CTA 中寫死而非使用 /contact/ 頁面(破壞分析工具)
  • 混合溫暖文案語氣與冷感 UI 元素(陶土色調 + 等寬字體 = 混淆)

第二階段:技術基礎(25 分)

「基礎設施是否足夠穩固以進行建構?」

## 第二階段 — 技術基礎

### 效能(10 分)

| 指標 | 目標 | 分數 |
|--------|--------|-------|
| LCP(最大內容繪製) | ≤ 2.5 秒 | 0-3 分 |
| INP(下次繪製互動) | ≤ 200 毫秒 | 0-2 分 |
| CLS(累計版面配置位移) | ≤ 0.1 | 0-2 分 |
| Lighthouse 效能分數 | ≥ 85 | 0-3 分 |

計分:
- LCP:3 = ≤2.5 秒,2 = ≤4.0 秒,1 = ≤6.0 秒,0 = >6.0 秒
- INP:2 = ≤200 毫秒,1 = ≤500 毫秒,0 = >500 毫秒
- CLS:2 = ≤0.1,1 = ≤0.25,0 = >0.25
- Lighthouse:3 = ≥90,2 = ≥85,1 = ≥70,0 = <70

### SEO 基礎(8 分)

- [ ](2 分)已定義標準網址且結尾斜線一致
- [ ](1 分)每個頁面有獨特的 Meta 標題(≤60 字元)
- [ ](1 分)每個頁面有 Meta 描述(≤160 字元)
- [ ](1 分)Sitemap.xml 可存取且有效
- [ ](1 分)robots.txt 存在且正確
- [ ](1 分)存在結構化資料(JSON-LD)
- [ ](1 分)所有圖片都有替代文字

### 安全性與連結(7 分)

- [ ](2 分)強制使用 HTTPS(無混合內容)
- [ ](2 分)存在安全標頭(CSP、X-Frame-Options、HSTS、X-Content-Type-Options)
- [ ](1 分)無內部失效連結(404)
- [ ](1 分)無外部失效連結
- [ ](1 分)正式環境中無暴露的 Source Map 或除錯端點

### 第二階段分數:___/25

裁決:
- 21-25:穩固 — 可以上線
- 16-20:可接受 — 修復 P0,以 P1 待辦事項上線
- 11-15:脆弱 — 顯著技術債
- <11:損壞 — 請勿啟動

此階段的 GUIA 常見問題:

  • next.config.js 中缺少 trailingSlash: true(導致 Rental-CRM 於 2026 年 1 月被移除索引)
  • 在 'use client' 元件上使用 export const metadata(中繼資料未在伺服器端渲染)
  • 模組層級的 SDK 初始化(Supabase/Stripe)在環境變數缺失時在建置時失敗 — 應在函式內部延遲初始化
  • Vercel 環境變數因 echo 而含有結尾換行 — 改用 printf
  • Railway 的 *.railway.internal 主機名稱在 Nixpacks 建置期間無法連線 — 改用公開 URL

第三階段:UX 完整性(25 分)

「網站是否能處理真實世界的使用情況,而不僅僅是順利路徑?」

## 第三階段 — UX 完整性

### 元件狀態(8 分)

對於每個互動式元件(按鈕、卡片、表單、模態框、清單):
- [ ](2 分)載入狀態 — 骨架、旋轉圖示或漸進式渲染
- [ ](2 分)錯誤狀態 — 清楚訊息 + 復原動作
- [ ](2 分)空狀態 — 有幫助的訊息,而非空白畫面
- [ ](2 分)成功狀態 — 確認回饋

計分:根據所有元件中缺失的狀態扣分。
8 分 = 所有狀態都已涵蓋。每個缺失的狀態扣 1 分(最低 0 分)。

### 表單(6 分)

- [ ](1 分)客戶端驗證,附有清楚的錯誤訊息
- [ ](1 分)伺服器端驗證(不僅僅是客戶端)
- [ ](1 分)提交後的成功回饋(Toast、重新導向或行內)
- [ ](1 分)提交按鈕在處理期間停用(無重複提交)
- [ ](1 分)垃圾郵件保護(蜜罐、reCAPTCHA 或速率限制)
- [ ](1 分)表單附近的隱私權政策連結(GDPR)

### 動畫打磨(6 分)

- [ ](1 分)在滾動動畫上使用 `viewport={{ once: true }}`(回滾時不重播)
- [ ](1 分)對 GSAP 動畫使用 `useGSAP` hook(而非 `useEffect`)
- [ ](1 分)尊重 `prefers-reduced-motion`(停用或減少動畫)
- [ ](1 分)無動畫阻擋內容存取(即使動畫失敗,內容仍可見)
- [ ](1 分)Lenis 正確初始化(非 Locomotive Scroll)
- [ ](1 分)退出動畫不會導致版面配置位移

### 行動裝置可用性(5 分)

- [ ](1 分)觸控目標 ≥ 44px(iOS HIG 標準)
- [ ](1 分)無水平溢出 / 水平滾動
- [ ](1 分)正文字體大小 ≥ 16px(防止 iOS 縮放)
- [ ](1 分)固定/黏性元素不重疊內容
- [ ](1 分)滾動行為正確運作(無劫持使用者滾動)

### 第三階段分數:___/25

裁決:
- 21-25:完整 — 涵蓋真實世界使用情況
- 16-20:大部分完成 — 邊緣案例需關注
- 11-15:不完整 — 使用者會遇到障礙
- <11:未完成 — UX 未達生產就緒

此階段的 GUIA 常見問題:

  • GSAP + React 18 Strict Mode 在開發環境中會觸發動畫 2 次(使用 useGSAP,而非 useEffect)
  • 全域 CSS a { color: var(--color-coral) } 會覆蓋錨點 CTA 上的 Tailwind text-white — 改用行內 style={{ color: 'white' }}
  • Framer Motion 的 AnimatePresence 退出動畫會與 Next.js App Router 衝突
  • 同時太多的 ScrollTrigger 實例會影響行動裝置效能
  • Lenis 套件名稱:npm install lenis(非 @studio-freight/lenis)

第四階段:內容與品牌(20 分)

「內容是否完成、一致且符合品牌?」

## 第四階段 — 內容與品牌

### 文案品質(8 分)

- [ ](2 分)未檢測到佔位符文字(「Lorem ipsum」、「[Your Name]」、「Coming soon」、
      「example.com」、「TODO」、空白區塊)
- [ ](1 分)無拼字或文法錯誤
- [ ](1 分)連結文字有描述性(非「點擊這裡」或裸 URL)
- [ ](1 分)CTA 文案具體(「開始免費試用」而非「提交」)
- [ ](1 分)標題層級合乎邏輯(H1 → H2 → H3,每頁一個 H1)
- [ ](1 分)替代文字有描述性(非「image1.png」或空白)
- [ ](1 分)電話號碼、電子郵件、地址是真實的(非佔位符)

### 品牌語氣(6 分)

- [ ](2 分)語氣符合品牌定位(溫暖/冷靜,正式/休閒)
- [ ](2 分)語氣在所有頁面一致(同一個「人」在說話)
- [ ](1 分)無 AI 平滑化標記(「請不要猶豫與我們聯繫」、
      「在當今快節奏的世界中」、「值得注意的是」)
- [ ](1 分)CTA 符合情感象限(溫暖品牌 = 邀請式 CTA,非激進式)

### 視覺一致性(6 分)

- [ ](1 分)色彩調色盤一致使用(無非品牌顏色)
- [ ](1 分)字型層級清晰(顯示、標題、正文、說明 — 最多 2-3 種字型)
- [ ](1 分)間距節奏一致(非區塊間隨機內邊距)
- [ ](1 分)圖示風格統一(不混合使用輪廓、填滿和表情符號)
- [ ](1 分)圖片處理一致(所有照片使用相同濾鏡/色調,或全是插圖)
- [ ](1 分)元件風格一致(卡片、按鈕、輸入框遵循相同模式)

### 第四階段分數:___/20

裁決:
- 17-20:精緻 — 內容已完成且符合品牌
- 13-16:良好 — 輕微不一致,可上線
- 9-12:粗糙 — 內容需要編輯
- <9:未完成 — 重大內容缺口或品牌不符

此階段的 GUIA 常見問題:

  • Calendly URL 必須與正確的專業人員相符(Valeria vs Matthieu vs 客戶)
  • 混合溫暖文案(「我們理解您的挑戰」)與冷感 UI(深色模式、等寬字體、銳角)
  • AI 生成文案檢測:發布前移除雙換行(LinkedIn 上的 AI 簽名)
  • credou.bzh 文案方向:機制優先,無 CV,無經歷/時間軸

第五階段:跨裝置與上線(15 分)

「是否在所有地方都能運作,且一切準備好上線?」

## 第五階段 — 跨裝置與上線

### 瀏覽器測試(5 分)

在 3 個主要瀏覽器上測試。每個瀏覽器計分:
- [ ](2 分)Safari — 正確渲染,動畫運作,字型載入
- [ ](2 分)Chrome — 正確渲染,動畫運作,字型載入
- [ ](1 分)Firefox — 正確渲染,無重大問題

每個瀏覽器檢查:版面配置、動畫、字型、表單、滾動行為。
每個有視覺錯誤的瀏覽器扣 1 分。每個有功能錯誤的瀏覽器扣 2 分。

### 裝置測試(4 分)

- [ ](2 分)行動裝置(375px)— 完整網站於使用者可達……”*(由於內容截斷,此處未能完全轉譯)*


其餘內容因原始輸入截斷而無法完整轉譯。

Individual skills in this repo

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

Cody-W-Tucker/skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says landing page, post-click experience, landing page audit, conversion rate, or landing page optimization.

Cody-W-Tucker/skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 28 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says TikTok Ads, TikTok marketing, TikTok Shop, Spark Ads, Smart+, or TikTok campaign.

Cody-W-Tucker/skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, Demand Gen, and Connected TV formats. Covers VAC→Demand Gen migration, Shorts creative requirements, and CTV shoppable ads. Use when user says YouTube Ads, video ads, pre-roll, bumper ads, YouTube campaign, Shorts ads, or CTV ads.

Cody-W-Tucker/skills

Craft the story that makes investors say \"I want in.\" Master the narrative structure that Reid Hoffman, Sequoia, and top founders use to raise capital. Use when: **Preparing to fundraise** to develop your story before the deck; **Investor meetings** to structure conversations that convert; **Pitch practice** to refine your narrative arc; **Cold outreach** to write compelling investor emails; **Pivoting** to reframe your story after a change

Cody-W-Tucker/skills

Identify the best GTM motions and tools across 7 motion types: Inbound, Outbound, Paid Digital, Community, Partners, ABM, and PLG. Use when selecting marketing channels, choosing between inbound and outbound strategy, or planning cross-channel campaigns.

Cody-W-Tucker/skills

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

Cody-W-Tucker/skills

Optimize landing pages for maximum conversions using proven frameworks from Unbounce and Oli Gardner—apply the \"one goal, one message, one action\" principle with data-driven design, copy, and CTA best practices. Use when: **Create a new landing page** for a campaign; **Optimize an existing landing page** that isn't converting; **Review landing page design** before launch; **Improve form conversion rates** on lead gen pages; **A/B test landing page elements** systematically

Cody-W-Tucker/skills

Advanced motion patterns for React / Next.js — drag & drop, gestures, text animations, SVG path drawing, custom hooks, imperative sequences (useAnimate), loaders, and the full API decision tree. Requires motion-foundations.

Cody-W-Tucker/skills

Motion tokens, spring presets, performance rules, device adaptation, accessibility enforcement, and SSR safety for React / Next.js using motion/react. Foundation layer — all other motion skills depend on this.

Cody-W-Tucker/skills

A single-frame motion-design composition with looping CSS animations — rotating type ring, animated globe, ticking timer, parallax labels. Renders as a hero video poster you can hand straight to HyperFrames or any keyframe-based exporter. Use when the brief asks for "motion design", "animated hero", "loop", "video poster", "title card", or pairs Open Claude Design with HyperFrames for a kinetic export.

Cody-W-Tucker/skills

Production-ready animation patterns for React / Next.js — button, modal, toast, stagger, page transitions, exit animations, scroll, and layout — built on motion-foundations tokens and springs.

Cody-W-Tucker/skills

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

Cody-W-Tucker/skills

Produce a single-file slide deck in the Atelier Zero visual language (warm-paper background, italic-serif emphasis spans, coral terminating dots, surreal collage plates) — Open Design's brand deck recipe. The deck uses **horizontal magazine-style swipe pagination** (←/→, wheel, swipe), a per-slide chrome strip with brand mark and slide counter, an ESC overview grid, a coral progress bar, and inherits the canonical stylesheet + 16-slot image library from the sister `open-design-landing` skill.

Cody-W-Tucker/skills

Produce a world-class single-page editorial landing site in the Atelier Zero visual language (Monocle / Apartamento / Études editorial collage) — the same aesthetic Open Design uses for its own marketing surface. The agent fills a typed `inputs.json` from a brand brief, optionally generates 16 collage assets via gpt-image-2, then runs a pure-function composer that emits a self-contained HTML file; a separate path can mirror the Astro marketing site in `apps/landing-page/`. Drop-in scroll-reveal motion and a Headroom-style sticky nav are wired automatically.

Cody-W-Tucker/skills

Best practices for Remotion - Video creation in React. 29 domain-specific rules covering 3D, animations, audio, captions, charts, transitions, and more.

Cody-W-Tucker/skills

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Cody-W-Tucker/skills

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Cody-W-Tucker/skills

Master April Dunford's 8-step sales narrative from \"Sales Pitch\" (2023). Transform your positioning into a compelling story that wins enterprise deals. Use when: Structuring B2B sales presentations and demos; Creating pitch decks for complex products; Training sales teams on narrative-driven selling; Converting positioning strategy into sales conversations; Winning against entrenched competitors

Cody-W-Tucker/skills

Swiss-style user-research narrative template in warm-paper editorial aesthetics. Use when users ask for a premium research deck or story-first live artifact with minimalist typography, high-clarity layout, subtle motion, donut breakdowns, and keyboard/click navigation across slides in a single HTML file.

Cody-W-Tucker/skills

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

相關技能