Communitygithub.com

supersite-build

外科手術的なWebサイトビルダー:AIコーディングエージェント向け。supersite-plan.mdの仕様契約を読み、クリーンで構成可能なReact/Next.jsコンポーネントを生成し、デザイントークンを配線し、npm run buildでコンパイルを検証します。

supersite-build とは?

supersite-build は、AIコーディングエージェント(Claude Code, Cursor, Codex等)向けに設計された、外科手術的なWebサイトビルダースキルです。事前に /supersite-plan で作成された supersite-plan.md を仕様契約書として読み取り、その内容に従ってReact/Next.jsプロジェクトをゼロから構築します。具体的には、TypeScriptの型定義や設定ファイルの生成、デザイントークン(カラー、タイポグラフィ、角丸)の適用、ContainerやButtonといったUIプリミティブからNavbarやHeroといったセクションブロックまでの段階的なコンポーネント構築を行います。最後に npm run build を実行してビルドが通ることを確認し、ゼロemダッシュルールなどの品質チェックを実施します。このスキルにより、人間が仕様を定義すれば、エージェントがその通りに高品質なコードを生成・検証できるため、反復作業や手戻りを大幅に削減できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/developer-mohanaditya/supersite/tree/HEAD/skills/supersite-build

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

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

ドキュメント

🔨 supersite-build: 外科手術的ビルダー

supersite-build は /supersite-plan で確立されたアーキテクチャ計画を実行します。supersite-plan.md を読み取り、アトミックコンポーネントを構築し、デザイントークンとコピーを配線し、ビルドエンジンに対して実装を検証します。


実行パイプライン

┌─────────────────────────────────────────────────────────────┐
│ 1. 仕様契約の読み取りと検証                                   │
│ supersite-plan.md からトークン、ルート、マニフェストを解析      │
├─────────────────────────────────────────────────────────────┤
│ 2. スキャフォールディング、型定義と設定                        │
│ src/types/site.ts、src/config/site.ts とベースCSSを作成        │
├─────────────────────────────────────────────────────────────┤
│ 3. UIプリミティブの構築                                      │
│ Container、SectionHeader、Button、Badge、Card                 │
├─────────────────────────────────────────────────────────────┤
│ 4. セクションブロックの構築                                   │
│ Navbar、Hero、Contrast、Features、Proof、Pricing、Footer      │
├─────────────────────────────────────────────────────────────┤
│ 5. ルートの組み立てとビルドの検証                              │
│ ページの配線、アクセシビリティのチェック、npm run buildの実行   │
└─────────────────────────────────────────────────────────────┘

ステップ1: supersite-plan.md の読み取りと検証

  1. ワークスペースルートに supersite-plan.md があるか確認します。
    • 存在しない場合、処理を中断しユーザーに以下のように通知します:

      "プロジェクトルートに supersite-plan.md が見つかりません。/supersite-plan を実行して計画を共同で設計するか、/supersite <prompt> を実行して直接生成してください。"

  2. 計画から以下のアーキテクチャパラメータを解析します:
    • 美的ジャンルとカラーパレット(Hex/OKLCH、60-30-10分布)。
    • タイポグラフィと角丸の選択。
    • ルートとコンポーネントのマニフェスト。
    • セクションのコピー、見出し、インタラクティブ要素。

ステップ2: スキャフォールディング、型定義と設定

  1. 依存関係の確認:
    • 標準ユーティリティ(lucide-react、clsx、tailwind-merge)が存在することを確認します。不足している場合はインストールします:
      npm install lucide-react clsx tailwind-merge
      
  2. TypeScript契約の生成(src/types/site.ts):
    • NavItem、FeatureItem、PricingPlan、Testimonial、FAQItem の型を定義します。
  3. 集中設定の生成(src/config/site.ts):
    • ナビゲーションリンク、ブランドメタデータ、構造化されたセクションコンテンツを1箇所に保存します。
  4. ベースCSSの更新(src/app/globals.css):
    • カラー変数、選択スタイル、prefers-reduced-motion アクセシビリティブロックを注入します:
      @layer base {
        ::selection {
          background-color: var(--accent);
          color: var(--accent-foreground);
        }
      }
      
      @media (prefers-reduced-motion: reduce) {
        *, ::before, ::after {
          animation-duration: 0.01ms !important;
          animation-iteration-count: 1 !important;
          transition-duration: 0.01ms !important;
          scroll-behavior: auto !important;
        }
      }
      

