Communitygithub.com

NVlabs/Skill2Env

在網站上線前執行結構化的五階段稽核,分別針對視覺精緻度、技術基礎、UX 完整性、內容品質與跨裝置就緒度進行評分(滿分 100 分)。於以下時機使用:**上線前** - 最終驗證;**重新設計後** - 確保改版無回歸問題;**客戶交付** - 提供結構化證明;**季度審查** - 發現累積的技術債;**單一階段重點** - 在性能衝刺後僅執行第二階段

Skill2Env 是什麼?

這是一個專門用於網站上線前最終稽核的 AI 技能,透過五個結構化階段(第一印象、技術基礎、UX 完整性、內容與品牌、跨裝置就緒)對網站進行全面評估,每階段分別計分,總分 100 分。此技能源自 Nielsen Norman Group、Google Web Vitals、OWASP 等權威框架,並整合了 GUIA 生產記憶中關於 Next.js、Framer Motion、GSAP 等技術棧的實際部署經驗。與 Lighthouse 或 Screaming Frog 等單一維度工具不同,此技能模擬真實訪客的體驗流程,從情感設計到技術穩定性進行循序漸進的評分,並將問題分為 P0/P1/P2 優先級。它支援完整的網站稽核、單頁登陸頁、電子商務等不同稽核設定檔,使用者只需提供 URL 與品牌定位,AI 即可產出結構化報告與修復建議,但最終的上線判斷權仍保留給人類。

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

在你喜歡的 AI 中提問

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

說明文件

網站上線總監

結構化五階段網站上線稽核——從第一印象到發佈就緒,滿分 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 頁面、網站圖示

使用方法

上線前完整網站稽核

我即將上線 [網站 URL]。請執行完整的 website-finishing-director 稽核(全部 5 個階段)。
品牌象限:[Warm+Calm / Warm+Active / Cold+Active / Cold+Calm]。
目標受眾:[誰]。

特定修復後的單一階段

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

登陸頁快速稽核

稽核此登陸頁:[URL]。使用登陸頁設定檔(階段 1、2、4)。

指令

執行此稽核時,請依序完成五個階段。每個階段皆建立在前一個階段之上——先打好基礎再追求精緻。為每個檢查點評分,依優先級分類問題,然後產出最終報告。

稽核設定檔

並非每個網站都需要所有五個階段。請根據專案選擇合適的設定檔:

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

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


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

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

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

## 階段 1 — 第一印象(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 — 相反象限(定位混淆)

### 階段 1 分數:___/15

判定:
- 12-15:通過 — 第一印象清楚且情感一致
- 8-11:需要改進 — 訪客能理解,但速度慢或有摩擦
- <8:失敗 — 重新設計折疊線以上的體驗

整合:將情感感受與 web-design-director 象限系統進行比較。如果品牌是 Warm+Calm 但網站感覺是 Cold+Active,無論分數為何,這都是一個 P0 問題。

此階段的 GUIA 已知問題:

  • CTA 中將 Calendly URL 寫死而非連到 /contact/ 頁面(破壞分析追蹤)
  • 溫暖的文案語調搭配冷調 UI 元素(陶土色調 + 等寬字型 = 混淆)

階段 2:技術基礎(25 分)

「基礎設施是否穩固到足以在其上建造?」

## 階段 2 — 技術基礎

