Communitygithub.com

tsumu-build-site

デザインスキル。新しい編集可能なTsumuウェブサイトやランディングページをスクラッチから作成し、マルチページ、レスポンシブ、アニメーション対応のデザインを施した後、ワンタイムのTsumuインポートリンクを自動的にユーザーに提供します。既存サイトの変更には使用しません。

tsumu-build-site とは?

このスキルは、新しいTsumuウェブサイトをゼロからデザインして構築するためのものです。単なるデザイン案やスクリーンショット、HTMLモックアップではなく、実際にTsumuエディタで編集可能なサイトを生成します。成果物は `stage_site_doc` ツールによって生成されるプライベートなインポートリンクであり、ユーザーはこのリンクを開くことでサイトを直接インポートできます。 スキルは2段階のワークフローを採用しています。第1フェーズでは、Tsumuのノードスキーマに依存せずに、オリジナルのウェブサイトコンセプトを自由にデザインします。情報アーキテクチャ、ページ構成、タイポグラフィ、配色、レスポンシブ動作などを独立して決定します。第2フェーズでは、そのデザインをTsumuのSiteDoc形式に変換します。このとき、サンプルJSONを単に置き換えるのではなく、設計した独自のレイアウト、コンテンツ、インタラクションを維持します。 対応プラットフォームはTsumuで、MCP(Model Context Protocol)ツール `stage_site_doc`、`get_site_doc_spec` を使用します。スキルは、生成されたサイトが本当にオリジナルであり、単なるテンプレートの焼き直しでないことを確認するための厳格なチェックを含んでいます。また、アニメーションやスクリプトを追加する際には、Tsumuの正確な型定義に従い、サポートされている構造のみを実装する必要があります。 このスキルは、既存のサイト編集(`tsumu-edit-site`)ではなく、新規サイト作成専用です。`create_site` ツールは空のサイトをブラウザローカルに作成するものであり、本スキルの代わりとして使用してはいけません。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abshrimp/tsumu-mcp/tree/HEAD/plugins/claude/skills/tsumu-build-site

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

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

ドキュメント

新しいTsumuウェブサイトを作成する

ユーザーがTsumuで 新しいウェブサイト を作成するよう依頼した場合に使用します。成果物は、実際に編集可能なTsumuサイトであり、デザインの説明、スクリーンショット、HTMLモックアップ、空のサイトではありません。

成果物: プライベートなTsumuインポートリンク

ユーザーから依頼された新しいサイトの場合、stage_site_doc の正常な結果には importUrl が含まれます。これが依頼者が生成されたサイトをTsumuで開くための受け渡し成果物です。構築された内容の簡単な説明とともに、その正確なリンクを含めてください。リンクを改めて要求する必要はありません。このリンクはプライベートであり、ログ、無関係なコンテキスト、またはサードパーティのサービスにコピーしてはいけません。決してリンクを捏造したり再構築したりしないでください。

ステージングされたリンクは、インポート、公開、またはデプロイが行われたことを証明するものではありません。これらのアクションが発生したと主張しないでください。

ワークフローの選択

  • 新しいサイトを作成する: 既存のサイトがペアリングされていない場合でも、直接 stage_site_doc を使用します。ユーザーはMCP OAuth画面で 新規サイト作成のみ を、サイト接続コードなしで承認できます。既存のペアリング済みサイトの許可でも、新しいサイトをステージングできる場合があります。
  • 代わりにユーザーの既存サイトを編集する: tsumu-edit-site を有効にし、ペアリングされたエディタツールを使用します。既存サイトのコピーをステージングしたり、上書きしたりしないでください。
  • ステージングツールがない、または正常に認証されていない場合: URLを捏造しないでください。アーティファクト作成が利用可能な場合は、有効なダウンロード可能な doc.json を生成します。それ以外の場合は、不足している機能と可能な対応を説明します。
  • create_site は、すでにペアリングされたエディタ内に空のブラウザローカルサイトを作成するためのものです。完全な生成デザインをアップロードするわけではなく、新しいサイトを再度ペアリングする必要があります。stage_site_doc の代わりとして使用しないでください。

2パス作成: 自由にデザインしてからTsumuに変換

