编写健壮 Java 代码的基础能力,覆盖空指针防护、相等性判断与基础异常处理。
Java 基础版是一项面向实际任务的技能,主要用于NullPointerException 防护:识别潜在的空指针风险点,推荐使用 Optional、Objects.requireNonNull 与空值检查;equals 与 hashCode 规范实现:依据 Object 契约正确实现 equals 与 hashCode,避免对称性、传递性与一致性陷阱;
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;
涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
解析用户指令,执行核心操作并返回处理结果。
输入: 用户提供操作指令和必要参数。
输出: 返回操作执行的结果。
指令解析与执行操作,处理输入数据并返回结果指令解析与执行相关配置参数进行设置处理输入数据,执行转换操作并输出结果。
输入: 用户提供操作指令和必要参数。
输出: 返回操作执行的结果。
数据处理与转换操作,处理输入数据并返回结果数据处理与转换相关配置参数进行设置验证处理结果的正确性,格式化输出并返回给用户。
输入: 用户提供操作指令和必要参数。
输出: 返回操作执行的结果。
结果验证与输出操作,处理输入数据并返回结果结果验证与输出相关配置参数进行设置| 组件 | 说明 | 关键参数 |
|---|---|---|
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 框架深度问题等场景(请使用高级版)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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 格式并提示 |
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
输入: code=UserServiceImpl.java 片段, focus=null 处理: 识别返回值未包装 Optional -> 标记风险点 -> 给出修复建议 输出: 空指针防护得分 75,建议使用 Optional.ofNullable
输入: code=仅包含字段定义的 User 类, focus=equals 处理: 依据字段生成规范的 equals 与 hashCode -> 校验契约 输出: 包含 getClass 检查、null 检查与字段比较的完整实现
A: 查看使用流程章节,准备待审查的 Java 代码,然后按"输入格式"提供 code 与 focus 参数即可。
A: strict 会标记所有潜在风险点(包括风格问题);normal 聚焦明确的缺陷;loose 仅报告高风险问题。建议初次使用选择 normal。
A: 不支持。基础版聚焦空指针、相等性、资源、集合与异常五个维度,如需审查并发陷阱、复杂泛型、JVM 调优,请升级至高级版。
A: 这些属于高级版能力。基础版聚焦高频陷阱防护,如需深入并发(synchronized、volatile、ConcurrentHashMap)、泛型(PECS、类型擦除)与 JVM 调优能力,请升级至高级版。
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接,执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令请求;确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求,参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述,补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求;检查命令权限设置 |
相关专题
热门下载
相关下载
精品课程
共0课时 | 0人学习
共0课时 | 0人学习
共0课时 | 0人学习
最新文章