Skill: noear/solon-development-skill (version 1.0.0)

--- name: solon-development-skill description: "Specialized knowledge for developing Java applications with the Solon framework. Covers core concepts, web, data, security, remoting, AI, flow orchestration, cloud-native, testing, and more. Solon is an independent Java enterprise framework (NOT based on Spring) with its own annotation system, IoC/AOP container, and plugin ecosystem." --- # Solon Development Skill Provide expert guidance for building Java applications with the **Solon framework**. Solon is an independent, full-scenario Java enterprise application development framework — it is **NOT compatible with Spring** and has its own architecture, annotations, and ecosystem built from scratch. **Official website**: https://solon.noear.org **GitHub**: https://github.com/opensolon/solon **License**: Apache 2.0 **JDK support**: Java 8 ~ 25, GraalVM Native Image **Current version**: 3.10.x ## Critical Rules 1. **Solon is NOT Spring.** Never mix Spring annotations (`@Autowired`, `@SpringBootApplication`, `@RestController`, `@RequestMapping`, `@Service`, `@Repository`, `@Value`, `@ComponentScan`, etc.) into Solon code. Solon has its own complete annotation set. 2. **No Spring dependencies.** Never include `spring-boot-starter-*`, `spring-*`, or any Spring artifact in Solon projects. Solon uses `org.noear` group ID. 3. **Configuration file is `app.yml`** (or `app.properties`), NOT `application.yml`. 4. **Entry point** is `Solon.start(App.class, args)`, NOT `SpringApplication.run()`. 5. **All examples must target version 3.10.0** unless the user specifies otherwise. 6. **Parent POM** is `solon-parent` with `groupId=org.noear`. 7. **中文支持.** When the user communicates in Chinese, all responses and code comments must be in Chinese. ## Scene Navigation > 根据用户场景，读取对应的 reference 文件获取详细信息。 ### 基础与核心 | Scenario | Reference File | Grep Keywords | |---|---|---| | 项目初始化 / Maven 配置 / 构建 / 部署 / AOT / Native Image | `references/quick_start.md` | `pom.xml`, `Solon.start`, `solon-maven-plugin`, `solon-aot`, `native-image` | | 注解对照 / IoC 容器 / 配置系统 / 插件SPI / SnEL表达式 / Spring对比 | `references/core_concepts.md` | `@Inject`, `@Configuration`, `app.yml`, `SnEL`, `SpiLoader`, `Spring` | | 依赖选择 (web/lib) / 模块列表 / 序列化 / 视图 / 数据访问 / ORM | `references/modules_reference.md` | `solon-web`, `solon-lib`, `SqlUtils`, `MyBatis` | | 注解完整参考 / 配置文件属性参考 | `references/api_annotations.md` | `@Mapping`, `@Bean`, `@Param`, `server.port` | ### Web 开发 | Scenario | Reference File | Grep Keywords | |---|---|---| | REST API / MVC / WebSocket / EventBus / Filter / 拦截器 / 定时任务 | `references/common_patterns.md` | `@Controller`, `@Component`, `Filter`, `WebSocket`, `EventBus`, `@Mapping`, `@Scheduled` | | SSE 服务端推送 / Reactive 响应式 / I18n 国际化 | `references/web_advanced.md` | `SseEmitter`, `Flux`, `Mono`, `solon-web-sse`, `solon-web-rx`, `I18nUtil` | ### 安全 | Scenario | Reference File | Grep Keywords | |---|---|---| | 认证 / 鉴权 / CORS 跨域 / 角色权限 / 参数校验 / 配置加密 | `references/security.md` | `AuthAdapter`, `AuthProcessor`, `@CrossOrigin`, `@AuthPermissions`, `@AuthRoles`, `solon-security` | ### 数据与通信 | Scenario | Reference File | Grep Keywords | |---|---|---| | RPC 调用 / Nami 声明式客户端 / Socket.D 双向通信 / 负载均衡 | `references/remoting.md` | `@NamiClient`, `@Remoting`, `Socket.D`, `LoadBalance`, `ClientSession` | ### 运维与可观测 | Scenario | Reference File | Grep Keywords | |---|---|---| | 日志配置 / 自定义添加器 / 日志持久化 / Slf4j | `references/logging.md` | `solon-logging`, `AppenderBase`, `PersistentAppenderBase`, `logback` | ### 测试 | Scenario | Reference File | Grep Keywords | |---|---|---| | 单元测试 / 集成测试 / HTTP 接口测试 / Mock | `references/testing.md` | `@SolonTest`, `HttpTester`, `@Rollback`, `@Import`, `mockito` | ### 云原生 / 微服务 | Scenario | Reference File | Grep Keywords | |---|---|---| | 配置中心 / 注册发现 / 事件总线 / 分布式定时任务 / 文件存储 / 熔断 / 网关 / 链路追踪 / 分布式锁 | `references/cloud_native.md` | `nacos`, `kafka`, `minio`, `xxl-job`, `CloudClient`, `@CloudJob`, `@CloudEvent`, `CloudGateway` | ### AI 开发 | Scenario | Reference File | Grep Keywords | |---|---|---| | ChatModel / Tool Call / RAG / MCP / Agent / AI UI / Harness / ACP / A2A | `references/ai_development.md` | `ChatModel`, `RAG`, `MCP`, `ReActAgent`, `AiSdkStreamWrapper`, `HarnessEngine`, `ACP`, `A2A` | ### 流程编排 | Scenario | Reference File | Grep Keywords | |---|---|---| | Flow 流程编排 (规则引擎 / 工作流 / 状态机 / 图编排) | `references/flow_orchestration.md` | `FlowEngine`, `FlowContext`, `Graph`, `YAML`, `StateMachine` |


Security scan verdicts — ClawScan: clean | static analysis: suspicious | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)