フェーズ 1 — SiteDoc形式で作業する前に、オリジナルのウェブサイトコンセプトを作成します。 ユーザーのリクエストをウェブサイトデザインブリーフとして扱い、サンプルJSONドキュメントをリフレッシュする指示として扱わないでください。

  1. サイトの目的、ターゲットオーディエンス、主要メッセージ、ページ、コンテンツの優先順位、主要なユーザーアクションを決定します。「素敵なウェブサイトを作って」といった曖昧なリクエストの場合は、デフォルトのポートフォリオサンプルに頼ったり不必要な質問をしたりせずに、独自に明確で妥当なコンセプトを選択します。実際の住所、お客様の声、製品の主張、価格を捏造しないでください。
  2. Tsumuのノードスキーマが存在しないかのようにウェブサイトをデザインします。 オリジナルの情報アーキテクチャ、ページごとのコンテンツ、セクション構成、階層、タイポグラフィ、色、画像またはグラフィック要素、スペーシング、レスポンシブ動作を練り上げます。汎用的なヒーロー/特長/お客様の声/お問い合わせテンプレートを機械的に繰り返さないようにします。
  3. ツールと時間が許せば、完全なデザインをスタンドアロンのHTML/CSSプロトタイプ(および明確なインタラクションノート)としてドラフトし、レイアウトを自由に探索します。それが不可能な場合は、同様に具体的なページとコンポーネントの設計図を準備します。これは中間デザインアーティファクトであり、最終成果物や、Tsumuが stage_site_doc を通じて任意のHTMLをインポートできるという主張ではありません。ライブプレビューが利用できない場合、それを要求しないでください。
  4. ドラフトをブリーフに対して批評します: 認識可能なビジュアルアイデンティティ、信頼できるコンテンツ、目的のあるセクション、明確なユーザージャーニー、モバイルレイアウトがあるかどうか。サンプルのSiteDocレイアウトを参照する前に改良します。

フェーズ 2 — そのデザインをネイティブで編集可能なTsumu SiteDocに変換します。 ここでのみ get_site_doc_spec、スキーマガイド、最小限の例を参照して有効なデータ構造を学びます。サイトの見た目を決定するためではありません。設計したページとレイアウトを、Tsumuがサポートするネイティブ要素、スタイル、アセット、インタラクションを使用して再構築します。中間デザインの明確な構成、タイポグラフィ、スペーシング、コンテンツ、レスポンシブの意図を、色を変えたサンプルに縮退させるのではなく維持します。サポートされていない詳細がある場合は、最も近い有効な編集可能な表現に適合させるか、制限事項を開示します。スキーマフィールドを決して捏造しないでください。

オリジナリティチェック: 変換されたSiteDocをフェーズ1のデザインと比較してからステージングします。最終サイトが、言葉、色、画像を変更しただけのバンドルされたサンプルと本質的に同じである場合、変換は失敗しています。構造と構成を再設計します。ユーザーが特定のテンプレートを明示的に要求した場合は、その要求に従います。

オリジナルデザインをSiteDocに変換する

