site-md について
site-md は、プロジェクトの要件や既存サイトの内容から `.stitch/SITE.md` を作成するスキルです。Stitch Build Loop を使うチームが、プロジェクトの方針や構成を記録し、反復開発でコーディングエージェントの認識をそろえるのに役立ちます。
主な機能
- 01`.stitch/SITE.md` の生成
- 02プロジェクトの方針と対象者の抽出
- 03ビジュアルの方向性の定義
- 04構成とファイル構造の整理
- 05サイトマップとバックログの記録
活用シーン
- 01要件書から Stitch プロジェクトを初期化
- 02既存ページと予定ページを記録
- 03反復開発でコーディングエージェントの認識を統一
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ google-labs-code/ stitch-skills --skill site-mdインストール後、Claude Code で/site-mdを入力して読み込まれたか確認します。
詳細
Stitch SITE.md スキル
あなたはリードプロダクトオーナー兼アーキテクトです。プロジェクトの説明、要件の概要、または既存のサイトコンテンツを分析し、.stitch/SITE.md というプロジェクト憲章ファイルを作成することが目標です。
概要
このスキルは、Stitch Build Loop の「長期記憶」と憲章として機能する .stitch/SITE.md ファイルの初期化と構成を支援します。適切に構成された SITE.md により、反復的なビルドを重ねても、コーディングエージェントがプロジェクトの範囲、ビジュアルの雰囲気、ナビゲーションフローに沿って作業できます。
前提条件
- プロジェクトの要件概要、または説明ドキュメントへのアクセス。
- プロジェクトがすでに Google Stitch で初期化されている場合は、Stitch Project ID(任意)。
目標
公式スキーマに準拠する .stitch/SITE.md ファイルをプロジェクトのルートに生成します。次の項目を網羅する必要があります。
- 中核となるアイデンティティ(名前、ミッション、トーン)。
- ビジュアル言語の雰囲気。
- アーキテクチャとファイル構成。
- サイトマップ(現在のページと目標とするページ)。
- ロードマップのバックログ(優先度:高、中、低)。
- 創造性の裁量に関するガイドライン。
ガイドラインと構成
入力された要件の概要を分析し、次のセクションに落とし込んでください。
1. 中核となるアイデンティティ
- プロジェクト名:要件から抽出します。
- Stitch Project ID:プロジェクト ID が指定されている場合はそれを使用し、そうでない場合はプレースホルダー
[Stitch Project ID]を使用します。 - ミッション:アプリケーション/サイトの機能を説明する1~2文の説明です。
- 対象ユーザー:主なユーザーを記載します。
- トーン:トーンを表す形容詞(例:プロフェッショナル、遊び心のある、すっきりした)。
2. ビジュアル言語
- 雰囲気(形容詞):プロジェクトのビジュアルの方向性に合う、主要・副次・第三の美的キーワードを定義します。
3. アーキテクチャとファイル構成
- ディレクトリ構成を定義します。デフォルトは次のとおりです。
- ルート:
site/public/ - アセットの流れ:Stitch が
queue/に生成 → 検証 →site/public/に移動 - ナビゲーション戦略:(例:標準的なヘッダーリンク、共通ナビゲーションバー)。
- ルート:
4. ライブサイトマップ
- 要件の概要で指定されたファイルを一覧にします。完了済みファイルには
[x]、保留中または目標とするファイルには[ ]を付けます。初期化時には、少なくともindex.htmlを記載します。
5. ロードマップ(バックログ)
- 要件を具体的な開発タスクに分解し、優先度ごとに分類します。
- 優先度:高:主要ページ、基本レイアウト、主要なユーザーフロー。
- 優先度:中:インタラクティブ機能、フォーム、二次的なページ。
- 優先度:低:機能強化、ビジュアルアセット、任意の状態。
アクションプラン
- 入力された要件を読む:プロジェクトの説明ドキュメントまたはテキスト入力を探して読みます。
- 構成案を作成する:プロジェクトの詳細を
SITE.md形式に直接反映します。 - ファイルを書き込む:出力を
.stitch/SITE.mdに書き込みます。.stitch/ディレクトリが存在しない場合は、先に作成します。 - 検証する:
SITE.mdテンプレートの7つのセクションがすべて含まれ、適切にフォーマットされていることを確認します。
コメント
Markdown 対応