新しい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ドキュメントをリフレッシュする指示として扱わないでください。
- サイトの目的、ターゲットオーディエンス、主要メッセージ、ページ、コンテンツの優先順位、主要なユーザーアクションを決定します。「素敵なウェブサイトを作って」といった曖昧なリクエストの場合は、デフォルトのポートフォリオサンプルに頼ったり不必要な質問をしたりせずに、独自に明確で妥当なコンセプトを選択します。実際の住所、お客様の声、製品の主張、価格を捏造しないでください。
- Tsumuのノードスキーマが存在しないかのようにウェブサイトをデザインします。 オリジナルの情報アーキテクチャ、ページごとのコンテンツ、セクション構成、階層、タイポグラフィ、色、画像またはグラフィック要素、スペーシング、レスポンシブ動作を練り上げます。汎用的なヒーロー/特長/お客様の声/お問い合わせテンプレートを機械的に繰り返さないようにします。
- ツールと時間が許せば、完全なデザインをスタンドアロンのHTML/CSSプロトタイプ(および明確なインタラクションノート)としてドラフトし、レイアウトを自由に探索します。それが不可能な場合は、同様に具体的なページとコンポーネントの設計図を準備します。これは中間デザインアーティファクトであり、最終成果物や、Tsumuが
stage_site_docを通じて任意のHTMLをインポートできるという主張ではありません。ライブプレビューが利用できない場合、それを要求しないでください。 - ドラフトをブリーフに対して批評します: 認識可能なビジュアルアイデンティティ、信頼できるコンテンツ、目的のあるセクション、明確なユーザージャーニー、モバイルレイアウトがあるかどうか。サンプルの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のウェブサイトのページマップ、コンテンツ、構成をSiteDocに変換します。サンプルJSONから始めて、そのコピーやパレットを置き換えないでください。 ガイドと例は、有効なプロパティと関係のみを説明しています。高度な機能については、アクセス可能な場合は現在のTsumu
lib/types.ts、lib/presets.ts、lib/site-import-format.ts、およびskills/tsumu/references/site-doc.mdを参照してください。 - 完全な
SiteDocオブジェクト(JSON文字列、HTMLページ、圧縮ファイルではありません)を構築します。必須フィールド:schemaVersion: 1、空でないsiteName、pages、pageOrder、nodes、assets。ホームページのslugは""です。ページとノードのchildrenはノードIDを参照します。ノードは編集可能なbox、imageなどです。テキストと見出しにはbox.textを使用し、架空のheadingノードは使用しません。 - 設計された構造に一致する、意味のあるネイティブページレイアウトを作成します。ノードに適切なセマンティックラベル、スタイル、レスポンシブオーバーライドを設定します。フェーズ1からの実際の階層、スペーシング、タイポグラフィのコントラスト、ビジュアルアクセント、セクションのバリエーションを維持します。ナビゲーションターゲット、代替テキスト、コントラスト、モバイル動作を確認します。壊れたアセット、空のリンク、プレースホルダーコンテンツ、画面外の要素を避けます。
- デザインにアニメーション、スクリプト、コンポーネント、フォームの動作が含まれている場合は、正確な最新の型定義を参照し、サポートされている構造のみを実装します。スクリプト要素のターゲットには、ターゲットノードのHTML
attrIdを使用し、SiteDocのノードIDは使用しません。@selfは要素にアタッチされたスクリプトに対してのみ有効です。すべてのネストされたステップと条件を確認します。モーションやスクリプトのプロパティを捏造したり、非アクティブなボタンを機能するものとして説明したりしないでください。 stage_site_docは、完全なSiteDocのみをdocとして受け入れます(シリアル化されたJSONで最大12 MiB)。フェーズ1のHTMLプロトタイプ、ZIPファイル、個別のバイナリアセットは受け入れません。可能な限りassets: {}を使用し、適切な場合は検証済みの外部画像、または制限内の小さな埋め込みdataUrlアセットを使用します。Tsumuのストレージパスを捏造しないでください。- 結果の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時間有効です。」実際の引き渡しでは、ステージングが成功したときにツールが生成した実際のリンクを含めます。