Java基础版

Polar Sponsor
爱发电 赞助
.NET 9.0

编写健壮 Java 代码的基础能力,覆盖空指针防护、相等性判断与基础异常处理。

Java 基础版

功能概述

Java 基础版是一项面向实际任务的技能,主要用于NullPointerException 防护:识别潜在的空指针风险点,推荐使用 Optional、Objects.requireNonNull 与空值检查;equals 与 hashCode 规范实现:依据 Object 契约正确实现 equals 与 hashCode,避免对称性、传递性与一致性陷阱;

核心要点

  • try-with-resources 资源管理:对 A。
  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
  • 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;

结果检查与注意事项

涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。

Java 基础版

核心能力

  • NullPointerException 防护:识别潜在的空指针风险点,推荐使用 Optional、Objects.requireNonNull 与空值检查
  • equals 与 hashCode 规范实现:依据 Object 契约正确实现 equals 与 hashCode,避免对称性、传递性与一致性陷阱
  • try-with-resources 资源管理:对 AutoCloseable 资源使用 try-with-resources,确保流、连接、文件句柄正确释放
  • 基础集合操作:推荐使用不可变集合(List.of、Map.of、Set.of)与 ArrayList、HashMap 的基础用法
  • 基础异常处理:区分受检异常与非受检异常,避免捕获 Throwable 与吞没异常

指令解析与执行

解析用户指令,执行核心操作并返回处理结果。

输入: 用户提供操作指令和必要参数。

输出: 返回操作执行的结果。

  • 执行指令解析与执行操作,处理输入数据并返回结果
  • 验证执行结果,确认输出符合预期格式
  • 参考指令解析与执行相关配置参数进行设置

数据处理与转换

处理输入数据,执行转换操作并输出结果。

输入: 用户提供操作指令和必要参数。

输出: 返回操作执行的结果。

  • 执行数据处理与转换操作,处理输入数据并返回结果
  • 验证执行结果,确认输出符合预期格式
  • 参考数据处理与转换相关配置参数进行设置

结果验证与输出

验证处理结果的正确性,格式化输出并返回给用户。

输入: 用户提供操作指令和必要参数。

输出: 返回操作执行的结果。

  • 执行结果验证与输出操作,处理输入数据并返回结果
  • 验证执行结果,确认输出符合预期格式
  • 参考结果验证与输出相关配置参数进行设置

技术细节

组件 说明 关键参数
parser 解析输入指令 format, encoding
processor 执行核心处理逻辑 mode, timeout
output 格式化输出结果 format, encoding

能力覆盖范围

本skill还覆盖以下能力场景: 编写健壮、Java、代码的基础能力、覆盖空指针防护、相等性判断与基础、相等性判断、与基础异常处理。这些能力在上述核心功能中均有对应处理逻辑。

适用场景

场景 输入 输出
空指针检查 待审查的 Java 方法 风险点列表与修复建议
equals 实现 类定义与字段 规范的 equals 与 hashCode 实现
资源管理 涉及 IO/连接的方法 try-with-resources 改写建议
集合初始化 集合创建代码 推荐的不可变集合或 ArrayList 用法
异常处理 try-catch 代码块 规范化建议与潜在问题

不适用于:复杂并发(如 synchronized、ReentrantLock、ConcurrentHashMap 原理)、复杂泛型(如通配符 PECS、类型擦除陷阱)、JVM 性能调优、Spring/Java EE 框架深度问题等场景(请使用高级版)

使用流程

  1. 确认运行环境满足依赖说明中的要求
  2. 读取待审查或待生成的 Java 代码
  3. 按核心能力维度逐项分析(空指针、相等性、资源、集合、异常)
  4. 给出问题清单与修复建议,必要时生成改写后的代码
  5. 输出结果与执行日志

输入格式

参数名 类型 必填 说明
code string 是 待审查的 Java 代码片段或文件路径
focus string 否 关注维度,可选: null/equals/resources/collection/exception/all,默认: all
strict_level string 否 审查严格度,可选: strict/normal/loose,默认: normal
output_format string 否 输出格式,可选: markdown/json/text,默认: markdown

输出格式

