blutui-project-guidelines について
Blutui サイトを開発・保守する人向けのプロジェクトルールをまとめたスキルです。タスク別にルールを案内し、コード変更前に Blutui MCP などでドキュメントを調べるよう促します。
主な機能
- 01タスク別のルールファイル索引
- 02テンプレートとレイアウトの規約
- 03Canvas テンプレート構文の要件
- 04Collections とフォームのガイド
- 05ドキュメント検索の要件
活用シーン
- 01ページテンプレートやコンポーネントの作成・編集
- 02Collections を使うページの構築
- 03フォーム、ナビゲーション、ルーティングの設定
MCP 対応
コード変更前に Blutui MCP の search_blutui_documentation でドキュメントを検索するよう定めており、MCP の呼び出しと連携に関するルールも含みます。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ blutui/ context --skill blutui-project-guidelinesインストール後、Claude Code で/blutui-project-guidelinesを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
AGENTS.mdrules/_sections.mdblog.mdcanopy.mdcassettes.mdcollections.mdcourier.mdforms.mdfoundation-courier-configuration.mdfoundation-file-structure.mdfoundation-templates-and-layouts.mdmcp.mdmenus.mdroute-patterns.mdtemplating-canvas.mdtemplating-including-templates.md詳細
Blutui プロジェクトガイドライン
タスクに合致するルールファイルを読み込んでください。該当するものはすべて必ず読み込んでください。複数のルールが重複して適用されることがよくあります。
ルール一覧
| タスク | 読み込むファイル |
|---|---|
| テンプレート、レイアウト、コンポーネントの作成・編集全般 | rules/foundation-templates-and-layouts.md |
| Canvas テンプレート構文(タグ、フィルター、関数)の記述 | rules/templating-canvas.md |
| 他のテンプレートのインクルード/埋め込み | rules/templating-including-templates.md |
| コレクションの操作(データのクエリ、表示) | rules/collections.md |
| ブログ一覧または投稿ページの作成 | rules/blog.md |
| フォームの作成または処理 | rules/forms.md |
| サイトナビゲーションの構築(ヘッダー、フッター、ドロップダウン) | rules/menus.md |
| ルーティングまたは URL パターンの設定 | rules/route-patterns.md |
| Courier の設定 | rules/courier.md、rules/foundation-courier-configuration.md |
| プロジェクトのファイル構成/新規プロジェクトの開始 | rules/foundation-file-structure.md |
| バージョン管理/カセットの切り替え | rules/cassettes.md |
| Blutui MCP の呼び出しまたは MCP インテグレーションの作成 | rules/mcp.md |
| Canopy Blocks の使用(ページ内エディター) | rules/canopy.md + blutui-canopy-blocks スキル |
ルールファイルの場所:rules/<rule-name>.md
コアルール(常に適用)
- テンプレートは HTML のシェルであり、レイアウトはエディターが選択するページタイプです。 テンプレート(
views/templates/)は、すべてのページを囲む外側の構造を定義します。テンプレートは開発者が管理し、エディターが編集することはありません。レイアウト(views/layouts/)はテンプレートを拡張し、エディターがダッシュボードでページを作成する際に選択する個々のページデザインを表します。rules/foundation-templates-and-layouts.mdを参照してください。 - テンプレート処理のロジックにはすべて Canvas を使用してください。
rules/templating-canvas.mdを参照してください。 - 構造化コンテンツはテンプレートにハードコードせず、コレクションに保存してください。
rules/collections.mdを参照してください。 - 生の HTML フォームは決して作成せず、Blutui のフォームタグを使用してください。
rules/forms.mdを参照してください。 - 新しいトップレベルディレクトリを作成しないでください。
rules/foundation-file-structure.mdを参照してください。 - まずドキュメントを検索してください。 コードを変更する前に、Blutui MCP 経由で
search_blutui_documentationを使用してください。rules/mcp.mdを参照してください。
リファレンス全体
すべてのルールをまとめたドキュメント:AGENTS.md
包括的なリファレンスが必要な場合や、どのルールが適用されるかわからない場合は、AGENTS.md を使用してください。
コメント
Markdown 対応