SiteDocを構築する前に: 読み取り専用のMCPツール get_site_doc_spec を呼び出し、その guide と example の両方を検査します。これはオリジナルデザインを計画した後、SiteDocのページ、ノード、スタイル、スクリプト、または最初の stage_site_doc 試行を作成する前に行います。このリファレンスは、新規サイトのみのOAuth許可で利用可能です。スキルテキストが読み込まれたからといってこれをスキップしないでください。一部のMCPクライアントはリファレンスを自動的に取得しません。specツールが利用できない場合は、代わりに references/site-doc.md と references/minimal-site.json を読み込んでください。データ構造を推測しないでください。

  1. フェーズ1のウェブサイトのページマップ、コンテンツ、構成をSiteDocに変換します。サンプルJSONから始めて、そのコピーやパレットを置き換えないでください。 ガイドと例は、有効なプロパティと関係のみを説明しています。高度な機能については、アクセス可能な場合は現在のTsumu lib/types.ts、lib/presets.ts、lib/site-import-format.ts、および skills/tsumu/references/site-doc.md を参照してください。
  2. 完全な SiteDoc オブジェクト(JSON文字列、HTMLページ、圧縮ファイルではありません)を構築します。必須フィールド: schemaVersion: 1、空でない siteName、pages、pageOrder、nodes、assets。ホームページの slug は "" です。ページとノードの children はノードIDを参照します。ノードは編集可能な box、image などです。テキストと見出しには box.text を使用し、架空の heading ノードは使用しません。
  3. 設計された構造に一致する、意味のあるネイティブページレイアウトを作成します。ノードに適切なセマンティックラベル、スタイル、レスポンシブオーバーライドを設定します。フェーズ1からの実際の階層、スペーシング、タイポグラフィのコントラスト、ビジュアルアクセント、セクションのバリエーションを維持します。ナビゲーションターゲット、代替テキスト、コントラスト、モバイル動作を確認します。壊れたアセット、空のリンク、プレースホルダーコンテンツ、画面外の要素を避けます。
  4. デザインにアニメーション、スクリプト、コンポーネント、フォームの動作が含まれている場合は、正確な最新の型定義を参照し、サポートされている構造のみを実装します。スクリプト要素のターゲットには、ターゲットノードのHTML attrId を使用し、SiteDocのノードIDは使用しません。@self は要素にアタッチされたスクリプトに対してのみ有効です。すべてのネストされたステップと条件を確認します。モーションやスクリプトのプロパティを捏造したり、非アクティブなボタンを機能するものとして説明したりしないでください。
  5. stage_site_doc は、完全なSiteDocのみを doc として受け入れます(シリアル化されたJSONで最大12 MiB)。フェーズ1のHTMLプロトタイプ、ZIPファイル、個別のバイナリアセットは受け入れません。可能な限り assets: {} を使用し、適切な場合は検証済みの外部画像、または制限内の小さな埋め込み dataUrl アセットを使用します。Tsumuのストレージパスを捏造しないでください。
  6. 結果のSiteDocを、サンプルの美学ではなく、元のデザインに対してレビューします。完全に編集可能で構造的に有効であることを確認します。変換によって独自のレイアウトやコンテンツが失われる場合は、ステージングする前にネイティブ要素の階層を改善します。

確認と引き渡し

  • ステージングする前に、最終ページをフェーズ1のデザインと比較し、それらが忠実で独立して構成されたウェブサイトであり、色を変えただけの最小限のサンプルではないことを確認します。ユーザーが要求しない限り、中間デザインはプライベートに保ちます。成果物としてSiteDocまたはインポートリンクを引き渡します。
  • ステージングする前に、すべての可視デザイン宣言が nodes[id].styles.base.default または関連するレスポンシブオーバーライドに配置されており、架空の style、css、className フィールドに配置されていないことを確認します。実際のCSS宣言値は文字列である必要があります。ID、参照、非巡回ツリー、インポートルールを確認します。ツールが許す範囲で、ページ階層、レスポンシブ性、要求されたインタラクションを確認します。実際にプレビューしない限り、プレビューしたとは言わないでください。
  • stage_site_doc({ doc: <完全なSiteDoc> }) を呼び出します。ユーザーが特定のセルフホスト型Tsumuインストールを要求した場合にのみ editorOrigin を使用します。
  • 新しいサイトの正常な引き渡しには、ツールの正確な importUrl をクリック可能なリンクとして、さらにそれを開くと新しい編集可能なサイトがインポートされるという簡単な説明を含めます。このリンクは公開されたサイトのURLではありません。
  • 失敗した場合は、実際のエラーを述べ、サイトが保存されたと主張しないでください。失敗したツールアクションを捏造したリンクに置き換えたり、既存のサイトに静かに切り替えたりしないでください。
  • このリンクはURLフラグメント内にプライベートアクセストークンを含み、1時間で期限切れになり、Tsumuがインポート成功を確認した後に消費されます。他者に開示しないでください。インポートに失敗した場合、一時的な5分間のクレームリースが切れた後に再試行できる場合があります。

引き渡し例(説明のみ): 「編集可能なカフェサイトがインポート用にステージングされました。プライベートなTsumuインポートリンクは次の1時間有効です。」実際の引き渡しでは、ステージングが成功したときにツールが生成した実際のリンクを含めます。

関連スキル