Agent skill · software engineering · affaan-m
java-coding-standards
Spring Bootサービス向けのJavaコーディング標準：命名、不変性、Optional使用、ストリーム、例外、ジェネリクス、プロジェクトレイアウト。
Why this skill is useful
Provides specific Java coding standards and best practices for Spring Boot applications that the AI wouldn't reliably generate on its own.
What it needs
About 1k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
Javaコーディング標準 Spring Bootサービスにおける読みやすく保守可能なJava(17+)コードの標準。 核となる原則 巧妙さよりも明確さを優先 デフォルトで不変; 共有可変状態を最小化 意味のある例外で早期失敗 一貫した命名とパッケージ構造 命名 不変性 Optionalの使用 ストリームのベストプラクティス 例外 ドメインエラーには非チェック例外を使用; 技術的例外はコンテキストとともにラップ ドメイン固有の例外を作成(例: MarketNotFoundException) 広範なcatch (Exception ex)を避ける(中央でリスロー/ログ記録する場合を除く) ジェネリクスと型安全性 生の型を避ける; ジェネリックパラメータを宣言 再利用可能なユーティリティには境界付きジェネリクスを優先 プロジェクト構造(Maven/Gradle) フォーマットとスタイル 一貫して2または4スペースを使用(プロジェクト標準) ファイルごとに1つのpublicトップレベル型 メソッドを短く集中的に保つ; ヘルパーを抽出 メンバーの順序: 定数、フィールド、コンストラクタ、publicメソッド、protected、private 避けるべきコードの臭い 長いパラメータリスト → DTO/ビルダーを使用 深いネスト → 早期リターン マジックナンバー → 名前付き定数 静的可変状態 → 依存性注入を優先 サイレントなcatchブロック → ログを記録して行動、または再スロー ログ記録 Null処理 やむを得ない場合のみ@Nullableを受け入れる; それ以外は@NonNullを使用 入力にBean Validation(@NotNull、@NotBlank)を使用 テストの期待 JUnit 5 + AssertJで流暢なアサーション モック用のMockito; 可能な限り部分モックを避ける 決定論的テストを優先; 隠れたsleepなし 覚えておく: コードを意図的、型付き、観察可能に保つ。必要性が証明されない限り、マイクロ最適化よりも保守性を最適化します。
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/java-coding-standards--def0b0