sanity-best-practices
Sanityのスキーマ設計・GROQクエリ・TypeGen・Visual Editing・Portable Text・Studioの構成・ローカライゼーション・マイグレーション・Sanity Functions・BlueprintsおよびNext.js・Nuxt・Astro・Remix・SvelteKit・Angular・Hydrogen等のフレームワーク連携に関するベストプラクティスを提供するスキル。`defineType`・`defineField`・`defineQuery`・`documentEventHandler`・`defineDocumentFunction`・`@sanity/functions`・`sanity.blueprint.ts`などを使った実装やSanityコードベースのレビュー・修正を行う際に活用してください。
description の原文を見る
Sanity development best practices for schema design, GROQ queries, TypeGen, Visual Editing, images, Portable Text, Studio structure, localization, migrations, Sanity Functions, Blueprints, and framework integrations such as Next.js, Nuxt, Astro, Remix, SvelteKit, Angular, Hydrogen, and the App SDK. Use this skill whenever working with Sanity schemas, defineType or defineField, GROQ or defineQuery, content modeling, Presentation or preview setups, Sanity-powered frontend integrations, Sanity Functions, documentEventHandler, defineDocumentFunction, defineMediaLibraryAssetFunction, @sanity/functions, @sanity/blueprints, sanity.blueprint.ts, event-driven content automation, or when reviewing and fixing a Sanity codebase.
SKILL.md 本文
Sanity Best Practices
Sanityが提供する、Sanity開発に関する包括的なベストプラクティスと統合ガイド。以下のクイックリファレンスを使用して、タスクに合致する1つまたは2つのトピックファイルのみを読み込んでください。
適用する場合
以下の場合にこれらのガイドラインを参照してください:
- 新しいSanityプロジェクトのセットアップまたはオンボーディング
- SanityとフロントエンドフレームワークBの統合(Next.js、Nuxt、Astro、Remix、SvelteKit、Hydrogen)
- GROQクエリの記述またはパフォーマンスの最適化
- コンテンツスキーマの設計
- Visual Editingとライブプレビューの実装
- 画像、Portable Text、またはページビルダーの操作
- Sanity Studio構造の設定
- 型安全性のためのTypeGenのセットアップ
- ローカライゼーションの実装
- 他のシステムからのコンテンツマイグレーション
- Sanity App SDKでのカスタムアプリ構築
- Blueprintsでのインフラストラクチャ管理
- Sanity Functionsでのコンテンツワークフロー自動化
クイックリファレンス
統合ガイド
get-started- 新しいSanityプロジェクト向けインタラクティブオンボーディングnextjs- Next.js App Router、Live Content API、埋め込みStudionuxt- @nuxtjs/sanityを使用したNuxt統合angular- @sanity/client、signals、resource APIを使用したAngular統合astro- @sanity/astroを使用したAstro統合remix- React Router / Remix統合svelte- @sanity/svelte-loaderを使用したSvelteKit統合hydrogen- Shopify HydrogenとSanityproject-structure- Monorepoと埋め込みStudioのパターンapp-sdk- Sanity App SDKでのカスタムアプリケーションblueprints- Sanity Blueprintsを使用したInfrastructure as Codefunctions- Sanity Functionsでのコンテンツワークフロー自動化
トピックガイド
groq- GROQクエリパターン、型安全性、パフォーマンス最適化schema- スキーマ設計、フィールド定義、バリデーション、非推奨化パターンvisual-editing- Presentation Tool、Stega、オーバーレイ、ライブプレビューpage-builder- Page Builder配列、ブロックコンポーネント、ライブ編集portable-text- リッチテキストレンダリングとカスタムコンポーネントimage- 画像スキーマ、URLビルダー、ホットスポット、LQIP、Next.js Imagestudio-structure- Desk構造、シングルトン、ナビゲーションtypegen- TypeGen設定、ワークフロー、型ユーティリティseo- メタデータ、サイトマップ、Open Graph、JSON-LDlocalization- i18nパターン、ドキュメントレベルvsフィールドレベル、ロケール管理migration- コンテンツインポート概要(migration-html-importも参照)migration-html-import- @portabletext/block-toolsを使用したHTMLからPortable Textへ
使用方法
リクエストに最も合致する単一のフレームワークまたはトピックガイドから始め、タスクが複数の関心事にまたがる場合のみ追加参照を読んでください。以下の参照ファイルを詳細な説明とコード例に使用してください:
references/groq.md
references/schema.md
references/nextjs.md
各参照ファイルに含まれるもの:
- 包括的なトピックまたは統合カバレッジ
- 正しくないコード例と正しいコード例
- 決定マトリックスとワークフローガイダンス
- フレームワーク固有のパターン(該当する場合)
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- sanity-io
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/sanity-io/agent-toolkit / ライセンス: MIT
関連スキル
doubt-driven-development
重要な判断はすべて、本番環境への展開前に新しい視点から対抗的レビューを実施します。速度より正確性が重要な場合、不慣れなコードを扱う場合、本番環境・セキュリティに関わるロジック・取り消し不可の操作など影響度が高い場合、または後でバグを修正するよりも今検証する方が効率的な場合に活用してください。
apprun-skills
TypeScriptを使用したAppRunアプリケーションのMVU設計に関する総合的なガイダンスが得られます。コンポーネントパターン、イベントハンドリング、状態管理(非同期ジェネレータを含む)、パラメータと保護機能を備えたルーティング・ナビゲーション、vistestを使用したテストに対応しています。AppRunコンポーネントの設計・レビュー、ルートの配線、状態フローの管理、AppRunテストの作成時に活用してください。
desloppify
コードベースのヘルスチェックと技術負債の追跡ツールです。コード品質、技術負債、デッドコード、大規模ファイル、ゴッドクラス、重複関数、コードスメル、命名規則の問題、インポートサイクル、結合度の問題についてユーザーが質問した場合に使用してください。また、ヘルススコアの確認、次の改善項目の提案、クリーンアップ計画の作成をリクエストされた際にも対応します。29言語に対応しています。
debugging-and-error-recovery
テストが失敗したり、ビルドが壊れたり、動作が期待と異なったり、予期しないエラーが発生したりした場合に、体系的な根本原因デバッグをガイドします。推測ではなく、根本原因を見つけて修正するための体系的なアプローチが必要な場合に使用してください。
test-driven-development
テスト駆動開発により実装を進めます。ロジックの実装、バグの修正、動作の変更など、あらゆる場面で活用できます。コードが正常に動作することを証明する必要がある場合、バグ報告を受けた場合、既存機能を修正する予定がある場合に使用してください。
incremental-implementation
変更を段階的に実施します。複数のファイルに影響する機能や変更を実装する場合に使用してください。大量のコードを一度に書こうとしている場合や、タスクが一度では完結できないほど大きい場合に活用します。