用途:在编写或重构 Java 代码、组织模块与分层结构、定义接口与契约时使用,强调 SOLID 原则与模块化架构。
主要能力与强制流程:实现前需并行启动 3 个 agent,各一次 Agent 调用并带名称:fuse-ai-pilot:explore-codebase(分析现有架构)、fuse-ai-pilot:research-expert(通过 Context7 核对 Java 文档)、fuse-ai-pilot:sniper(实现后校验)。写任何新代码前须做 DRY 检查:在代码库中检索相似接口、服务或逻辑,检查共享位置 modules/core/services/ 与 modules/core/interfaces/;若已存在相似代码则扩展复用而非重复;若代码会被 2 个以上功能使用,则放到 modules/core/。
架构约定:Controllers 位于 modules/[feature]/controllers/,Services 位于 modules/[feature]/services/,Repositories 位于 modules/[feature]/repositories/,Interfaces 位于 modules/[feature]/interfaces/,Models/DTOs 位于 modules/[feature]/models/,共享代码位于 modules/core/{services,interfaces,models}/。禁止使用扁平 src/ 结构,始终采用 modules/[feature]/。
关键规则:文件行数上限为 FUSE_SOLID_MAX_LINES;控制器保持精简并委托给服务;接口只放在 modules/[feature]/interfaces/;每个 public 方法都要有 Javadoc;DTO 使用 record(Java 16+);受限层级使用 sealed(Java 17+)。
参考文档:solid-principles.md 为总览;single-responsibility.md、open-closed.md、liskov-substitution.md、interface-segregation.md、dependency-inversion.md 分别对应 SRP/OCP/LSP/ISP/DIP;architecture-patterns.md 讲模块化模式。模板包括 module.md、service.md、interface.md、repository.md、error.md、test.md。
禁止的反模式及修正:文件超过 FUSE_SOLID_MAX_LINES 需按职责拆分;接口写在实现文件中需移到 interfaces/ 目录;服务中 new ConcreteClass() 需改用依赖注入;扁平 src/ 结构需改为 modules/[feature]/;上帝类需按职责拆分。
限制:资料未提供具体安装命令、收费方式、支持平台或实际效果说明。