api-patterns について
api-patterns は Connect Query で API を呼び出すためのコーディングスキルです。データ取得、ミューテーション、キャッシュ無効化、エラー通知、生成された Protobuf ファイルの扱い方を開発者に示します。
主な機能
- 01Connect Query フックのガイダンス
- 02ミューテーション後のキャッシュ無効化
- 03formatToastErrorMessage によるエラー処理
- 04生成された Protobuf ファイルのルール
活用シーン
- 01Connect Query で API データを取得
- 02ミューテーション後のキャッシュ更新
- 03整形したミューテーションエラーの表示
- 04生成された Protobuf ファイルの編集回避
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ redpanda-data/ console --skill api-patternsインストール後、Claude Code で/api-patternsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
rules/api-invalidate-cache.mdapi-toast-errors.mdprotobuf-no-edit.mduse-connect-query.md詳細
API パターン
Connect Query で API を呼び出し、レスポンスを適切に処理します。
適用条件
- API を呼び出す場合
- Connect Query フックを使用する場合
- キャッシュを無効化する場合
- ミューテーションと楽観的更新を行う場合
- エラーをトースト通知する場合
クイックリファレンス
| 操作 | ルール |
|---|---|
| データの取得 | use-connect-query.md |
| ミューテーション後 | api-invalidate-cache.md |
| エラーの処理 | api-toast-errors.md(onError で formatToastErrorMessage を使用) |
| Protobuf ファイル | protobuf-no-edit.md |
主な場所
| 場所 | 用途 |
|---|---|
/src/react-query/ | Connect Query フック |
/src/protogen/ | 生成された proto(編集禁止) |
proto を再生成するには、リポジトリのルートから task proto:generate を実行します。
ルール
クエリ、ミューテーション、キャッシュ無効化、エラー処理の詳細については、rules/ ディレクトリを参照してください。
コメント
Markdown 対応