Communitygithub.com

build-site

クライアントサイトのフルパイプラインを実行します:概要・デザイン情報の収集、サイトマップ・コピー作成、ビルド、チェック、レビュー、SEO、そして公開準備。2つの承認ゲートと制限付き修正ループを備えています。クライアントサイトの新規構築や再構築時、またはユーザーが「サイトを構築して」と言った場合や /build-site を実行した場合に使用します。

build-site とは?

このスキルは、クライアントサイトの構築プロセス全体を体系的に管理・実行するための完全なパイプラインです。インテーク、計画、ビルド、SEO検証、レビュー、修正ループ、ローンチ準備、そして教訓の記録に至るまで、9つの明確なステージで構成されています。各ステージはパイプライン状態ファイル(pipeline-state.md)を通じて管理され、複数のセッションにまたがる作業をシームレスに継続できます。スキルは、サブエージェント(Taste Skill、コピーライティング、SEO、サイトレビューア、バグ修正など)に作業を委譲しながら、全体の進行と品質を統制します。これにより、ユーザーは詳細な各ステップを個別に指示する代わりに、このスキルを呼び出すだけで、一貫性のある高品質なクライアントサイトを構築できます。このスキルは、Claude CodeなどのAIエージェントプラットフォーム向けに設計されており、開発者やエージェントユーザーがクライアントワークの生産性と再現性を大幅に向上させるのに役立ちます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cgfeletar/website-builder/tree/HEAD/core/.claude/skills/build-site

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

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

ドキュメント

クライアントサイトの構築

メインセッションがこのパイプラインを実行し、サブエージェントに委譲します。(サブエージェントは他のサブエージェントを開始できないため、これがスキルであってオーケストレーターエージェントではない理由です。)

[0 インテークゲート]  概要 + DESIGN.md + 参考資料
      ↓
