solon-development-skill

Specialized knowledge for developing Java applications with the Solon framework. Covers core concepts, web, data, security, remoting, AI, flow orchestration,...

Security Scan

The skill is an instruction-only Solon framework reference and guidance pack; its files, runtime instructions, and requirements are coherent with that purpose and request no unexpected system access or credentials.

Purpose & Capability

Name/description promise Solon development guidance and the package contains only documentation files (references/*.md and SKILL.md) about Solon features, patterns, AI integration, flow orchestration, testing, etc. There are no unrelated environment variables, binaries, or install steps requested.

Instruction Scope

SKILL.md instructs the agent to provide Solon guidance and to read the included reference files according to user scenarios. It does not instruct reading arbitrary system files, accessing external secrets, or transmitting data to unexpected endpoints. Example fragments contain localhost or example API URLs (for illustrative configs) but the instructions don't direct the agent to call external endpoints or exfiltrate data.

Install Mechanism

No install spec and no code files — instruction-only. This is low-risk: nothing is written to disk or downloaded during install.

Credentials

The skill declares no required environment variables, credentials, or config paths. The references show example configs (e.g., API URLs, apiKey placeholders) appropriate for documentation but the skill does not request or require those secrets.

Persistence & Privilege

Skill is not always-enabled (always:false) and is user-invocable. Autonomous invocation (disable-model-invocation:false) is the platform default; on its own this is not a red flag and is consistent with an instruction-only helper skill.

Assessment

This skill is a documentation-only helper for the Solon Java framework and appears internally consistent. Before installing or using: (1) avoid pasting secrets or production credentials into prompts—examples in the docs show apiKey placeholders but the skill does not need your keys; (2) review any generated code before running it (the skill will produce code samples you should vet and adapt to your project/version); (3) note the skill enforces examples target Solon 3.10.0 by default—if you use a different version, tell the skill or verify examples accordingly. If you need the skill to access external services (APIs, databases, embedding/vector stores), expect to provide credentials separately and only when required.

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