{
  "success": true,
  "data": {
    "overall_grade": "B",
    "total_score": 82,
    "max_score": 100,
    "summary": "发现 2 个空指针风险点与 1 个 equals 实现问题",
    "details": [
      {
        "item": "空指针防护",
        "status": "warn",
        "score": 75,
        "comment": "第 12 行的返回值未做空检查,建议使用 Optional.ofNullable"
      },
      {
        "item": "equals 实现",
        "status": "fail",
        "score": 60,
        "comment": "equals 未先比较引用再比较字段,且未处理 null 情况"
      },
      {
        "item": "资源管理",
        "status": "pass",
        "score": 95,
        "comment": "已正确使用 try-with-resources"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "为 getUser 返回值添加 Optional 包装",
        "expected_gain": "+8分"
      },
      {
        "priority": "medium",
        "suggestion": "重写 equals 方法,加入 getClass 与 null 检查",
        "expected_gain": "+5分"
      }
    ]
  },
  "error": null
}

异常处理

错误场景 原因 处理方式
代码无法解析 语法错误或不完整的 Java 代码 提示用户修正语法后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,标记错误位置
文件不存在 code 参数为路径但文件不存在 检查路径是否为绝对路径,确认文件存在
focus 维度无效 focus 参数值不在可选范围内 提示可选值列表,建议使用默认值 all
输出格式不支持 output_format 参数值无效 回退为默认 markdown 格式并提示

依赖说明

运行环境

  • Agent平台: 支持SKILL.md规范的任意AI Agent
  • 操作系统: Windows / macOS / Linux
  • Java 版本: 建议 JDK 11 及以上(涉及 Optional、List.of 等 API)

依赖项

依赖项 类型 是否必需 获取方式
LLM API API 必需 由Agent内置LLM提供

API Key 配置

  • 本Skill基于指令驱动,无需额外API Key

可用性分类

  • 分类: MD+EXEC()
  • 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent执行Java代码审查

案例展示

示例1:审查一个 Service 方法

输入: code=UserServiceImpl.java 片段, focus=null
处理: 识别返回值未包装 Optional -> 标记风险点 -> 给出修复建议
输出: 空指针防护得分 75,建议使用 Optional.ofNullable

示例2:生成 equals 与 hashCode

输入: code=仅包含字段定义的 User 类, focus=equals
处理: 依据字段生成规范的 equals 与 hashCode -> 校验契约
输出: 包含 getClass 检查、null 检查与字段比较的完整实现

常见问题

Q1: 如何开始使用 Java 基础版?

A: 查看使用流程章节,准备待审查的 Java 代码,然后按"输入格式"提供 code 与 focus 参数即可。

Q2: 审查严格度 strict、normal、loose 有何区别?

A: strict 会标记所有潜在风险点(包括风格问题);normal 聚焦明确的缺陷;loose 仅报告高风险问题。建议初次使用选择 normal。

Q3: Java 基础版支持并发问题审查吗?

A: 不支持。基础版聚焦空指针、相等性、资源、集合与异常五个维度,如需审查并发陷阱、复杂泛型、JVM 调优,请升级至高级版。

Q4: 如何获取并发陷阱防护、复杂泛型、JVM 性能调优等高级能力?

A: 这些属于高级版能力。基础版聚焦高频陷阱防护,如需深入并发(synchronized、volatile、ConcurrentHashMap)、泛型(PECS、类型擦除)与 JVM 调优能力,请升级至高级版。

错误处理

错误场景 原因 处理方式
LLM响应超时或无响应 网络延迟或模型负载过高 执行ping命令测试网络连通性,检查防火墙和代理设置连接,执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令请求;确认Agent平台LLM服务正常
输入内容格式不正确 用户输入不符合skill预期格式 检查输入是否符合skill使用说明中的格式要求,参考示例章节
执行结果与预期不符 指令描述不够明确或上下文不足 提供更详细的指令描述,补充必要的上下文信息
命令执行失败 运行环境不满足要求或权限不足 确认运行环境符合依赖说明中的要求;检查命令权限设置

已知限制

  • 不支持并发问题审查(synchronized、volatile、ReentrantLock、死锁、线程安全集合)
  • 不支持复杂泛型分析(通配符 PECS、类型擦除、桥接方法)
  • 不支持 JVM 性能调优(GC 策略、内存模型、字节码分析)
  • 不支持 Spring、Java EE、JavaFX 等框架深度问题
  • 不支持模块化系统(module-info.java)的分析
  • equals 与 hashCode 生成仅覆盖基础场景,不涉及继承体系下的复杂实现

