mcpField
C
catalyst-cache

catalyst-cache

github.com/catalystbyzohoデータ・データベース701.0k 回インストール今日更新
リポジトリ

catalyst-cache について

SDKを使ったCatalyst Cache Segmentの利用を支援するスキルです。値が文字列のみであること、TTLの動作、更新と削除に関する注意点を説明します。

主な機能

  1. 01Cache Segment IDの検索
  2. 02SDKの取得・書き込み・更新・削除の案内
  3. 03文字列値のシリアライズ方法
  4. 04TTLの制限と動作
  5. 05更新・削除時の注意点

活用シーン

  1. 01一時的なセッションデータの保存
  2. 02一時データにキャッシュを使うかの判断
  3. 03TTLや削除動作の問題調査

MCP 対応

利用可能な場合、MCPの`CatalystbyZoho_List_Cache_Segments`でSegment IDを検索します。MCPは検索手段として記載されており、MCPサーバーのインターフェースではありません。

インストール

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

$npx skills add https://github.com/catalystbyzoho/agent-skills --skill catalyst-cache

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

同梱ファイルreferences/cache-basics.md

詳細

仕組み

  1. セグメント ID の取得 — 利用可能な場合は MCP（CatalystbyZoho_List_Cache_Segments）を使用します。利用できない場合は、コンソールまたは .catalystrc から取得します。
  2. references/cache-basics.md の読み込み — SDK の操作、TTL の上限（最大 48 時間）、および segment.delete()／segment.update() の注意点を確認します。
  3. 文字列値のみ — キャッシュの値はすべて文字列です。put の前に必ず JSON.stringify を使用し、get の後に JSON.parse を使用します。
  4. TTL の動作 — TTL の単位は秒ではなく時間です（最大 48 時間）。有効期限の引数なしで segment.update() を呼び出すと、キーの TTL は警告なく最大の 48 時間にリセットされます（1 時間のキーが 48 時間のキーになります）。segment.delete() はキーを削除せず、cache_value を null に設定するため、キーは残ります。その後 getValue() を呼び出すと、HTTP 200 とともに null が返され、例外は発生しません。

トリガー

次のような場合にこのスキルを使用します：「Cache」、「cache segment」、「cache key」、「cache value」、「TTL」、「in-memory store」、「segment.get」、「segment.put」、「segment.delete」、「session data」、「temporary data Catalyst」、「cache vs Data Store」、「48-hour cache」。

リファレンス

リファレンスクエリの内容に応じて読み込む項目
references/cache-basics.mdSDK の操作（get、put、delete、update）、セグメント ID、TTL の上限（48 時間）、文字列のみの値、segment.delete() が値を null にする際の注意点、segment.update() による TTL の注意点

コメント

Markdown 対応