Sitesmith — 会話型ウェブサイトビルダー
数回の会話で、完成した(オプションでバイリンガル対応の)ウェブサイトを構築し、公開します。コードではなくデータ、すなわち単一の site.json を生成します。この JSON は固定の、よく設計されたテンプレートによってレンダリングされるため、出力が安定し、後から見た目を変更することも容易です。
使用するタイミング
ユーザーがウェブサイト、ランディングページ、個人・ビジネスサイト、ポートフォリオを作成・更新したい場合。例:「サイトを作って」「我想做个网站」「ホームページを更新して」「パン屋のランディングページを作って」。
クイックリファレンス
参考ファイル — skill_view("sitesmith", "<パス>") で必要に応じて読み込んでください。
references/site.schema.json— すべてのsite.jsonが満たすべき契約(スキーマ)references/sections.md— 14 種類のセクションタイプ(postsを含む):使用タイミング、フィールド、コピーの制限references/theme.md— テーマトークン(テンプレート、色、フォント、角丸、密度)references/assets.md— 画像戦略(プレースホルダー / Unsplash;アセットの捏造禁止)references/examples/innoe.site.json— 完全な単一ページの例(Few-shot 用)references/examples/multipage.site.json— 複数ページ+ブログの例(Few-shot 用)
スクリプット — ターミナルツール経由で実行します。
| アクション | コマンド |
|---|---|
| バリデーション | node ${HERMES_SKILL_DIR}/scripts/validate.mjs <site.json> |
| レンダリング | node ${HERMES_SKILL_DIR}/scripts/render.mjs <site.json> <out-dir> |
| デプロイ | bash ${HERMES_SKILL_DIR}/scripts/deploy.sh <out-dir> <domain> |
手順
-
ヒアリング(3〜5ターン、質問はまとめて — 尋問しないでください)。
- ビジネス名+一行で事業内容;業種+顧客層。
- 主な目的(電話/予約/登録/販売/作品展示)。
- 言語 — デフォルトはチャット言語;バイリンガル(例:en + zh)を提案。
- スコープ:単一ページ or 複数ページ? デフォルトは単一ページ。ユーザーがさらにページを希望する場合(またはブログに言及した場合)、標準セット(Home / About / Services / Blog / Contact)を提案し、ユーザーに取捨選択してもらいます — ページ一覧を確定してから構築に進みます。
- 主なサービス・製品 3〜5 個;差別化ポイント;実際の数字;連絡先+主要な Call to Action。
- 一言または二言で雰囲気(→
theme);アセット(ロゴ?ブランドカラー?実際の写真?) - ユーザーが簡潔だったり「適当にいい感じにして」と言った場合は、妥当なデフォルト(単一ページが安全なデフォルト)で進めてください。
-
site.jsonの作成references/site.schema.jsonに準拠すること。まず該当する例(単一ページならinnoe.site.json、複数ページならmultipage.site.json)を学習してください。実際の内容に合ったセクションをページあたり 5〜8 個選びます(references/sections.mdの目標→セクションの対応表を参照)。- 単一ページ: すべてトップレベルの
sectionsに配置。 - 複数ページ: ホームはトップレベルの
sectionsに;pages[]を追加(サブページごとに 1 エントリ、各エントリは独自のsectionsを持つ)。ナビゲーションはページから自動生成されます。ブログはpostsセクションを持つページとして扱います(軽量:ヘッドラインカード、記事ページはなし)。 ルックを選択(references/theme.md参照):ブランドに強い明確な美学がある場合はスタイル付きテンプレート(newchinese/cyber/portfolio)を選択するか、またはデフォルトとしてtemplate:"pro"を使用し、独自のパレットを自分でデザイン(primary/accent/neutral/font/radius/density)してください。各サイトが一点ものになります。画像はすべてreferences/assets.mdに従って処理します。
- 単一ページ: すべてトップレベルの
-
バリデーション。
validate.mjsを実行。失敗した場合はエラーを読み、JSON を修正し、再実行。無効なファイルで先に進まないでください。 -
レンダリング。
render.mjs <site.json> <out-dir>を実行 → 静的サイトが<out-dir>/distに生成されます。UNSPLASH_ACCESS_KEYが設定されている場合、レンダリングは自動的にunsplashプレースホルダーを実際の写真(クレジット付き)に置き換えます。設定がない場合はテーマ付きプレースホルダーがレンダリングされます — どちらでも出荷可能です。 -
プレビューと反復。 構築した内容を平易な言葉で要約します(「5 ページのバイリンガルサイト:Home, About, Services, Journal, Contact」または「6 セクションの単一ページ」)。サイトは完全に編集可能であることをユーザーに伝えてください — いつでもページやセクションの追加・削除、コピーの書き換え、色の変更、ブログ記事の追加を依頼できます。編集は完全な
site.jsonを再出力し、再バリデーション+再レンダリングによって適用します。 -
デプロイ(ユーザーがプレビューを承認した後にのみ)。
deploy.sh <out-dir> <domain>を実行 → Nginx + HTTPS で公開。公開 URL を報告します。
落とし穴
- 出力はデータであり、コードではありません。
site.jsonのみを生成してください。HTML/CSS を手書きしてはいけません。 - スキーマがルールです。 フィールド名と enum 値は正確に一致させてください。未知のフィールドは省略します。
- アセットの捏造禁止。 Media の
type:"placeholder"(装飾用)または"unsplash"とquery(コンテンツ写真)を使用してください;"image"はユーザーから提供された実際の URL がある場合のみ使用します。ロゴは実際のロゴファイルがない限り、デフォルトでtype:"text"とします。 - 機能・サービスには画像よりアイコンを優先。 Lucide 名は常にレンダリングされ、色も変更できます。
- すべての LocalizedText はサイトの全言語を保持します。 慣用的に翻訳し、空白のままにしないでください。
- 作りすぎないでください。 5〜8 セクション。セクションの背景は交互に変更し、
darkやprimaryが連続しないようにします。必ずheroで始め、ctaまたはcontactで閉じます。 - コンプライアンスリスクのある主張は禁止 — ユーザーが明言していない認定、推薦、政府の補助金・助成金、賞、統計情報を捏造してはいけません。
- 単一ページがデフォルトです。 ユーザーがリッチな/複数ページのサイトやブログを希望する場合にのみ
pages[]を追加し、事前にページ一覧をユーザーと確認してください。ブログ(posts)はヘッドライン一覧であり、完全な記事ではありません。そのように伝え、記事は後から追加可能であることを伝えてください。
検証
validate.mjsが終了コード0で終了すること(解決されたセクション順序が表示されます)。render.mjsが<out-dir>/dist/index.htmlを生成すること。- デプロイ後、
curl -I https://<domain>が200を返すこと。