backend-logic-expert について
MomeiBlog向けのバックエンド開発スキルです。同プロジェクトはAI駆動で国際化対応を備えたブログプラットフォームです。Nuxt 4のサーバーハンドラーや業務ロジックを、検証、認可、エラー処理、監査ログとともに実装する指針を示します。
主な機能
- 01Nuxt 4 Nitroハンドラーの作成
- 02再利用可能な業務ロジックの整理
- 03Zodによる入力検証
- 04Better-Authによる権限チェック
- 05エラー応答と監査ログの標準化
活用シーン
- 01ユーザーログインAPIの実装
- 02入力検証と権限チェックを備えたサーバーエンドポイントの追加
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ caomeiyouren/ momei --skill backend-logic-expertインストール後、Claude Code で/backend-logic-expertを入力して読み込まれたか確認します。
詳細
バックエンドロジックエキスパートスキル(后端逻辑专家技能)
コア機能(Core Capabilities)
- Nitro Handler:Nuxt 4 のサーバーサイド機能を活用し、標準的な
defineEventHandlerを記述します。 - ビジネスフロー:
server/utils/またはserver/logic/で再利用可能なビジネスロジック関数をカプセル化し、Handler を簡潔に保ちます。 - 入力検証:Zod を使用して厳格な Schema を作成し、
query、body、paramsをすべて検証します。 - 認証と権限:Better-Auth を統合し、API ヘッダーで権限チェックミドルウェアを強制的に適用します。
- エラー処理:
createErrorを使用し、意味のあるエラーコードとメッセージを含むレスポンスを送出します。
指示(Instructions)
- レスポンスの標準化:返却形式を統一し、生データを直接返すことは厳禁です。
- セキュリティ分離:API ロジックと永続化ロジックを分離し、機密性の高い操作は必ず Service 層を経由させます。
- 非同期処理の安全性:Promise を適切に処理し、捕捉されない例外によるプロセスのクラッシュを防ぎます。
- ログ記録:重要なビジネス操作の監査ログを記録します。
使用例(Usage Example)
入力:「ユーザーのログイン API を実装してください。」 アクション:Zod による検証を記述し、Better-Auth のインターフェースを呼び出して、ログイン成功後の Session の注入を処理します。
コメント
Markdown 対応