相关专题

更多
IntelliJ IDEA调试技巧汇总
IntelliJ IDEA调试技巧汇总

本合集讲解 IDEA 断点调试、条件断点、远程调试、微服务链路调试、内存快照分析、异常定位高级用法,解决 Java 项目排查难题。

2026.08.11

51

15

Java Spring Boot多租户架构设计与数据隔离实战
Java Spring Boot多租户架构设计与数据隔离实战

本专题聚焦 Java 企业级系统中的多租户架构设计,讲解数据隔离策略、租户路由机制、数据库分库分表方案以及权限控制模型。通过真实 SaaS 系统案例,帮助开发者构建可扩展的多租户应用架构。

2026.06.29

216

13

Java Spring Boot3响应式编程与WebFlux实战
Java Spring Boot3响应式编程与WebFlux实战

本专题围绕Spring Boot 3中的响应式编程体系展开,系统讲解 WebFlux 的非阻塞模型、Reactive Streams、Mono 与 Flux 使用方式,以及在高并发场景下的性能优势。结合真实后端案例,帮助开发者构建低延迟、高吞吐的响应式服务架构。

2026.06.22

180

17

Java分布式事务与Seata实战架构设计
Java分布式事务与Seata实战架构设计

本专题围绕 Java 分布式系统中的事务一致性问题展开,系统讲解分布式事务的核心理论与解决方案。内容包括 Seata AT/TCC 模式原理、事务协调机制、服务调用链一致性保障以及高并发场景下的数据一致性设计策略。通过真实微服务案例,帮助开发者构建可靠的分布式事务处理体系。

2026.06.16

161

12

Java消息队列与异步解耦实战
Java消息队列与异步解耦实战

系统讲解 Java 中消息队列的集成与应用实践,涵盖消息队列的核心概念(生产者/消费者/Topic/Queue/Exchange)、RabbitMQ 的交换机类型与 Spring AMQP 集成、Kafka 分区/副本/消费者组机制与 Spring Kafka 配置、RocketMQ 事务消息与顺序消息、消息可靠投递(确认机制/持久化/重试)、消费端幂等性保障(唯一ID/去重表)、死信队列与延迟消息处理、消息积压监控与扩容策略,帮助开发

2026.05.18

235

29

Java缓存技术与Redis集成教程合集
Java缓存技术与Redis集成教程合集

系统讲解 Java 项目中缓存技术的选型与实践,涵盖本地缓存方案(HashMap 手动缓存/Guava Cache/Caffeine 高性能缓存)的使用与淘汰策略配置、Redis 数据结构(String/Hash/List/Set/ZSet)在缓存场景的应用、Jedis / Lettuce / Redisson 客户端选型、Spring Cache 注解(@Cacheable/@CachePut/@CacheEvict)的声明式缓存、缓

2026.05.15

402

34

Java容器化部署与Docker实践教程合集
Java容器化部署与Docker实践教程合集

聚焦 Java 应用的容器化与云原生部署,讲解 Dockerfile 编写规范与 Java 应用镜像构建、多阶段构建(Multi-stage Build)减小镜像体积、Jib / Buildpacks 免 Dockerfile 镜像构建方案、JVM 容器感知参数(-XX:MaxRAMPercentage)配置、Docker Compose 编排多服务(应用 + MySQL + Redis)、容器健康检查与资源限制、Kubernetes

2026.05.11

280

26

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

2026.05.09

229

25

Java 函数式接口与 Lambda 进阶技巧
Java 函数式接口与 Lambda 进阶技巧

在 Java Stream 基础之上进一步深入函数式编程,涵盖 @FunctionalInterface 注解与自定义函数式接口设计、四种方法引用(静态/实例/对象/构造器)的使用场景、Lambda 中的 effectively final 变量捕获规则、函数组合(andThen/compose)与柯里化技巧、Comparator 链式比较器构建、CompletableFuture 异步函数式编排、Reactor / RxJava 响应

2026.05.08

248

28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习