SiteKit は何をしますか?
SiteKitは、フェーズ指向のパイプライン(発見→読み込み→エンリッチメント→ページレンダリング→システムレンダリング→出力処理、さらにコンテンツに依存しないアセットテレポート)を中心に構築された、AIファーストのSwift静的サイトジェネレーターです。各フェーズは1つのSwiftプロトコルで構成されます。サイトはSiteBuilderファクトリメソッド(.blog()、.podcast()、.newsletter()、.portfolio()、.docs()、.docc())で構成し、プラグインの追加や差し替えによって流暢にカスタマイズできます。
プロセス
ユーザーの意図を適切なリファレンスにルーティングします。現在のタスクに必要なリファレンスのみを読んでください。
| ユーザーが次のような質問をした場合… | 次を読む… |
|---|---|
SiteKitのインストール + 最初のサイトの足場作り(sitekit CLI) | references/bootstrap.md |
| 新しいサイトをゼロからセットアップする | references/onboarding.md |
| ブループリント(Blog、Newsletter、Podcast、Portfolio、AppLanding、Snippets、IndieDev、DocC、Plain)の選択 | references/blueprints.md |
| コンテンツ作成(ブログ記事、ニュースレター発行、静的ページ) | references/content-writing.md |
| インプリント / プライバシー / リーガルページ(国依存、GDPR、クッキー) | references/legal-pages.md |
DocC / Markdownディレクティブ拡張(@Metadata、@Row、@TabNavigator、@Video、@Image、@Links、…)+ グレースフルデグラデーション契約 | references/markdown-extensions.md |
| 多言語サイト(翻訳、ロケールサフィックス、バリデーション) | references/localization.md |
| アクセシビリティ監査(WCAG AAコントラスト、altテキスト、キーボードナビゲーション) | references/accessibility.md |
| SEO + ASO + AI発見可能性(正規URL、OG、JSON-LD、llms.txt) | references/seo-aso.md |
| パフォーマンス / PageSpeedの調査結果(LCP、CLS、レンダリングブロック) | references/performance.md |
| サイトのデプロイ(ホスト + CIプロバイダマトリックス) – ここから開始 | references/deployment/SKILL.md |
| テーマのカスタマイズ(プリセット、カラースキーム、フォントペアリング、トークン) | references/themes.md |
新しいHTMLページタイプのためのカスタムPageの追加 | references/custom-pages.md |
パイプラインの拡張(Loader、Enricher、Renderer、OutputProcessor、Teleporter) | references/architecture.md |
| ビルド / ランタイムのトラブルシューティング | references/troubleshooting.md |
| セルフホスト型ニュースレターのセットアップ(Keila + SMTP) | references/newsletter-setup.md |
| 外部サービスの選択(メール送信、インテグレーション) | references/external-services.md |
SiteConfig.yaml フィールドリファレンス | references/siteconfig-reference.md |
デプロイ – プロバイダに直接ジャンプ
references/deployment/SKILL.md はオーケストレーターです。Package.swift のバリアントを検出し、セットアップモードを確認し、CLI認証を処理してから、1つのCI + 1つのホストファイルにルーティングします。新しいデプロイの場合はそこから始めてください。ターゲットがすでにわかっている場合(例:既存のデプロイの再設定)は、直接ジャンプしてください:
| ユーザーが次のような質問をした場合… | 次を読む… |
|---|---|
| GitHub Actions 上のCI | references/deployment/ci/github-actions.md |
| GitLab CI 上のCI | references/deployment/ci/gitlab-ci.md(コミュニティ; プレースホルダー) |
| Xcode Cloud 上のCI | references/deployment/ci/xcode-cloud.md(コミュニティ; プレースホルダー) |
| Bitrise 上のCI | references/deployment/ci/bitrise.md(コミュニティ; プレースホルダー) |
| Cloudflare Pages でのホスティング | references/deployment/hosts/cloudflare-pages.md |
| GitHub Pages でのホスティング | references/deployment/hosts/github-pages.md |
| Netlify でのホスティング | references/deployment/hosts/netlify.md |
| Vercel でのホスティング | references/deployment/hosts/vercel.md |
| サポートされているCIプロバイダ / 新しいCIプロバイダの追加 | references/deployment/ci/README.md |
| サポートされているホスト / 新しいホスティングプロバイダの追加 | references/deployment/hosts/README.md |
直接ジャンプすると、オーケストレーターのセットアップモードとPackage.swiftの検出をスキップします。これらがすでに確定している場合にのみ行ってください。
コア語彙(常に利用可能)
- ブループリント – サイトタイプのレシピ。
SiteBuilderはファクトリメソッド(.blog()、.podcast()、.newsletter()、.portfolio()、.docs()、.docc())を公開し、各サイトタイプのデフォルトプラグインリストを事前に構成します。Plugin/blueprints/以下のディスク上のブループリントは、プラグインがクローンできるスターターサイトです。 - Page – HTMLページレンダリングのためのユーザー向けプロトコル。
Rendererのサブプロトコルです。準拠する型はpages(in:)とrenderHTML(_:context:)を実装します。PageShell.wrap(content:page:context:)は標準の<head>/<header>/<footer>のクロムを自動適用します。 - Renderer – システムレベルの出力プロトコル。
scope: .perLocale(デフォルト – ロケールごとに1回実行)または.global(ビルドごとに1回だけ実行。サイトマップ、robots、llms.txt、Cloudflare_headersに使用)を宣言します。パイプラインはscopeによってディスパッチします。 SiteBuilder– 不変で流暢なビルダー。すべての設定メソッド(.renderer、.enricher、.processor、.teleporter、…)は新しいSiteBuilderを返します。.run()はCLI動詞(build、serve、validate)を読み取り、パイプラインを実行します。BuildContext– フェーズ3~6のすべてのプラグインに渡される読み取り専用の状態。config、themeConfig、sections、staticPages、tags、homeContent、router、uiStrings、outputDirectory、projectDirectoryを保持します。- ビルドコマンド –
swift run Site buildはサイトを_Site/に書き込みます。swift run Site serveは開発サーバー(デフォルト:8080)を起動します。swift run Site validateは多言語サイトの翻訳の完全性をチェックします(単一言語サイトは自動的にパスします)。build/serveでの--base-url <url>は、そのパスのSiteConfig.baseURLをオーバーライドします(ステージングデプロイ用)。
スタイルに関する注意
このスキルを使ってサイトコンテンツを生成するときは、本物の個人開発者の声を保ってください。短い段落。人称代名詞。企業的な曖昧な表現は避けてください。完全な著者ボイスガイドと学習ループの指示はreferences/content-writing.mdにあります。
パイプライン概要
| フェーズ | プロトコル | 拡張場所 |
|---|---|---|
| 0. アセットテレポート(コンテンツ非依存) | Teleporter | .teleporter(_:) |
| 1. 発見 | ContentDiscovery | .contentDiscovery(_:) |
| 2. 読み込み | Loader<Source, Output> | .articleLoader(_:), .staticPageLoader(_:) |
| 3. エンリッチメント | Enricher | .enricher(_:) |
| 4. ロケールごとのHTMLページ | Page(Rendererのサブプロトコル) | .renderer(_:) |
| 5. システムレンダリング | Renderer + RenderScope | .renderer(_:) |
| 6. 出力処理 | OutputProcessor | .processor(_:) |
完全なアーキテクチャの根拠と各拡張ポイントの実例については、references/architecture.mdとreferences/custom-pages.mdを読んでください。
関連項目
タスクが上記のリファレンスでカバーされていない場合 – つまり、SiteKitを使ってサイトを構築するのではなく、SiteKit自身のSwiftライブラリを変更している場合 – リポジトリルートのコントリビューターリファレンスAGENTS.md(パイプライン内部、フェーズプロトコル、SiteBuilderのスワップポイント、ビルドおよびテストコマンド)にエスカレーションしてください。
人間向けドキュメントとこれらのリファレンスの両方をカバーするタスク→ドキュメントのインデックスについては、リポジトリルートの../../../USE-CASES.mdを参照してください。