[1 計画]  サイトマップ、ページセクション、コピー  →  plan.md, src/data/*
      ↓
[ユーザーゲート 1]  計画とコピーを承認
      ↓
[2 ビルド]  ページとビジュアルシステム
      ↓
[3 SEO]     SEOエージェント            →  seo-report.md
      ↓
[4 検証]  npm run verify (ハードゲート)
      ↓
[5 レビュー]  サイトレビューアエージェント  →  review-report.md
      ↓
[6 修正ループ]  P0/P1 → 修正 → 検証 → 再レビュー(最大2ラウンド)
      ↓
[ユーザーゲート 2]  サイトを承認
      ↓
[7 ローンチ準備]  ローンチチェックリスト + 引き継ぎ書
      ↓
[8 教訓]  docs/lessons.md に追記

成果物

すべて .claude/pipeline/ に配置します:

pipeline-state.md   ステージ、修正ラウンド、最終更新日時
plan.md             サイトマップ、ページごとのセクション、ページごとのメインアクション
review-report.md    site-reviewer からの出力
seo-report.md       seo からの出力
screenshots/        npm run verify からの出力

各ステージの開始時に pipeline-state.md を読み、そこに記された場所から再開します。各ステージの終了時にそれを更新します。これにより、ビルドを複数のセッションにまたがって行うことができます。

ステージ 0: インテークゲート

各項目を確認します。不足しているものがあれば、止まってユーザーがそれを埋めるのを手伝ってから、他のことを始めます。

項目準備完了条件
.agents/product-marketing.mdビジネスファクトセクションが完了し、メインアクションが命名され、対象顧客とボイスが埋まっていること。ユーザーから提供された情報をもとに、product-marketing スキルを使用してドラフトを作成します。
src/data/business.json名前、電話、住所、営業時間、マップリンクが概要と一致していること。概要からコピーします。
DESIGN.mdすべてのセクションが埋まっていること。ユーザーが参考資料しか持っていない場合は、references/ からドラフトを作成し、確認を求めます。
references/少なくとも2つのスクリーンショットまたはURLがあり、それぞれから何を参考にするかのメモがあること。
クライアントアセットロゴと写真、または当面は代用で問題ないという明示的なメモがあること。
編集クライアント自身がサイトを編集するか?(ステージ7に影響します。)

次に、DESIGN.md から src/styles/tokens.css を記入します。

ステージ 1: 計画

  1. plan.md を書きます:ページ(ほとんどのクライアントにはホーム、メインオファーごとのページまたはメニュー/サービス、アバウト、コンタクトが必要です)、ページごとの1つのメインアクション、各ページのセクションを順に並べます。概要と site-essentials を使用します。
  2. copywriting スキルでコピーを書き、次にそれに対して copy-editing を実行します。概要の顧客の言葉とクライアント自身の言葉から始め、それらのフレーズの一部をほぼそのまま使用します。CLAUDE.md のハウスルール9(一般的なAIフレージングは不使用)に従います。src/data/(home.json, services, FAQs)に配置し、コンポーネント内には配置しません。
  3. 不明な点は [NEED: ...] とマークします。不足を捏造した事実で埋めることは決してしません。

ユーザーゲート 1

停止します。ユーザーに以下を表示します:サイトマップ、各ページのセクションとメインアクション、全文コピー、すべての [NEED: ...] 項目。承認または変更を待ちます。コピーはビルド後よりも今変更する方がコストが低くなります。

ステージ 2: ビルド

design-taste-frontend スキル(Taste Skill)を使用して、このAstroプロジェクト内でビルドします。開始する前に、以下を伝えます:

  • 種類は place(人が訪れる場所)または service(人が雇われるサービス)であり、技術的な種類は決してありません。
  • DESIGN.md と references/ がパレット、タイポグラフィ、雰囲気を設定します。Taste Skill 自身の扱うパレットとフォントは上書きされます。
  • ビジネスファクトは src/data/business.json から取得されます。Taste Skill の代用連絡先ルールは適用されません。
  • モーションは CLAUDE.md のハウスルールに従います。

ページごとにビルドし、最初にホームを構築します。ホームの後、npm run verify を実行し、3つのスクリーンショットを確認して、次のページを構築する前に見つけた問題を修正します。Taste Skill のフィニッシュゲートは、停止時に自動的に実行されます。その結果は入力として扱いますが、競合が発生した場合は CLAUDE.md が優先されます。

ステージ 3: SEO

SEOエージェントは head タグ、JSON-LD、robots を編集するため、検証とレビューの前に実行されます。これにより、レビューは完成したサイトを評価できます。

seo: "このサイトのSEOを監査および実装します。ローカルビジネスのステップを含みます。概要: .agents/product-marketing.md。レポートを .claude/pipeline/seo-report.md に書き出してください。"

ステージ 4: 検証(ハードゲート)

npm run verify

すべての check-site のFAILとスクリーンショットの問題(横スクロール、コンソールエラー)は、レビューの前に修正しなければなりません。[NEED: ...] による失敗は、ユーザーに既に尋ねている事実についてのみ許可されます。それらをリストアップします。check-site が汎用的すぎるとフラグを立てたコピーは、クライアントが実際にその単語を使用している場合を除き、書き直します。

ステージ 5: レビュー

レビューアは読み取り専用であり、レポートを最終メッセージとして返します。そのメッセージを一字一句そのまま .claude/pipeline/review-report.md に保存します。

site-reviewer: "構築されたサイトをレビューしてください。計画: .claude/pipeline/plan.md。概要: .agents/product-marketing.md。デザイン: DESIGN.md。スクリーンショット: .claude/pipeline/screenshots/。既に行われたSEO変更: .claude/pipeline/seo-report.md。完全なレポートを最終メッセージとして返してください。"

ステージ 6: 修正ループ

site-reviewer の評決アクション
準備完了ゲート2へ進む
フォローアップが必要、P2のみゲート2へ進み、P2をリストアップする
フォローアップが必要(P1)またはブロック(P0)ラウンド < 2: 修正し、ステージ4(検証)を再実行し、変更されたページに対して site-reviewer を再実行してレポートを保存する。ラウンド = 2: 停止してユーザーに表示する。

壊れているもの(単に概要から外れているだけでなく)については、bug-fixer エージェントを使用します。pipeline-state.md のラウンドを毎回インクリメントします。

ユーザーゲート 2

停止します。ユーザーに以下を表示します:390px と 1440px でのホームのスクリーンショット、評決、残りのP2、必要なSEO決定、残りの [NEED: ...] 項目、および差し替えが必要なプレースホルダー写真。承認を待ちます。

ステージ 7: ローンチ準備

  1. npm run check:launch を実行し、すべてのFAILを修正します。次に docs/launch-checklist.md を記入し、各項目を「完了」「該当なし」「誰かの対応待ち(誰かを明記)」のいずれかにマークします。
  2. クライアント向けに docs/handoff.md を記入します。
  3. クライアントがサイトを編集する場合は、docs/client-editing.md に従います。
  4. サイトが実際のドメインで公開された後は、ユーザーに claude-seo を実行するよう促します:/seo local <url> および /seo audit <url>。

ステージ 8: 教訓

レポートと修正ラウンドをスキャンし、2回以上問題が発生した、または実際に時間を要したものを特定します。docs/lessons.md に日付入りの行を1行ずつ追記します。将来すべてのサイトで活用できるよう、どの教訓を site-starter にコピーバックする価値があるかをユーザーに伝えます。

関連スキル