### 效能(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 分)已定義標準 URL + 結尾斜線一致
- [ ](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 或除錯端點

### 階段 2 分數:___/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(metadata 不會在伺服器端渲染)
  • 模組層級的 SDK 初始化(Supabase/Stripe)在環境變數遺失時會在構建時失敗——請在函數內部進行延遲初始化
  • Vercel 環境變數因 echo 而帶有尾隨換行——請改用 printf
  • Railway 的 *.railway.internal 主機名稱在 Nixpacks 構建期間無法連線——請使用公開 URL

階段 3:UX 完整性(25 分)

「網站是否能處理真實世界的情境,而不只是快樂路徑?」

## 階段 3 — UX 完整性

### 元件狀態(8 分)

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

評分:根據所有元件中缺少的狀態進行扣分。
8 分 = 所有狀態皆涵蓋。每缺少一個狀態扣 1 分(最低 0 分)。

### 表單(6 分)

- [ ](1 分)客戶端驗證,附清楚錯誤訊息
- [ ](1 分)伺服器端驗證(不僅限於客戶端)
- [ ](1 分)提交後的成功回饋(toast、重新導向或行內顯示)
- [ ](1 分)提交按鈕在處理期間停用(防止重複提交)
- [ ](1 分)垃圾郵件防護(honeypot、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 分)滾動行為正常(無導致使用者被困的滾動劫持)

### 階段 3 分數:___/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)

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

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

## 階段 4 — 內容與品牌

### 文案品質(8 分)

- [ ](2 分)無偵測到預留位置文字(「Lorem ipsum」、「[您的姓名]」、「即將推出」、
      「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 分)元件風格一致(卡片、按鈕、輸入欄位遵循相同模式)

### 階段 4 分數:___/20

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

此階段的 GUIA 已知問題:

  • Calendly URL 必須對應正確的專業人員(Valeria 對比 Matthieu 對比客戶)
  • 混合溫暖文案(「我們理解您的挑戰」)與冷調 UI(深色模式、等寬字型、尖角)
  • AI 生成文案偵測:發佈前移除雙換行(LinkedIn 上的 AI 簽名)
  • credou.bzh 文案方向:以機制為優先,無履歷、無經歷/時間軸

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

「是否在任何地方都能運作,且所有項目都準備好上線?」

## 階段 5 — 跨裝置與上線

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

針對 3 大瀏覽器進行測試。每個瀏覽器評分:
- [ ](2 分)Safari — 渲染正確、動畫運作、字型載入
- [ ](2 分)Chrome — 渲染正確、動畫運作、字型載入
- [ ](1 分)Firefox — 渲染正確、無重大中斷

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

### 裝置測試(4 分)

- [ ](2 分)行動裝置(375px)— 完整網站可使用

...

[因原文截斷而結束]

Individual skills in this repo

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

NVlabs/Skill2Env

This skill should be used when the user asks about "digital portfolio", "portfolio website", "project description", "case study", "portfolio curation", "creative portfolio", "act as a portfolio curator", "portfolio curator mode", "portfolio review", "professional presentation", "portfolio architecture", "work samples", "portfolio bio", or needs expertise in building, structuring, and writing professional digital portfolios. Part of the AlterLab FC Skills collection (New Media & Communication department).

NVlabs/Skill2Env

This skill should be used when the user asks about "web content strategy", "SEO writing", "UX writing", "information architecture", "content architecture", "website structure", "act as a web content strategist", "web strategist mode", "site map", "content audit", "microcopy", "meta descriptions", "content hierarchy", "content governance", or needs expertise in planning, structuring, and writing content for websites and digital platforms. Part of the AlterLab FC Skills collection (New Media & Communication department).

NVlabs/Skill2Env

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

NVlabs/Skill2Env

Balance visual design with ATS compatibility for creative roles

NVlabs/Skill2Env

Build immersive, cinematic 2.5D interactive websites using scroll storytelling, parallax depth, text animations, and premium scroll effects — no WebGL required. Use this skill for any web design task: landing pages, product sites, hero sections, scroll animations, parallax, sticky sections, section overlaps, floating products between sections, clip-path reveals, text that flies in from sides, words that light up on scroll, curtain drops, iris opens, card stacks, bleed typography, and any site that should feel cinematic or premium. Trigger on phrases like "make it feel alive", "Apple-style animation", "sections that overlap", "product rises between sections", "immersive", "scrollytelling", or any scroll-driven visual effect. Covers 45+ techniques across 8 categories. Always inspects, judges, and plans assets before coding. Use aggressively for ANY web design task.

NVlabs/Skill2Env

Read-only queue dashboard for workspace-aware ship. (gstack)

NVlabs/Skill2Env

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

NVlabs/Skill2Env

Audits any landing or service page across 48 checks in 10 categories for LLM/AI discoverability, GEO readiness, content clarity, schema markup, internal linking, freshness signals, and technical crawlability. Produces an overall score out of 100, a per-category score out of 100, pass/warn/fail/ manual counts, and a prioritised fix list — all rendered as a standalone HTML report saved to disk. Use when a user provides a URL and asks to audit it, score it, check its GEO readiness, test its AI discoverability, run a landing page audit, or evaluate it for LLM citation potential. Also trigger on phrases like "audit this page", "score this URL", "check GEO for", "is this page AI-ready", "run a GEO audit", "LLM page check", "how would AI read this page", or "landing page score".

NVlabs/Skill2Env

Generates a premium single-page HTML landing page with 3D CSS animations, GSAP scroll effects, and mouse-parallax depth. Forcing intake (product + elevator pitch, audience register, brand overrides, tone) locks down positioning before any copy or markup is written, so the page reflects the actual product rather than generic boilerplate. Use whenever the user says 'landing for X', 'create a landing page', 'build a landing page', 'make a landing page for X', 'I need a web page for Y', or provides product/service details and wants a polished website. Also triggers on 'promotional page', 'product page', 'one-pager', 'web presence', 'sales page'. Outputs a single self-contained HTML file (Claude Code) or HTML artifact (Claude.ai). Supports configurable brand colors via CSS custom property overrides.

NVlabs/Skill2Env

Use when a user asks to build, optimize, backtest, rebalance, or analyze a stock portfolio with Mean-CVaR, efficient frontiers, scenario generation, or NVIDIA cuOpt.

NVlabs/Skill2Env

Transform resume bullets into detailed portfolio case studies

NVlabs/Skill2Env

Generates high-converting landing pages as complete Next.js/React (TSX) components with Tailwind CSS. Creates hero sections, feature grids, pricing tables, FAQ accordions, testimonial blocks, and CTA sections using proven copy frameworks (PAS, AIDA, BAB). Outputs SEO meta tags, structured data, and performance-optimised code targeting Core Web Vitals (LCP < 1s, CLS < 0.1). Use when the user asks to create a landing page, marketing page, homepage, single-page site, lead capture page, campaign page, promo page, or conversion-optimised web page — or when they want to A/B test landing page variants or replace a static page with one designed to convert.

NVlabs/Skill2Env

> Visual design direction framework organized by emotional intent (Warm/Cold x Active/Calm). The first design reference system that categorizes sites by what they make you FEEL, not how they look. Includes 48 annotated public website references.

相關技能