Agent Skills
返回列表
Solon 开发指南

Solon 开发指南

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 架构师