Solon 开发指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_7e22112e/solon-development-skill。
技能介绍
解决的问题
很多 Solon 项目会误用 Spring 注解、依赖和配置命名,导致启动失败或行为不一致。该技能面向 Java 8 到 Java 26 的 Solon 4.0.3 开发,强调 Solon 与 Spring 不兼容:使用 app.yml、Solon.start(App.class, args)、@Component、@Inject 和 org.noear 坐标,避免 @RestController、@Autowired、spring-boot-starter-* 等习惯迁移。
技能如何工作
它先根据任务判定场景,再只读取 1~2 个相关 reference,避免一次性加载全部资料。核心能力覆盖:
- 基础开发:
pom.xml、solon-maven-plugin、AOT/Native、REST、Filter、定时任务 - 数据与通信:
SqlUtils、事务、MyBatis、Nami RPC、Socket.D - AI 场景:ChatModel、Tool、基础 RAG、MCP、Agent、HarnessEngine、ACP/A2A
- 云与流程:配置中心、服务发现、网关、熔断、Flow YAML、Workflow、拦截器
生成代码前会核对关键规则,例如不使用 Spring 依赖、不确定 API 时查 reference 或源码。
适用边界
它适合 Solon 原生开发、插件 SPI、安全校验、测试、日志和 AI 组件设计;从 Spring 完整迁移应配合 Spring 转 Solon 技能使用。不要臆造不存在的 solon-ai-rag、solon-ai-a2a 坐标;升级版本时需全局替换目标版本并复核 AI、Nami 与快捷依赖变化。
使用场景
- 用 Maven 初始化 Solon Web 项目,生成 App、Controller 和 app.yml 最小模板
- 把 REST、Filter、定时任务从 Spring 习惯改写成 Solon 注解与 app.yml 配置
- 为 Solon AI 场景接入 ChatModel、Tool、MCP 或 Agent,并选择正确 reference
- 排查 Nami RPC、服务发现、负载均衡与 Socket.D 双向通信的组件用法
适合人员
- 要把 Spring Boot 服务改造成 Solon 的 Java 后端工程师
- 需要维护 org.noear 依赖和 solon-parent 的构建负责人
- 要在 Solon 中接入 AI Agent、MCP 或 RAG 的应用负责人
- 需要配置网关、熔断、注册发现与 Flow 的 Java 架构师