Communitygithub.com

Launch QA

Webサイトの公開前品質チェックを実施し、パフォーマンス、アクセシビリティ、SEOの基礎、フォーム、クロスデバイス動作、コンテンツを評価。重大度別に分類された結果と修正方法をレポートします。

Launch QA とは?

このスキルは、Webサイトの公開前品質チェック(Launch QA)を自動化・体系化するためのツールです。パフォーマンス、アクセシビリティ、SEO、フォーム、クロスデバイス動作、セキュリティ、コンテンツの正確性など、40以上のチェック項目をカバーし、発見された問題を「Blocker(ブロッカー)」「Should fix(修正推奨)」「Polish(微調整)」の3段階で重大度分類します。`webcraft` CLIやMCPツールと連携してLighthouse的な監査を実行可能で、人間の目での確認が必要な項目(レンダリング、キーボード操作、実機テスト、コンテンツの正確性)を明確に区別します。レポートはテンプレート化されており、まず「Verdict(判定)」を提示することで、サイト所有者がすぐに全体像を把握できるよう設計されています。Claude Code、Cursor、CodexなどのAIエージェント上で動作し、開発者がサイトの「あとで直す」を見逃さないように支援します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/launch-qa

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Launch QA は何をしますか?

サイトのオーナーを恥ずかしい思いにさせたり、問い合わせを逃したりする原因を見つけ、優先順位を付け、修正方法を示します。重みの等しい40の細かい指摘は役に立ちません。3つのブロッカーと短いテールが有用です。

実行方法

  1. 検査可能なものを特定します。公開URL、ソースファイル、またはその両方です。実施できなかったチェック(例:実機テストやフォームの配信テスト)は、合格とマークする代わりにその理由を明記します。

  2. webcraft CLIが利用可能な場合は、測定可能なチェックを最初に実行します(またはaudit_site MCPツールを呼び出します)。

    webcraft audit https://example.com -pages 10     # ライブサイト: robots、サイトマップ、リダイレクト、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 200ms未満、CLS 0.1未満。

  • 画像: 最新フォーマット(WebPまたはAVIF)、表示サイズに合わせたサイズ、widthとheightの指定、ファーストビュー以下ではloading="lazy"、LCP画像はプリロードされlazyではないこと。
  • 動画: ポスター画像あり、音声付き自動再生なし、圧縮済み、装飾目的の場合小さな画面では読み込まない。
  • フォント: 最大2ファミリー、font-display: swap、ファーストビューファイルはプリロード。
  • CSSとJS: ミニファイ、可能な場合は遅延読み込み、未使用のライブラリなし(1枚の静止画像のためにスライダーライブラリを読み込むのはよくある事例)。
  • サードパーティスクリプト: それぞれに正当な理由があること。チャットウィジェットとトラッカーは頻繁にLCPとINPの原因となります。
  • サーバーでキャッシュと圧縮が有効になっていること。

アクセシビリティ

  • h1は1つだけ。見出しレベルはスキップしない。
  • 意味のある画像すべてにaltテキストがあること。装飾的な画像には空のalt=""。
  • テキストのコントラスト比は少なくとも4.5:1(大きなテキストは3:1)。画像上のテキストと薄いグレーのテキストを最初に確認します。
  • すべてキーボードで操作可能: 可視のフォーカスリング、論理的な順序、メニューとアコーディオンが操作可能、フォーカストラップなし。
  • フォームフィールドに関連付けられた<label>要素があること。エラーは色だけでなく、スクリーンリーダーでも通知されること。
  • prefers-reduced-motionが尊重されていること。点滅するものがないこと。自動再生モーションは一時停止可能であること。
  • <html>にlang属性があること。200%ズームで動作すること。

SEOの基礎

  • ページごとに一意の<title>(50~60文字)とメタディスクリプション(約150文字)があること。
  • 正規URLが設定されていること。ドメインの1バージョン(https、wwwあり/なし)のみが使用され、他はリダイレクトされること。
  • robots.txtがサイトをブロックしていないこと。ステージング環境からのnoindexが残っていないこと。XMLサイトマップが存在すること。
  • シェアリンクが正しく表示されるように、Open Graphのタイトル、ディスクリプション、画像(1200x630、httpsで配信)が設定されていること。
  • 該当する場合、構造化データ(OrganizationまたはLocalBusiness、FAQ、Article)が存在し、有効であること。
  • 「こちらをクリック」ではなく、説明的なリンクテキスト。クリーンなURL。

クロスデバイス

  • 幅320、390、768、1024、1440px: 水平スクロールなし、テキストの重なりなし、タップターゲットは最低44px。
  • 最新のChrome、Safari、Firefox、Edge。特にiOS Safariでは、vh単位、スティッキーポジショニング、動画の自動再生を確認。
  • アニメーションは、JavaScriptが失敗してもコンテンツを隠さないこと。

セキュリティと運用

  • HTTPS everywhere、混合コンテンツなし。
  • CMS、テーマ、プラグインが更新されていること。未使用のプラグインとテーマは削除されていること。デフォルトの管理者ユーザー名が使われていないこと。
  • バックアップがスケジュールされ、復元テストが1回実施されていること。
  • アナリティクスとサーチコンソールが接続され、必要な場合は同意処理が行われていること。
  • Faviconとタッチアイコンが存在すること。

レポートテンプレート

# Launch QA: [サイト]   確認日: [日付]   スコープ: [検査したものとしなかったもの]

判定: 準備完了 / ブロッカー修正後準備完了 / 準備不可

## ブロッカー
1. [問題] — [場所] — [修正方法]

## 修正推奨
...

## 微調整
...

## 未チェック
- [チェック項目] — [理由、およびオーナーが確認する方法]

各発見は、問題、場所、修正方法の3行に収めます。判定を先頭に置き、オーナーがすぐに状況を把握できるようにします。

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.

関連スキル