ステップ3: UIプリミティブの構築(src/components/ui/)

モジュール式のプリミティブを生成します:

  • container.tsx: レスポンシブパディング付きの最大幅コンテナ(max-w-6xl または max-w-7xl)。
  • section-header.tsx: 標準化されたバッジ、タイトル、説明ブロック。
  • button.tsx: バリアント駆動のボタン(primary、secondary、outline、ghost)。明示的な :focus-visible スタイルを含む。
  • badge.tsx: 細いヘアラインボーダーのピル形状およびステータスチップ。
  • card.tsx: 計画のサーフェスカラー、ボーダー、角丸トークンを適用するサーフェスラッパー。

ステップ4: セクションブロックの構築(src/components/site/)

計画で指定された各セクションを構築します:

  • navbar.tsx: デスクトップナビゲーションリンク、アクションCTA、モバイルハンバーガードロワーを備えたレスポンシブヘッダー。
  • hero.tsx: フックピル、H1タイトル、リードパラグラフ、CTAクラスター、インタラクティブなプロダクトプレビュー(例:ターミナルまたはUIフレーム)。
  • problem-contrast.tsx: 現状の課題とモダンなソリューションを対比する非対称なビジュアルコントラスト。
  • feature-grid.tsx: 非対称のbentoグリッドまたはモジュール式機能セル。繰り返しの3カードコピーはありません。
  • product-showcase.tsx: インタラクティブコンポーネント(タブ付きコードエクスプローラー、ライブインタラクティブプレビュー、設定プレイグラウンド)。
  • social-proof.tsx: 検証可能なメトリクスの呼びかけと、特定のエンジニアリング職種を含む顧客の推薦文。
  • pricing-matrix.tsx: 月額/年額請求トグル("use client" 使用)、ティアカード、機能チェックリスト、チェックアウトCTA。
  • faq-accordion.tsx: スムーズなCSSグリッドの高さトランジションを使用した、展開可能な技術Q&A。
  • footer.tsx: 複数列のナビゲーションリンク、法的アンカー、システムステータスドット、著作権表示。

ステップ5: ルートの組み立てとビルドの検証

  1. src/app/page.tsx の組み立て:
    • セクションコンポーネントをインポートし、クリーンで宣言的なJSXでナラティブレイアウトを構成します。
  2. 追加ルートの組み立て:
    • 計画でマルチページルート(/features、/pricing、/security)が指定されている場合、対応する page.tsx ファイルを構築します。
  3. プレフライトアンチスロップ監査の実行:
    • 禁止スタイルのチェック:パープルのグラデーションブロブ、根拠のないカード、汎用的なプレースホルダーコピーがないことを確認。
    • タッチターゲットのチェック:インタラクティブなヒットエリアが 44×44px 以上であることを確認。
    • emダッシュのチェック:すべてのUIコピー、見出し、マイクロコピー、ボタンラベルに emダッシュ(— または --)がゼロであることを確認。
  4. コンパイルとビルドゲート:
    • ワークスペースのビルドコマンドを実行します:
      npm run build
      
    • TypeScriptエラーやインポート漏れがある場合、即座に修正し、クリーンにコード0でビルドが通るまで再実行します。
  5. ユーザーへの報告:
    • すべての会話応答および進捗報告において、ゼロemダッシュルール(— または -- を決して使用しない)を徹底します。代わりにピリオド、コロン、カンマ、括弧を使用します。
    • 構築したファイルのクリーンな要約をクリック可能なリンクとともに提供します:
      • [supersite-plan.md](file:///path/to/supersite-plan.md)
      • [page.tsx](file:///path/to/src/app/page.tsx)
      • src/components/site/ 内の個別コンポーネントリンク
    • コンパイル成功を確認します。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル