技能 编程开发 现代 Java 开发指南

现代 Java 开发指南

v20261118
modern-java-guidance
指导 AI 代理编写 Java 17/21+ 与 Spring Boot 3.x 代码,避免沿用 Java 8 和 Boot 2.x 旧模式;通过版本检测与离线 mjg CLI 扫描器校验改造结果。
获取技能
97 次下载
概览

Modern Java Guidance

Overview

Prevents AI coding agents from defaulting to Java 8 and Spring Boot 2.x legacy patterns (javax.*, WebSecurityConfigurerAdapter, RestTemplate, @Autowired field injection, Executors.newFixedThreadPool(), list.get(list.size() - 1)). Unlike general persona skills such as java-pro, this skill pairs lightweight instructions with version-gated CLI scanning (mjg detect, mjg check, mjg search, mjg retrieve) and respects older Java 8/11 and Spring Boot 2.x codebases without forcing upgrades.

When to Use

  • Writing, refactoring, or reviewing Java 17/21/25+ or Spring Boot 3.x+ application code.
  • Auditing an existing Java or Spring Boot codebase for deprecated Boot 2.x or Java 8 idioms.
  • Prefer java-pro for broader JVM/GraalVM tuning topics not covered by this skill's rules.

Prerequisites

  • Local workspace containing a Java or Spring Boot project (pom.xml, build.gradle, build.gradle.kts, or .java-version).
  • Optional: Python 3.11+ with the mjg CLI (https://github.com/wkd09/modern-java-guidance) for automated version detection and scanning. Everything runs 100% offline with zero external network calls or credentials.

How It Works

1. Establish the inputs

Inspect pom.xml, build.gradle(.kts), gradle/libs.versions.toml, or .java-version (or run mjg detect . if installed).

  • Java <= 11 or Spring Boot 2.x: Preserve existing language/framework idioms; do not emit Java 17/21 syntax or jakarta.* unless explicitly asked to migrate.
  • Java 17+ / Spring Boot 3.0–3.1: Apply modern replacements (record, sealed interface, SecurityFilterChain Lambda DSL with CSRF enabled by default, jakarta.*, constructor injection, java.time). Keep WebClient or RestTemplate (RestClient requires Boot 3.2+).
  • Spring Boot 3.2+: Prefer RestClient / @HttpExchange over RestTemplate.
  • Java 21+: Prefer Pattern Matching for switch, SequencedCollection.getLast(), and Executors.newVirtualThreadPerTaskExecutor() for blocking I/O.

2. Perform the task

Use references/java-21-25-core.md and references/spring-boot-3x.md (or mjg search / mjg retrieve) when writing or updating Java classes. Preserve public/legacy APIs and keep bounded thread pools for CPU-bound tasks.

3. Verify the result

Run mjg check src/ (if installed) and the project's build/test command (./mvnw test or ./gradlew test). Report any remaining warnings or unexecuted build checks explicitly.

Examples

User request: Add a Spring Security configuration for a Spring Boot 3.3 + Java 21 REST API.
Inputs: pom.xml specifying spring-boot-starter-parent 3.3.4 and java.version 21.
Expected result: Generates a @Bean SecurityFilterChain using Lambda DSL (authorizeHttpRequests, requestMatchers) with CSRF protection preserved by default, without WebSecurityConfigurerAdapter or antMatchers(), and passes `mjg check` with 0 findings.

Limitations

  • Pattern matching in mjg relies on static source scanning rather than full javac AST resolution; always run the project's compiler and test suite (./mvnw test / ./gradlew test).
  • Do not use Java record types for JPA @Entity classes, which require mutable state and no-arg constructors.

Safety and side effects

  • Read-only code guidance and local static scanning (risk: safe).
  • mjg detect and mjg check perform read-only local filesystem reads and never transmit source code over the network.

Sources and related skills

  • Source repository: https://github.com/wkd09/modern-java-guidance (MIT License)
  • Related skill: java-pro
信息
分类 编程开发
名称 modern-java-guidance
版本 v20261118
大小 5.06KB
更新时间 2026-11-19
语言