Communitygithub.com

Launch QA

對網站進行上線前品質檢查,涵蓋效能、無障礙、SEO基礎、表單、跨裝置行為與內容,並依據嚴重程度排序問題並提供修復建議。

Launch QA 是什麼?

Launch QA 是一個專門針對即將上線或宣稱「已準備好」的網站進行全方位品質檢查的 AI 技能。它能幫助開發者與專案負責人找出最關鍵的阻礙(Blockers)、應修復問題(Should fix)與可優化細節(Polish),並提供具體的修復指引。該技能強調以測量為基礎,而非主觀意見,並支援多種檢查方式:可直接掃描線上 URL、本地建置資料夾,或整合至 CI 流程。支援的平台包括所有現代瀏覽器與裝置,並涵蓋功能與內容正確性、效能指標(LCP/INP/CLS)、無障礙規範(WCAG)、SEO 基礎(標題、描述、結構化資料)、跨裝置行為(320px~1440px)、安全性(HTTPS、CMS 更新)與營運設定(備份、分析工具)。最終產出一份以嚴重程度排序的報告模板,讓團隊能快速掌握問題全貌與修復優先順序。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/launch-qa

在你喜歡的 AI 中提問

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

說明文件

Launch QA 是做什麼的?

找出會讓網站所有者難堪或造成客戶流失的問題,按嚴重程度排序並說明如何修復。列出四十個同等重要的雞毛蒜皮問題是沒有用的;三個阻礙性問題加上一個簡短的尾端列表才是關鍵。

如何執行

  1. 確定您可以檢查的範圍:線上 URL、原始碼檔案,或兩者兼具。說明您無法執行的檢查項目(例如真實裝置測試或表單提交),而不是標記為「通過」。

  2. 如果 webcraft CLI 可用,請先執行它以進行可量化的檢查(或呼叫 audit_site MCP 工具):

    webcraft audit https://example.com --pages 10     # 線上網站:也會檢查 robots、sitemap、重新導向、404、連結
    webcraft audit ./dist                             # 本地建置資料夾
    webcraft audit ./dist --json --fail-on blocker    # CI:遇到阻礙性問題時回傳 exit 1
    

    它會產生下方的報告模板,並包含「未檢查」列表。在報告令人驚訝的發現之前,請先驗證它們,然後將您的精力花在它無法看到的項目上:渲染、鍵盤操作、真實裝置、內容準確性。

  3. 逐一處理以下各個領域。以測量為優先,而非主觀意見:執行頁面、閱讀標記、計算位元組。

  4. 為每個發現分類:

    • 阻礙性問題: 功能損壞、無法存取的關鍵內容、無法提交的表單、錯誤或佔位符內容、應可被索引但無法被索引的網站。
    • 應修復: 對速度、無障礙或搜尋外觀造成可量化的損害。
    • 可優化: 細微的不一致。
  5. 使用結尾的模板進行報告。

功能與內容

  • 每個連結和按鈕都指向真實位置。沒有 #,沒有 lorem ipsum,沒有模板殘留物,沒有測試用電子郵件地址。
  • 表單:必要的驗證、明確的錯誤訊息、成功狀態、垃圾郵件防護,以及一次能正確送達收件匣的實際測試提交。
  • 電話號碼使用 tel:,電子郵件使用 mailto:,並且都是正確的(檢查頁首和頁尾之間的電話號碼是否不一致)。
  • 404 頁面存在並連結回首頁。
  • 必要時提供法律頁面:隱私權政策、條款、若使用追蹤則需有 Cookie 通知。
  • 版權年份和商家資訊是最新且一致的。

效能

目標為中階手機在 4G 網路上的表現:LCP 低於 2.5 秒,INP 低於 200 毫秒,CLS 低於 0.1。

  • 圖片:現代格式(WebP 或 AVIF)、尺寸符合顯示大小、設定 width 和 height、在折疊線以下使用 loading="lazy",而 LCP 圖片應預先載入且不延遲載入。
  • 影片:預覽圖、不帶聲音自動播放、經過壓縮、如果是裝飾性影片則不在小螢幕上載入。
  • 字型:最多兩個字型家族、font-display: swap、預先載入折疊線以上的檔案。
  • CSS 和 JS:經過壓縮、盡可能延遲載入、沒有未使用的函式庫(為了單張靜態圖片而載入輪播函式庫是常見問題)。
  • 第三方腳本:每個都應有正當理由。聊天小工具和追蹤器是常見的 LCP 和 INP 元凶。
  • 伺服器端啟用快取和壓縮。

