mcpField
R
restcontroller-conventions

restcontroller-conventions

github.com/oimiragieo開発4441 回インストール17 週間前に更新
リポジトリ

restcontroller-conventions について

REST コントローラーを扱う開発者向けのコーディング規約スキルです。コードを確認して修正案を示し、アノテーション、レスポンス型、例外処理などの規約を説明します。

主な機能

  1. 01規約に沿ったコードチェック
  2. 02標準に基づく改善案の提示
  3. 03推奨されるコントローラーパターンの説明
  4. 04アノテーションとレスポンスの指針
  5. 05try-catch とグローバル例外処理

活用シーン

  1. 01REST コントローラーコードのレビュー
  2. 02規約に合わせたメソッドのリファクタリング
  3. 03アノテーションやエラー処理の選択肢の説明

インストール

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

$npx skills add https://github.com/oimiragieo/agent-studio --skill restcontroller-conventions

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

commands/
restcontroller-conventions.md
hooks/
post-execute.cjs
pre-execute.cjs
references/
research-requirements.md
restcontroller-conventions.mdc
rules/
restcontroller-conventions.md
schemas/
input.schema.json
output.schema.json
scripts/
main.cjs
templates/
implementation-template.md

詳細

Restcontroller の規約スキル

あなたは、restcontroller の規約を専門とするコーディング標準のエキスパートです。 確立されたガイドラインとベストプラクティスを適用して、開発者がより良いコードを書けるよう支援します。 - ガイドラインへの準拠状況をコードレビューする - ベストプラクティスに基づいて改善を提案する - 特定のパターンが推奨される理由を説明する - 標準を満たすようにコードをリファクタリングする コードをレビューまたは作成する際は、次のガイドラインを適用してください。
  • コントローラークラスには必ず @RestController を付与します。
  • クラスレベルの API ルートは、例("/api/user")のように @RequestMapping で指定します。
  • クラスメソッドでは、ベストプラクティスに沿った HTTP メソッドのアノテーションを使用します。例:create = @postMapping("/create") など。
  • 特に指定がない限り、クラスメソッド内のすべての依存関係には、コンストラクターを使わずに @Autowired を付与します。
  • メソッドの戻り値は、ApiResponse 型の Response Entity でなければなりません。
  • クラスメソッドのロジックはすべて、try..catch ブロック内に実装します。
  • catch ブロックで捕捉したエラーは、Custom GlobalExceptionHandler クラスで処理します。
使用例: ``` User: "Review this code for restcontroller conventions compliance" Agent: [Analyzes code against guidelines and provides specific feedback] ```

Memory Protocol(必須)

開始前:

cat .claude/context/memory/learnings.md

完了後: 新たに見つかったパターンや例外を記録します。

中断を想定してください:コンテキストがリセットされることがあります。メモリに記録されていなければ、起きていないものとして扱われます。

コメント