Communitygithub.com

FlineDev/SiteKit

SiteKit、AIファーストのSwift静的サイトジェネレーターを使って、Webサイトの構築、カスタマイズ、デプロイを行います。新しいWebサイトの作成、SiteKitプロジェクトの足場作り、コンテンツ作成、デプロイ、テーマのカスタマイズ、カスタムPageやRendererによる既存SiteKitサイトの拡張に使用します。

SiteKit とは?

SiteKitは、AIとの連携を第一に設計されたSwift製の静的サイトジェネレーターです。発見(Discovery)→読み込み(Loading)→エンリッチメント(Enrichment)→ページレンダリング(Page rendering)→システムレンダリング(System rendering)→出力処理(Output processing)という**フェーズ指向のパイプライン**を採用しており、各フェーズはSwiftプロトコルとして定義されています。SiteBuilderのファクトリメソッド(`.blog()`、`.podcast()`、`.newsletter()`、`.portfolio()`、`.docs()`、`.docc()`)でサイトを構成し、プラグインの追加や差し替えで柔軟にカスタマイズできます。特に開発者とAIエージェント(Claude Code、Cursor、Codexなど)が協調してサイトを構築するユースケースに最適化されており、Markdown拡張、多言語対応、アクセシビリティ監査、SEO/ASO、パフォーマンス最適化、様々なCI/CDサービス(GitHub Actions、GitLab CI、Xcode Cloud、Bitrise)とホスティング先(Cloudflare Pages、GitHub Pages、Netlify、Vercel)へのデプロイをサポートします。このスキルを使用することで、AIエージェントはユーザーの意図を適切なリファレンスにルーティングし、SiteKitプロジェクトのあらゆる側面を効率的に支援できます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FlineDev/SiteKit/tree/HEAD/Plugin/skills/sitekit

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

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

ドキュメント

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 上のCIreferences/deployment/ci/github-actions.md
GitLab CI 上のCIreferences/deployment/ci/gitlab-ci.md(コミュニティ; プレースホルダー)
Xcode Cloud 上のCIreferences/deployment/ci/xcode-cloud.md(コミュニティ; プレースホルダー)
Bitrise 上のCIreferences/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を参照してください。

関連スキル