無障礙

  • 一個 h1;標題層級不跳階。
  • 所有有意義的圖片都有 alt 文字;裝飾性圖片使用空的 alt=""。
  • 文字對比度至少 4.5:1(大字型為 3:1)。首先檢查圖片上的文字以及淺灰色文字。
  • 所有功能都可透過鍵盤操作:可見的焦點環、邏輯順序、選單和手風琴元件可操作、無焦點陷阱。
  • 表單欄位有相關的 <label> 元素;錯誤訊息應被宣告,而非僅以顏色顯示。
  • 尊重 prefers-reduced-motion;無閃爍內容;自動播放的動畫應可暫停。
  • <html> 上有 lang 屬性;頁面在 200% 縮放下能正常運作。

SEO 基礎

  • 每個頁面有獨特的 <title>(50 到 60 個字元)和 meta description(約 150 個字元)。
  • 設定 Canonical URL;同一域名只有一個版本(https,含或不含 www),其他版本應重新導向至此。
  • robots.txt 不阻擋網站,沒有來自測試環境的遺留 noindex,存在 XML Sitemap。
  • 設定 Open Graph 標題、描述和圖片(1200x630,透過 https 提供),以便分享連結時顯示正確。
  • 在適用的地方加入結構化資料(Organization 或 LocalBusiness、FAQ、Article)並確保有效。
  • 使用有意義的連結文字,而非「按這裡」;使用乾淨的 URL。

跨裝置

  • 寬度 320、390、768、1024、1440:無水平滾動、無文字重疊、觸控目標至少 44px。
  • 支援最新版的 Chrome、Safari、Firefox 和 Edge;特別注意 iOS Safari 對 vh 單位、固定定位和影片自動播放的支援。
  • 如果 JavaScript 失敗,動畫不應隱藏內容。

安全性與營運

  • 全面使用 HTTPS,無混合內容。
  • CMS、佈景主題和外掛已更新;移除未使用的外掛和佈景主題;無預設的管理員使用者名稱。
  • 已排程備份,且至少測試過一次還原。
  • 已連結分析工具和搜尋控制台,並在需要時處理同意機制。
  • 存在 Favicon 和觸控圖示。

報告模板

# Launch QA: [網站名稱]   檢查日期: [日期]   範圍: [已檢查與未檢查的項目]

結論:準備就緒 / 修復阻礙性問題後可上線 / 尚未準備就緒

## 阻礙性問題
1. [問題描述] — [位置] — [修復方式]

## 應修復
...

## 可優化
...

## 未檢查
- [檢查項目] — [原因,以及網站所有者如何自行檢查]

每個發現保持一行問題描述、一行位置、一行修復方式。以結論開頭,讓網站所有者能立即知道自己的處境。

Individual skills in this repo

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

design-tokens

Create a website's visual system as CSS custom properties, covering color palette, typography scale, spacing, radius and shadows, with contrast checked. Use this whenever someone asks for a color scheme, a palette from one brand color, font pairing, a type scale, "make it look consistent", dark mode, a rebrand of an existing site into new colors, or starts a build with no defined styles.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

site-teardown

Analyze a live website and turn it into a section-by-section build brief that another person or AI can rebuild from, with brand name, colors, fonts and images swapped for placeholders. Use this whenever someone shares a URL and says "analyze this site", "make something like this", "give me a prompt to build this", "recreate this effect", "clone the layout with my branding", or asks how a page's animation or structure works, even if they never say "teardown".

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

wordpress-theme-build

Turn a static HTML/CSS/JS design into a custom WordPress theme that the client can edit, covering theme structure, theme.json, enqueueing scripts, block patterns, custom post types and editable content. Use this whenever someone wants to convert a design or static site to WordPress, build a custom or block theme, make sections editable in Gutenberg, add GSAP or other scripts to a theme properly, or asks why their theme edits are lost or their content is hard-coded.

相關技能