java-best-practices

💻 软件开发

访问 GitHub

提供 Java 开发全流程的规范指导与实践支持，涵盖命名约定、主流设计模式应用、Stream 链式处理、健壮异常管理、线程安全并发控制及空值安全的 Optional 用法，助力编写可读性强、可维护性高…

简介

核心能力速览

✓所属分类：💻 软件开发

✓通过 Agent Skills 协议，将「能力」封装为可复用、可安装的 AI 组件

✓支持按需加载领域知识与工具，让通用模型转变为特定任务的专家

适用场景

适用于「💻 软件开发」相关场景，可作为可复用的 AI 能力组件，接入支持 Agent Skills 的 AI 客户端（如 Claude、Cursor、Cline 等），按需调用以扩展模型能力。

Skills.MD

name	java-best-practices
description	Java 编码最佳实践与设计模式
version	1.0.0
category	development
scriptPath	check-java-env.sh
scriptType	bash
autoExecute	true
scriptTimeout	5

Java 最佳实践技能包

编码规范

命名规范

类名：PascalCase（UserService）
方法/变量：camelCase（getUserById）
常量：UPPER_SNAKE_CASE（MAX_SIZE）
包名：小写（com.example.service）

常用设计模式

单例模式（枚举实现）：

public enum Singleton {
    INSTANCE;
    public void doSomething() {}
}

工厂模式：

public class UserFactory {
    public static User createUser(String type) {
        return switch (type) {
            case "admin" -> new AdminUser();
            case "guest" -> new GuestUser();
            default -> new RegularUser();
        };
    }
}

Builder 模式：

User user = User.builder()
    .name("张三")
    .age(25)
    .build();

Stream API

List<String> names = users.stream()
    .filter(u -> u.getAge() > 18)
    .map(User::getName)
    .collect(Collectors.toList());

异常处理

try {
    // 业务逻辑
} catch (SpecificException e) {
    log.error("Error: {}", e.getMessage(), e);
    throw new BusinessException("操作失败");
} finally {
    // 清理资源
}

并发编程

ExecutorService executor = Executors.newFixedThreadPool(10);
executor.submit(() -> {
    // 异步任务
});

Optional 使用

Optional<User> user = userRepository.findById(id);
return user.orElseThrow(() -> new NotFoundException());

快捷安装

在终端执行以下命令，即可将本 Skill 安装到本地 AI 客户端：

npx skills add Leavesfly/Jimi