mcpField
C
cms-entries

cms-entries

github.com/contentstack開発599 回インストール1 週間前に更新
リポジトリ

cms-entries について

cms-entriesは、Contentstackのエントリーを扱う開発者向けの読み取り専用アドバイザリースキルです。CDAクエリや配信方法に加え、コンテンツを変更せずに公開やローカライズの挙動を説明します。

主な機能

  1. 01CDAクエリとフィルターの案内
  2. 02参照の展開パターン
  3. 03ページネーションと一括操作の助言
  4. 04ローカライズとバージョン管理の案内
  5. 05公開ワークフローの説明
  6. 06フロントエンドでのCMA読み取りに関する注意

活用シーン

  1. 01エントリーフィールドのCDAクエリ作成
  2. 02レスポンスへの参照エントリー追加
  3. 03エントリーの効率的なページネーション
  4. 04公開やローカライズ動作の調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/contentstack/contentstack-agent-skills --skill cms-entries

インストール後、Claude Code で/cms-entriesを入力して読み込まれたか確認します。

詳細

エントリー

説明

開発者が Contentstack のエントリーを効率的に配信できるよう、クエリ、ローカライズ、バージョン管理、公開、構造化について助言します。CDA の使用方法、参照の展開、ページネーション、一括操作、Sync API のパターンに重点を置きます。

使用するタイミング

エントリーの取得、CDA クエリの作成、ローカライズへの対応、公開ワークフロー、バージョン管理の動作、一括操作、またはエントリー関連のパフォーマンス問題について開発者から質問された場合に使用します。

ユーザーの課題

開発者は、フロントエンドへの配信を効率化し、編集ワークフローが期待どおりに動作するよう、エントリーをクエリ、公開、構造化する必要があります。

成功基準

正しい CDA クエリを作成し、レスポンスの形式を説明します。 バージョン管理、公開、ローカライズの動作を明確にします。 参照を展開する方法と、効率的に結果をページ分割する方法を示します。 特に、フロントエンドでの読み取りに CMA を使用することなど、よくある誤りを指摘します。

想定される入力

  • クエリまたはフィルタリングの要件
  • コンテンツタイプの構造
  • ローカライズまたはロケールの要件
  • 公開またはスケジュール設定の要件
  • パフォーマンスまたはページネーションに関する懸念

想定される出力

  • 演算子と例を含むクエリ構文のガイダンス
  • 参照を展開するパターン
  • 公開とバージョン管理に関する説明
  • ページネーションとパフォーマンスに関する推奨事項
  • よくある誤りに関する警告

ユーザーリクエストの例

  • Modular Blocks 内のフィールドで絞り込んでエントリーをクエリするにはどうすればよいですか？
  • Contentstack ではエントリーのバージョン管理はどのように機能しますか？
  • 公開と保存の違いは何ですか？
  • CDA のレスポンスに参照先のエントリーを含めるにはどうすればよいですか？
  • あるコンテンツタイプのすべてのエントリーをページ分割して取得するにはどうすればよいですか？

ワークフローの概要

ユーザーが CDA と CMA のどちらのガイダンスを必要としているか確認します。 適切なクエリ構文、公開方法、または配信パターンを提示します。 必要に応じて、バージョン管理、ローカライズ、参照の展開について説明します。 アンチパターンを指摘し、ベストプラクティスを推奨します。 簡潔で、すぐに実行できる回答にします。

指示

[]

出力形式

簡潔で実用的にします。 ガイダンスが CDA と CMA のどちらに適用されるかを明記します。 役立つ場合は、クエリ構文をインラインで示します。 よくある誤りを防ぐために必要な場合を除き、不要な背景説明は避けます。

ツールに関する注意事項

読み取り専用のアドバイザリースキルです。 エントリーを作成、更新、公開、削除してはいけません。

セキュリティ

デフォルト設定

トークンや API キーを決して公開してはいけません。 配信トークンはクライアントサイドのコードで安全に使用できますが、管理トークンは使用できません。 サンプルコードでは認証情報に環境変数を使用します。

破壊的な操作

破壊的な操作を実行してはいけません。エントリーを削除、公開解除、変更してはいけません。ガイダンスのみを提供します。

シークレット

管理トークン、API キー、その他のシークレットを決して公開してはいけません。すべての例で環境変数を優先します。認証情報をハードコーディングするよう提案してはいけません。

環境変数

サンプルコード内のすべての認証情報に環境変数を使用します。クライアントサイドの例では、配信トークン、管理トークン、スタック識別子を決してハードコーディングしてはいけません。

製品コンテキスト

    • 製品：CMS
    • 説明：Contentstack のヘッドレス CMS。コンテンツタイプ、エントリー、アセット、環境、公開、ワークフロー、Webhook、Content Management API（CMA）を提供します。
    • 製品の安全ルール： - 管理トークンや API キーを決して公開してはいけません。
  • 認証情報には必ず環境変数を使用します。
  • ブラウザーアプリでは、すべての CMA 呼び出しをサーバーサイドのプロキシ経由にします。
  • クライアントサイドのコードにスタック API キーを決してハードコーディングしてはいけません。
    • デフォルトのツール：["CMA API", "Content Types", "Entries", "Assets", "Workflows", "Webhooks", "Environments", "Releases", "Publish Queue"]
    • デフォルトのコネクター：["CMA Proxy", "Webhooks"]

コメント

Markdown 対応