Astro ウェブサイトビルダー
このスキルは、Astro.build を使用したウェブサイト構築を、テーマの選択、ドキュメントへのアクセス、開発のベストプラクティスのガイドを通じて支援します。ユーザーが Astro での構築について言及した場合、ウェブサイトを作成したい場合、または Astro 特有の機能に関するヘルプが必要な場合に、このスキルを使用してください。
このスキルを使用するタイミング
以下の場合にこのスキルを有効にしてください:
- ユーザーがリクエスト内で「Astro」または「astro.build」に言及した場合
- ユーザーがウェブサイトを構築したいと考えており、Astro が適切な場合(ブログ、ドキュメント、ポートフォリオ、マーケティングサイトなど)
- ユーザーが Astro プロジェクト用のテーマを選択する必要がある場合
- ユーザーが Astro のコンポーネント、ルーティング、または設定についてヘルプを必要としている場合
- ユーザーが React、Vue、またはその他のフレームワークを Astro と統合したい場合
- ユーザーが Astro のドキュメントやベストプラクティスへのアクセスを必要としている場合
ワークフロー概要
Astro ウェブサイトを構築する際は、以下のプロセスに従ってください:
- 要件の理解 - ウェブサイトの種類と必要な機能を決定する
- 適切なテーマの選択 - 要件に基づいて Astro の無料テーマから選択する
- ドキュメントへのアクセス - 特定の機能について Astro ドキュメントを参照する
- プロジェクトの初期化 - プロジェクト構造をセットアップする
- コンポーネントの開発 - Astro のコンポーネントアーキテクチャを使用して構築する
- 最適化とデプロイ - パフォーマンスのベストプラクティスに従う
ステップ 1: 要件の理解
まず、ウェブサイトの種類とその要件を特定します:
ウェブサイトの種類:
- ブログ / 出版サイト
- ポートフォリオ / ショーケース
- ドキュメントサイト
- マーケティング / ランディングページ
- E コマースサイト
- 会社 / ビジネスサイト
- 個人ウェブサイト
尋ねるべき重要な質問:
- サイトの主な目的は何ですか?
- どのようなコンテンツタイプがありますか?(ブログ記事、プロジェクト、製品など)
- インタラクティブ性は必要ですか?(フォーム、検索、動的コンテンツ)
- ユーザーはどのフレームワークを好みますか?(React、Vue、Svelte など)
- 特定の機能は必要ですか?(ダークモード、i18n、CMS 統合)
ステップ 2: 適切なテーマの選択
web_fetch を使用して、無料の React 互換テーマを閲覧します:
URL: https://astro.build/themes/1/?search=&technology%5B%5D=react&price%5B%5D=free
テーマ選択の基準:
ブログ / 出版物向け:
- 強力なタイポグラフィを持つテーマを探す
- Markdown/MDX をサポートしている必要がある
- タグ/カテゴリがあるべき
- RSS フィードのサポート
- 検討すべきテーマ:astro-paper、astro-blog-template
ポートフォリオ向け:
- 視覚的なプロジェクトショーケース
- 自己紹介/お問い合わせセクション
- スムーズなアニメーション
- 検討すべきテーマ:astro-portfolio、personal-portfolio テーマ
ドキュメント向け:
- Starlight を使用する(Astro の公式ドキュメントフレームワーク)
- 機能:検索、サイドバーナビゲーション、ダークモード、i18n
- 最適な用途:技術ドキュメント、API リファレンス、ガイド
ランディングページ向け:
- CTA 付きのヒーローセクション
- 機能/メリットのセクション
- お問い合わせフォーム
- コンバージョン最適化
E コマース向け:
- 商品一覧とフィルター
- ショッピングカート機能
- 決済統合対応
- 商品詳細ページ
アクション: テーマページを取得し、利用可能なテーマを分析し、ユーザーの要件に最も合う 2〜3 のオプションを推奨します。各テーマがなぜ適しているかを説明します。
ステップ 3: Astro ドキュメントへのアクセス
特定の Astro ドキュメントが必要な場合は、以下を参照してください:
- 組み込みリファレンス:
references/astro_docs.md- コアとなる Astro の概念、構文、および一般的なパターンを含みます - 完全なドキュメント: 包括的な情報については
https://docs.astro.build/llms-full.txtから取得します
ドキュメントを参照するタイミング:
- コンポーネント構文の質問 → astro_docs.md を参照
- ルーティングとページ → astro_docs.md を参照
- スタイリングオプション → astro_docs.md を参照
- 高度な機能 → docs.astro.build から取得
- 統合セットアップ → docs.astro.build から取得
- API の詳細 → docs.astro.build から取得
ステップ 4: Astro プロジェクトの初期化
Create Astro CLI の使用
# 新しいプロジェクトを作成
npm create astro@latest
# または特定のテンプレートを使用
npm create astro@latest -- --template <theme-github-username>/<theme-repo>
プロジェクト構造のセットアップ
初期化後、適切な構造を確認します:
project/
├── src/
│ ├── components/ # 再利用可能なコンポーネント
│ ├── layouts/ # ページレイアウト
│ ├── pages/ # ルート(必須)
│ │ └── index.astro # ホームページ
│ ├── content/ # コンテンツコレクション(オプション)
│ └── assets/ # 最適化された画像
├── public/ # 静的アセット
├── astro.config.mjs # 設定
├── package.json
└── tsconfig.json
重要: ルーティングを機能させるには src/pages/ ディレクトリが必須です。
ステップ 5: コンポーネントとページの開発
コンポーネント開発パターン
src/components/にコンポーネントファイルを作成- props インターフェースを定義(TypeScript を使用する場合)
- コンポーネントスクリプトを記述(ビルド時に実行)
- テンプレートを作成(Astro 構文の HTML)
- スコープ付きスタイルを追加(オプション)
例:
---
interface Props {
title: string;
description?: string;
}
const { title, description } = Astro.props;
---
<article>
<h2>{title}</h2>
{description && <p>{description}</p>}
</article>
<style>
article {
padding: 1rem;
border: 1px solid #ccc;
}
</style>
ページ開発パターン
src/pages/にページファイルを作成(ルートを決定)- 必要なコンポーネントとレイアウトをインポート
- 動的ルート用に
getStaticPaths()を定義 - コンポーネントを使用してページを構成
ページの例:
---
import Layout from '../layouts/Layout.astro';
import Hero from '../components/Hero.astro';
const title = "My Page";
---
<Layout title={title}>
<Hero />
<!-- その他のコンテンツ -->
</Layout>
インタラクティブ性の追加
クライアントサイドのインタラクティブ性が必要な場合:
- フレームワーク統合をインストール:
npx astro add react - フレームワークコンポーネントを作成 (.jsx、.vue、.svelte)
- クライアントディレクティブ付きでインポートして使用:
---
import ReactComponent from '../components/ReactComponent.jsx';
---
<!-- 静的(JS なし) -->
<ReactComponent />
<!-- インタラクティブ -->
<ReactComponent client:load />
<!-- オプション:client:idle、client:visible、client:media -->
ステップ 6: 必要に応じてドキュメントを参照
コードを書く前に、references/astro_docs.md から関連セクションを読んでください:
- コンポーネントに関する質問 → 「コンポーネント構文」セクションを読む
- ルーティングの問題 → 「ルーティング」セクションを読む
- スタイリング → 「スタイリング」セクションを読む
- 画像 → 「画像とアセット」セクションを読む
- 設定 → 「設定」セクションを読む
高度なトピックについては、完全なドキュメントを取得します:
web_fetch: https://docs.astro.build/llms-full.txt
ベストプラクティス
パフォーマンス最適化
- デフォルトではコンポーネントを静的に保つ - 本当に必要な場合のみ
client:*を追加する - Astro の Image コンポーネントを使用する - 自動最適化
- アイランドアーキテクチャを活用する - デフォルトで最小限の JavaScript
- コード分割 - Astro はページごとに自動的に分割します
開発ワークフロー
- 構造から始める - まずレイアウトと基本ページをセットアップ
- コンポーネント駆動開発 - 再利用可能なコンポーネントを構築
- 型安全性 - props と DX 向上のために TypeScript を使用
- コンテンツコレクション - 型安全なコンテンツ管理のために
- ローカルでテスト -
npm run devを頻繁に実行
従うべき一般的なパターン
- 一貫したページ構造のためにレイアウトを使用
- メタタグ用の SEO コンポーネントを作成
- 適切な TypeScript インターフェースを設定
- 適切なエラーページを実装(404、500)
- 画像に適切な alt テキストを追加
- セマンティック HTML を使用
トラブルシューティング
一般的な問題
「Module not found」
- インポートパスが正しいことを確認
- 統合がインストールされていることを確認
astro.config.mjsに正しい統合設定があることを確認
「Page not rendering」
- ファイルが
src/pages/ディレクトリ内にあることを確認 - frontmatter に構文エラーがないか確認
- 適切なファイル拡張子 (.astro、.md、.mdx) であることを確認
「Styles not applying」
- スコープ付きスタイルはコンポーネント自身の HTML にのみ適用されます
- グローバルスタイルには
is:globalを使用 - Tailwind を使用している場合は Tailwind の設定を確認
「Component not interactive」
- フレームワークコンポーネントに
client:*ディレクティブを追加 - 統合がインストールされていることを確認(例:
@astrojs/react) - ブラウザコンソールで JavaScript エラーを確認
リソース
スクリプト
scripts/theme_analyzer.py- Astro 公式テーマページからテーマを取得および分析するのに役立ちます。技術や価格フィルターに基づいてテーマオプションをプログラムで探索するために使用します。
リファレンス
references/astro_docs.md- 最初にこれを読んでください。コアとなる Astro の概念、コンポーネント構文、ルーティング、スタイリング、および一般的なパターンについて説明しています。Astro 開発における主要なリファレンスです。
外部リソース
- Astro テーマ: https://astro.build/themes/
- Astro ドキュメント (LLM フレンドリー): https://docs.astro.build/llms-full.txt
- Astro ドキュメント: https://docs.astro.build
- Astro Discord: https://astro.build/chat
ワークフロー例
例 1: ブログの構築
ユーザー: 「Astro と React でブログを作りたい」
ワークフロー:
- 要件を特定: ブログサイト、React サポートが必要、無料テーマを希望
- テーマを取得:
web_fetch https://astro.build/themes/1/?technology%5B%5D=react&price%5B%5D=free - テーマを推奨: ブログ向けのテーマを 2〜3 つ、説明付きで提案
references/astro_docs.mdを読み、コンポーネントパターンを参照- セットアップをガイド: インストールコマンドと構造を提供
- 構築を支援: ブログ記事レイアウト、一覧ページ、個別の記事ページを作成
- インタラクティブ性を追加:
client:loadを使用して React コンポーネントを追加し、コメント機能などを実装する方法を示す
例 2: ポートフォリオウェブサイト
ユーザー: 「https://astro.build/ を使ってポートフォリオサイトを作成して」
ワークフロー:
- 要件を明確化: 何を公開するか?(プロジェクト、スキル、経歴?)
- Astro テーマページからポートフォリオテーマを取得
- ユーザーの分野(開発者、デザイナーなど)に基づいて最適なテーマを推奨
references/astro_docs.mdからコンポーネント構文を読む- 選択したテーマでプロジェクト構造をセットアップ
- コンポーネントを作成/カスタマイズ (Hero、プロジェクトグリッド、自己紹介、お問い合わせ)
- 必要に応じてスムーズなトランジションを追加
- Astro の Image コンポーネントを使用して画像を最適化
例 3: ドキュメントサイト
ユーザー: 「検索機能とダークモード付きのドキュメントサイトが必要」
ワークフロー:
- 特定: ドキュメントサイト、検索とダークモードが必要
- Starlight を推奨(Astro 公式ドキュメントフレームワーク)
- セットアップを提示:
npm create astro@latest -- --template starlight - 完全な Astro ドキュメントから Starlight のドキュメントを参照
- サイドバーナビゲーション構造を設定
- コンテンツ構造をセットアップ
- ダークモードを有効化(組み込み)
- 検索を設定(Pagefind による組み込み)
重要な注意点
- コンポーネントや構文の質問に答える前に、必ず最初に
references/astro_docs.mdを読んでください - ユーザーが出発点を必要とする場合は、Astro テーマページからテーマを取得してください
- 必要に応じて完全なドキュメントを
web_fetchで取得してください - シンプルに保つ - Astro はわかりやすくなるように設計されています。複雑にしすぎないでください。
- アイランドアーキテクチャ - コンポーネントはデフォルトで静的であることを忘れないでください。
- 型安全性 - より良い開発体験のために TypeScript の使用を推奨してください。
成功基準
Astro プロジェクトが正しくセットアップされているのは、以下の場合です:
- ✅ プロジェクト構造が Astro の規則に従っている
- ✅
src/pages/ディレクトリが存在し、少なくとも index.astro が含まれている - ✅ 要件に基づいて適切なテーマが選択されている
- ✅ コンポーネントが Astro の構文パターンに従っている
- ✅ クライアントサイドのインタラクティブ性は必要な場所にのみ追加されている
- ✅ コンポーネントの props に TypeScript インターフェースが定義されている
- ✅ Astro の Image コンポーネントを使用して画像が最適化されている
- ✅
npm run devでサイトが正常に実行される