APIエンドポイントの追加・変更で、DTO、入力検証、OpenAPI仕様、MCPツールの説明や公開範囲を揃え、エージェントからも扱いやすいAPIに整えます。
- APIエンドポイントを追加したいとき
- DTOと入力検証を整えたいとき
- MCPツールとしてAPIを公開したいとき
指定されたファイルのフックやAPI利用を点検し、禁止パターンをSWRやapiClientなどの指定方式へ修正するための監査手順と実装規約をまとめています。
Audit & fix hooks and API usage patterns — eliminate server actions, raw fetch, and stale patterns
実行スコア 未検証
インストール方法を見る指定されたファイルを対象に、フックやAPIの使い方を確認し、見つかった問題を修正するための規約と手順を示します。next-safe-actionのuseActionや、クライアント側の直接的な@db利用、認証情報を付けないfetch()などを避け、クライアントのデータ取得にはSWRとapiClient、サーバーコンポーネントにはserverApiを使う方針です。更新後はmutate()でキャッシュを再検証し、画面の再読み込みや更新コールバックに頼らない形にします。SSRの初期データにはfallbackDataを使い、APIレスポンスや未定義値を含む楽観更新の扱いも確認します。
既存コードのデータ取得や更新処理を現在の規約に合わせたいときに役立ちます。画面更新のための再読み込みや、古いサーバーアクション、直接的なAPI呼び出しが残っていないか点検する作業に向いています。
指定ファイルの確認後に型チェックを行う手順が記載されています。コマンドはbunx turbo run typecheck --filter=@trycompai/appです。
この紹介文は、公開されている SKILL.md をもとに AI(OpenAI Codex)が作成しました。正確な仕様は下の原文を確認してください。
インストールする前に、エージェントに与えられる指示の中身を確認できます。
Audit the specified files for hook and API usage compliance. Fix every issue found immediately.
useAction from next-safe-action → replace with SWR hook or custom mutation hook@db → delete and use API hook instead@db in client components → replace with apiClient via hook@db in Next.js pages for mutations → replace with serverApifetch() without credentials: 'include' → use apiClientwindow.location.reload() after mutations → use SWR mutate()router.refresh() after mutations → use SWR mutate()useEffect + apiClient.get for data fetching → replace with useSWRonXxxAdded, onSuccess) → remove, rely on SWR cache sharinguseSWR with apiClient or custom hookapiClient with mutate() for cache invalidationserverApi from apps/app/src/lib/api-server.tsfallbackData for SSR data, revalidateOnMount: !initialDataresponse.data.data, single = response.datamutate() safety: guard against undefined in optimistic update functionsArray.isArray() checks: when consuming SWR data that could be stale$ARGUMENTSbunx turbo run typecheck --filter=@trycompai/appまだレビューはありません。使ってみた感想をお寄せください。
ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。
まだコメントはありません。最初のコメントを書いてみませんか。
APIエンドポイントの追加・変更で、DTO、入力検証、OpenAPI仕様、MCPツールの説明や公開範囲を揃え、エージェントからも扱いやすいAPIに整えます。
既存コードのデザインシステム利用状況を調べ、旧UI部品やlucide-reactのアイコンを@trycompai/design-systemの部品・Carbonアイコンへ置き換えるスキルです。
NestJSのAPIとフロントエンドを調べ、権限チェックや監査ログのルール違反を修正するための確認項目を示します。
権限で表示や操作が変わるコンポーネントの単体テストを点検し、不足分の追加や失敗の修正を行って、管理者と閲覧専用ユーザーの動作を確かめます。
Better Authを使ったTypeScript認証の設定を支援し、データベース接続、セッション管理、メール認証、OAuth、プラグインやセキュリティ項目を整理します。
Stripeを使うサブスクリプションや決済、利用枠、請求Webhookの実装方針を確認し、SKUごとの状態管理や重複イベントへの対応を支援します。