opensolon/soloncode/solon-development-skill

Solon Development Skill

为使用 Solon 框架 构建 Java 应用提供专家级指导。Solon 是独立的全场景 Java 企业应用框架 — 与 Spring 不兼容，拥有自研架构、注解体系与生态。

官网: https://solon.noear.org GitHub: https://github.com/opensolon/solon License: Apache 2.0 JDK: Java 8 ~ 26，GraalVM Native Image 目标版本: 4.1.0（升级时全局替换此标记 + 复核 AI/Nami 变更段）

Critical Rules

1. 框架守卫（优先于一切）：本 skill 的规则只适用于「Solon 项目」或「用户明确要用 Solon 的新项目」。若当前项目实际是 Spring 项目且用户未明确要求迁移或改用 Solon：保持项目现有框架，禁止移除 Spring 依赖、改写启动类/注解/配置文件名，禁止把下面的「禁 Spring」规则反向套用到 Spring 项目上；意图不明时先询问用户。确属 Solon 项目时才适用下列规则。
2. Solon 不是 Spring。 禁止混用 Spring 注解（@Autowired、@SpringBootApplication、@RestController、@RequestMapping、@Service、@Repository、@Value、@ComponentScan 等）。（仅在 Rule 0 判定为 Solon 项目后适用）
3. 禁止 Spring 依赖。 不要引入 spring-boot-starter-*、spring-*。Solon 坐标 groupId 为 org.noear。（仅在 Rule 0 判定为 Solon 项目后适用；Spring 项目里的 Spring 依赖不归本 skill 管）
4. 配置文件是 `app.yml`（或 app.properties），不是 application.yml。
5. 入口是 Solon.start(App.class, args)，不是 SpringApplication.run()。
6. 组件注解用 `@Component`，不要用 @Service / @Repository。
7. 示例默认目标版本 4.1.0（除非用户指定其它版本）。
8. Parent POM 为 solon-parent（groupId=org.noear）。
9. 中文支持。 用户使用中文时，回复与代码注释使用中文。
10. 不确定的 API 不要臆造。 优先查本 skill 的 reference；仍不确定时查官网/源码，禁止用 Spring 习惯补全。

执行流程

1. 判定框架归属（优先）：确认当前项目是 Solon 项目（solon-parent、org.noear 依赖、app.yml、@SolonMain）或用户明确要用 Solon；否则按 Rule 0 处理（保持 Spring 现状 / 先问）。Spring 项目仅“顺带提到 Solon”不算。
2. 判定场景 → 只 read 下表中对应的 1～2 个 reference（禁止一次加载全部）。
3. 生成代码前核对 Critical Rules（尤其：app.yml、@Component、@Inject、无 Spring 依赖）。
4. 数据访问优先读 references/data_access.md。
5. AI 场景分流：

• Chat/Tool/MCP/基础 RAG → references/ai_chat_rag_mcp.md
• Loader/向量库/搜索插件表 → references/ai_rag_plugins.md
• Agent/Talent/Loop → references/ai_agent.md
• HarnessEngine/工具权限 → references/ai_harness.md
• AI UI/ACP/A2A → references/ai_protocol_ui.md

1. Cloud 分流：Config/Discovery/Event/Job → references/cloud_core.md；File/Breaker/Gateway/Trace/Metric/Id/Lock → references/cloud_ops.md。
2. Remoting 分流：Nami RPC/HttpClient → references/remoting.md；过滤器/发现/LB → references/remoting_filter_lb.md；Socket.D → references/socketd.md。
3. Flow 分流：YAML/Graph/节点 → references/flow_orchestration.md；中断恢复/Workflow/拦截器 → references/flow_workflow.md。
4. Security 分流：Auth/CORS/Vault → references/security.md；参数校验 → references/validation.md。
5. 从 Spring 迁移 → 使用 spring-to-solon-skill，本 skill 仅保留精简对照。
6. 用户中文提问 → 中文回复与注释；默认版本 4.1.0。
7. API 不确定时查 reference 或源码；禁止用 Spring 习惯或臆造坐标补全（例如不存在 solon-ai-rag / solon-ai-a2a）。

Scene Navigation（含阅读优先级）

根据场景只读 1～2 个文件。路径统一写完整相对路径（如 references/quick_start.md）。

基础与核心

Web / 安全 / 通信

运维 / 测试 / 云 / 流程

AI

版本与变更

• 默认稳定版：4.0.3；JDK 8 ~ 26
• AI / Nami 等增量细节以对应 reference 为准（AI 见 references/ai_agent.md 末尾「4.0.3 AI 增量要点」；Nami 默认 snack4）
• 升级版本时：全局替换 4.0.3 标记，并复核 AI、Nami、快捷依赖章节

最小模板

从零建 Web 项目可参考 assets/minimal-web/（pom.xml + App + HelloController + app.yml）。