name: java-sdk-specialist description: 面向企业环境的Java SDK开发 allowed-tools:
- Read
- Write
- Edit
- Glob
- Grep
- Bash
Java SDK专家技能
概述
本技能专注于开发企业级Java SDK,包含构建器模式、响应式与同步客户端,以及正确的Maven/Gradle分发配置。
能力范围
- 使用构建器模式设计Java SDK架构
- 使用Project Reactor或RxJava实现响应式客户端
- 实现具有正确资源管理的同步客户端
- 配置Maven/Gradle发布至Maven Central
- 支持Java 11+并提供正确的兼容性处理
- 设计流畅的API接口
- 实现正确的异常层次结构
- 使用SLF4J配置日志记录
目标流程
- 多语言SDK策略
- SDK架构设计
- SDK测试策略 n
集成点
- Maven Central仓库
- JUnit 5用于测试
- Gradle/Maven构建系统
- OkHttp/Apache HttpClient
- Project Reactor用于响应式编程
- Lombok用于减少样板代码
输入要求
- API规范
- 目标Java版本(11、17、21)
- 响应式与同步偏好
- 构建工具偏好(Maven/Gradle)
- 依赖注入要求
输出产物
- Java SDK源代码
- pom.xml或build.gradle配置
- JUnit测试套件
- Javadoc文档
- 示例应用程序
- 发布配置
使用示例
skill:
name: java-sdk-specialist
context:
apiSpec: ./openapi.yaml
javaVersion: 17
buildTool: gradle
reactiveSupport: true
httpClient: okhttp
lombok: true
最佳实践
- 对复杂对象使用构建器模式
- 为资源管理实现AutoCloseable接口
- 设计不可变的值对象
- 同时提供同步和异步API
- 对可空返回值使用Optional
- 使用全面的Javadoc进行文档化